Refund a crypto payment
Refunds are issued against the original invoice, not a raw address, so the ledger stays consistent. One POST supports full or partial amounts and hands off to the payout rail for the actual on-chain transfer.
- A settled invoice id (in_..)
- A live API key with a positive credit balance
1Post the refund against the invoice
Reference the invoice id. Omit amount_usd for a full refund or set it for a partial. Refunds are a C2 write.
curl https://api.1st-node.com/v1/payments/invoices/in_8fK2/refund \
-H "Authorization: Bearer sk_live_..." \
-d '{"amount_usd":49}'2Read the payout reference
The response links the refund to a payout that carries the on-chain details. Persist it so you can reconcile the outbound transfer later.
> { "invoice": "in_8fK2", "status": "refunded",
> "payout": "po_2xB9", "amount_usd": 49 }3Confirm the on-chain transfer
The refund is complete only once the payout confirms on chain. Track the payout to a final state before you close the ticket, and store the transaction hash for your records.
よくある質問
Can I refund only part of an invoice?
Yes. Set amount_usd to the partial value; omit it to refund the full invoice. Multiple partial refunds are allowed up to the settled total.
Why refund against the invoice id instead of an address?
Refunding against the invoice keeps the credit and debit tied to the original order, so reconciliation and audit stay correct.
続けて読む
チャージして、キーを取得し、リリース。
セルフサーブ。暗号資産またはカードで支払い。クレジットで従量課金——重いプリミティブは高く、単純なものは安価。
APIキーを取得