Payments

Settle a payment to fiat terms

You think in fiat; buyers pay in crypto. Because the invoice fixes amount_usd, the settled webhook confirms the fiat figure you priced, and you decide when to move funds out with a payout.

はじめる前に
  • An invoice created with a fixed amount_usd
  • A destination address for your payout

1Lock the price in USD at invoice time

Set amount_usd when you create the invoice. The integrated price layer quotes the crypto equivalent, so checkout and your books both speak fiat without a separate market-data vendor.

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

2Confirm settlement in fiat terms

The settled webhook echoes amount_usd, so you record the exact fiat figure you priced regardless of which chain the buyer used.

> { "invoice": "in_8fK2", "status": "settled", "amount_usd": 49 }

3Move funds out with a payout

Settlement leaves value in your balance. Trigger a payout to your treasury address on your own schedule — batch daily or sweep per order.

curl https://api.1st-node.com/v1/payouts \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"chain":"tron","to":"T...","amount_usd":49}'

よくある質問

Do I need a separate market-data feed to price checkout?

No. The invoice values the USD amount through the integrated price layer, so pricing and settlement use built-in prices with no external vendor.

When does value leave my balance?

Only when you trigger a payout. Settlement credits your balance; a payout moves it on chain on your schedule, so you control treasury timing.

続けて読む

チャージして、キーを取得し、リリース。

セルフサーブ。暗号資産またはカードで支払い。クレジットで従量課金——重いプリミティブは高く、単純なものは安価。

APIキーを取得