Issue a crypto invoice
An invoice is the unit of checkout. One POST fixes a USD price, the chains you accept and returns a hosted checkout URL plus a pay-to address. Creating invoices is a C2 write, so a per-call credit cost applies.
- A live API key (Bearer token) with a positive credit balance
- The order amount in USD and the chains you want to accept
1Create the invoice
Post the USD amount and the chains you accept. The accept array uses chain slugs (eth, btc, tron). This is a C2 write.
curl https://api.1st-node.com/v1/payments/invoices \
-H "Authorization: Bearer sk_live_..." \
-d '{"amount_usd":49,"accept":["eth","tron"]}'2Read the pay-to address and checkout URL
The response carries the invoice id (in_..), a per-chain pay-to address and a hosted checkout URL. Persist the id — every later webhook and refund references it.
> { "invoice": "in_8fK2", "status": "pending",
> "amount_usd": 49,
> "pay_to": { "tron": "T...", "eth": "0x..." },
> "checkout_url": "https://pay.1st-node.com/in_8fK2" }3Redirect the buyer and wait for the webhook
Send the buyer to checkout_url or render your own page against the pay-to address. Do not mark the order paid on redirect — treat the invoice as pending until a settled webhook arrives and its signature verifies.
常见问题
How is the crypto amount computed from the USD price?
The invoice locks a USD amount and quotes the equivalent per chain from the integrated price layer, so you never call a separate market-data vendor to price checkout.
What credit tier does creating an invoice cost?
Invoices are a C2 write, heavier than a C1 spot read but billed per call with no per-seat license.
继续阅读
充值、拿密钥、上线。
自助开通。支持加密货币或银行卡。按额度计费——重型原语更贵，简单调用很便宜。
获取 API 密钥