TRONow加盟店コンソール →ウォレットと加盟店残高
サイトではウォレットから正確なTRX額を送金します。加盟店の購入は内部残高から支払います。加盟店には専用入金先があり、入金確認後に残高が増えますが、エネルギー注文は自動作成されません。コンソールとOpenAPIは同じ購入処理を使用します。
正確な数量を先に見積もる
資源、数量、期間を指定して見積もりを取得します。大量注文は単位価格の単純な倍数になるとは限りません。返された合計額とquote_idを使用します。加盟店の見積もりは1分間有効で、期限切れの場合は再取得が必要です。
1つの注文に1つのキー
商品情報、受取ウォレット、quote_id、client_order_idを送信します。同一の論理リクエストでは同じIdempotency-Keyを使用します。タイムアウト後は同じ内容とキーで再試行するか注文を照会し、応答がないだけで再購入しないでください。
受付と交付の違い
注文が受け付けられると処理が始まります。注文IDで照会するか署名付きWebhookで追跡します。最終状態とチェーン上の証拠を確認してからエネルギーを利用してください。不確定な結果には照合が必要で、重複購入で解決しません。
連携を保護する
API Secretはサーバー側で保管し、許可するIPを設定してWebhook署名を検証します。完全な資格情報をログに残さないでください。通知は重複することがあるため、受信処理を冪等に実装します。
アカウントの価格を確認する
公開API価格は標準的な参考値であり、各アカウントの商品と価格が同じとは限りません。対応数量で注文の全工程を確認した後、残高、失敗、通知処理を監視しながら利用を拡大してください。