トランザクションと再試行
引き出しは非同期のビジネス操作です。 HTTP 応答が成功した場合は、リクエストが処理されたことを意味します。資金がオンチェーンで到着したことを証明するものではありません。
1 つのビジネス ID を保持する
出金を送信する前に client_request_id を生成して保存します。プロセスの再起動後など、同じ目的の操作を再試行する場合にこれを再利用します。トランザクションのフィールドの一貫性を保ちます。現在の実装では、ビジネス パラメータが競合する繰り返し識別子は拒否されます。
Idempotency-Key ヘッダーだけに依存しないでください。提供された SDK はそのヘッダーを追加できますが、現在の出金重複排除コントラクトは本文フィールド client_request_id に基づいています。
リクエストデータを理解する
この表は、完全なリクエスト スキーマではなく、コア フィールドを強調表示しています。統合バージョンに対してプレビュー、料金の確認、保管固有の要件を確認します。バイナリ浮動小数点数を避け、環境間でサンプル チェーンやアセット番号をコピーしないでください。
結果に従ってください
このリストは例示的なものであり、変更される可能性があります。未知の状態を成功または失敗にマッピングするのではなく、調査のために保存します。ラベルが失敗または拒否されただけでは、何も署名またはブロードキャストされなかったことを示す十分な証拠にはなりません。
タイムアウト後に回復する
元の client_request_id クエリ パラメーターを使用して GET /api/v1/withdrawals/by-request をクエリします。結果が不確かな間は、元の操作のポーリングまたはリコンシルを続けます。認可の更新が必要な場合は、同じ識別子と合意された更新手順を使用してください。
キャンセルは、実際の署名段階とサーバーのチェックによって異なります。元の事業が譲渡されておらず、譲渡できないことが確立された後にのみ、代替事業活動を開始してください。イベントを受信する webhooks、API クエリを調整パスとして保持します。