TRONowウォレットと加盟店残高
加盟店アカウントを登録し、コンソールの入金ページで専用のTRONメインネットアドレスを確認してください。ネイティブTRXのみ対応し、1回につき10 TRX以上が必要です。それ未満は残高に反映されません。累計入金が20 TRXに達すると、APIとコンソールでの購入が有効になります。入金だけでは注文は作成されません。注文ごとに十分な利用可能残高が必要です。
最低 65K：正確な数量で見積もる
最低注文数量は 65,000 Energy（65K）です。API の見積もり・注文ともに、カスタム数量を含め resource_amount は 65000 以上の整数を指定してください。最低数量未満の正の整数は 422 UNSUPPORTED_PRODUCT を返すため、数量を修正してから再送してください。正確なリソース種別、数量、期間で現在価格を取得します。応答には price_sun、currency、priced_at が含まれ、price_sun は現在の参考価格を表す整数 SUN 文字列です。価格を固定実装しないでください。POST /orders は受理時に再計算して注文価格を固定するため、見積もりIDは不要です。
1つの注文に1つのキー
リソース種別、数量、期間、受取ウォレット、client_order_id を送信します。同一の論理リクエストでは同じ Idempotency-Key を使用します。受理応答にはプラットフォーム注文番号と固定済み予約額が含まれます。タイムアウト後は同じ内容とキーで再試行するか注文を照会し、応答がないだけで再購入しないでください。
エネルギー注文の5つの状態
HTTPの成功応答は受理を意味し、エネルギーが利用可能になったことを保証しません。注文照会または署名検証済みWebhookで確認します。CONFIRMINGにはTRONSCANで確認できるハッシュがあります。より確実に送金するには、SUCCESSを待つかウォレットの利用可能エネルギーを確認してください。SUCCESSはハッシュがTRON上で見つかったことを示し、その後のUSDT送金の成功を意味しません。結果が不明な場合は重複注文しないでください。
| APIステータス | 意味 | 資金の扱い |
|---|---|---|
| PROCESSING | 処理中。取引ハッシュはまだありません。 | 確保中 |
| CONFIRMING | ハッシュを取得し、チェーンを非同期で照会中。 | 確保中 |
| SUCCESS | TRON上でハッシュを確認。 | 確定済みの注文金額を引き落とし |
| FAILED | 注文は失敗で終了。 | 確保を解除済み |
| REVIEWING | 結果が不明なため、運営による確認が必要。 | 解決まで確保を継続 |
連携を保護する
API Secretはサーバー側で保管し、許可するIPを設定してWebhook署名を検証します。完全な資格情報をログに残さないでください。通知は重複することがあるため、受信処理を冪等に実装します。
アカウントの価格を確認する
公開API価格は標準的な参考値であり、各アカウントの商品と価格が同じとは限りません。対応数量で注文の全工程を確認した後、残高、失敗、通知処理を監視しながら利用を拡大してください。