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}'Preguntas frecuentes
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.
Sigue leyendo
Recarga, obtén tu clave y publica.
Autoservicio. Paga en cripto o con tarjeta. Medido por créditos: las primitivas pesadas cuestan más, las simples son baratas.
Obtener clave API