決済

インボイスで暗号資産の支払いを受け付ける

暗号資産での課金は3つの動作に集約されます:ある金額のインボイスを作成し、支払者をチェックアウトに誘導し、決済webhookに反応します。処理、アドレス管理、確認追跡はあなたのために行われます。

はじめる前に

1インボイスを作成する

法定通貨建ての金額と受け付けるチェーンに対してインボイスを要求します。支払先アドレスとチェックアウトURLが返ります。

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

支払者を返されたチェックアウトURLにリダイレクトするか、アドレスと金額を自分でレンダリングします。インボイスは過少支払い、過大支払い、確認を追跡します。

決済時、署名付きwebhook(HMAC-SHA256)がインボイスidとステータスとともに発火します。署名を検証してから注文を支払済みとマークします。webhook配信は冪等です——重複イベントは二重計上しません。

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

webhookをどう信頼する?

各イベントは生のボディに対してHMAC-SHA256で署名されます。シークレットで再計算し、不一致は拒否します。

回収だけでなく支払いもできますか?

はい——一括送金と決済は同じ残高上の同種の決済プリミティブです。

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