Payments

Accept a crypto payment with an invoice

Charging in crypto comes down to three moves: create an invoice for an amount, point the payer at a checkout, and react to a settlement webhook. The processing, address management and confirmation tracking are handled for you.

Перед началом
  • A live API key
  • A configured webhook endpoint and signing secret

1Create an invoice

Request an invoice for a fiat-denominated amount and the chains you accept. You get back a pay-to address and a checkout URL.

curl https://api.1st-node.com/v1/payments/invoices \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"amount_usd":49,"accept":["eth","tron"]}'

2Present the checkout

Redirect the payer to the returned checkout URL, or render the address and amount yourself. The invoice tracks underpayment, overpayment and confirmations.

3Confirm via webhook

On settlement, a signed webhook (HMAC-SHA256) fires with the invoice id and status. Verify the signature, then mark the order paid. Webhook delivery is idempotent — duplicate events won't double-credit.

> POST /your/webhook  X-Signature: <hmac>
> { "invoice":"in_..","status":"settled","amount_usd":49 }

Частые вопросы

How do I trust the webhook?

Each event is signed with HMAC-SHA256 over the raw body. Recompute it with your secret and reject mismatches.

Can I pay out as well as collect?

Yes — mass payout and settlement are sibling payment primitives on the same balance.

Читать дальше

Пополнили, получили ключ, запустили.

Полное самообслуживание. Оплата криптой или картой. Тарификация в кредитах — тяжёлые примитивы дороже, простые дёшевы.

Получить API-ключ