ナビゲーションにスキップ

トランザクションと再試行

Markdownとして表示

引き出しは非同期のビジネス操作です。 HTTP 応答が成功した場合は、リクエストが処理されたことを意味します。資金がオンチェーンで到着したことを証明するものではありません。

1 つのビジネス ID を保持する

出金を送信する前に client_request_id を生成して保存します。プロセスの再起動後など、同じ目的の操作を再試行する場合にこれを再利用します。トランザクションのフィールドの一貫性を保ちます。現在の実装では、ビジネス パラメータが競合する繰り返し識別子は拒否されます。

Idempotency-Key ヘッダーだけに依存しないでください。提供された SDK はそのヘッダーを追加できますが、現在の出金重複排除コントラクトは本文フィールド client_request_id に基づいています。

リクエストデータを理解する

分野意味
chain_id、asset_id合意された環境における識別子
to_address、amount宛先と文字列として表される正の 10 進数の金額
client_request_id安定したビジネスリクエスト識別子
dest_memo_type、dest_memoネットワークで必要な宛先メモの詳細
client_authorizationAPI キーで開始された引き出しに対する顧客のトランザクション承認
end_user_idエンタープライズ API フロー内のオプションのビジネス ユーザー ID

この表は、完全なリクエスト スキーマではなく、コア フィールドを強調表示しています。統合バージョンに対してプレビュー、料金の確認、保管固有の要件を確認します。バイナリ浮動小数点数を避け、環境間でサンプル チェーンやアセット番号をコピーしないでください。

結果に従ってください

状態の例解釈
pending_approval、pending_platform_reviewビジネスの承認またはレビューが未処理である
approved、pending_sign承認と署名は別の段階です
broadcasting、pending_chainブロードキャストまたはチェーン確認中です
broadcast_unverified、recovering結果はまだ不確実です。別の転送を作成しないでください
awaiting_reauthorization同じリクエストに対して新たな顧客の承認が必要になる場合があります
confirmedシステムはチェーン確認を記録しました

このリストは例示的なものであり、変更される可能性があります。未知の状態を成功または失敗にマッピングするのではなく、調査のために保存します。ラベルが失敗または拒否されただけでは、何も署名またはブロードキャストされなかったことを示す十分な証拠にはなりません。

タイムアウト後に回復する

元の client_request_id クエリ パラメーターを使用して GET /api/v1/withdrawals/by-request をクエリします。結果が不確かな間は、元の操作のポーリングまたはリコンシルを続けます。認可の更新が必要な場合は、同じ識別子と合意された更新手順を使用してください。

キャンセルは、実際の署名段階とサーバーのチェックによって異なります。元の事業が譲渡されておらず、譲渡できないことが確立された後にのみ、代替事業活動を開始してください。イベントを受信する webhooks、API クエリを調整パスとして保持します。