開始前に必要なもの
同じ顧客に対する ready 状態の入金ケイパビリティと ready 状態の発行済み入金先ウォレットが必要です。オープン中の作業は ケイパビリティとタスク を通じて完了し、両方のリソースを再取得してください。1. 見積もりを作成する
POST /v3/quotes で価格を作成します。次のヘッダーを送信します。
data.id を QUOTE_ID として保存します。レートから再計算するのではなく、返された金額と手数料を提示してください。
2. 見積もりを実行する
有効期限前にPOST /v3/transfers で現在の見積もりを実行します。この意図した送金には新しいキーを使用してください。
data.id を TRANSFER_ID として保存し、その現在の状態を保持してください。
3. 資金移動指示を取得する
GET /v3/transfers/{transferId}/instructions を読み取ります。返された data.instructions のバリアントを、そのタイプを推測せずにレンダリングしてください。
これらの詳細情報は送金固有です。1 つの送金の銀行座標、コード、ホスト型 URL、金額、参照情報、有効期限を、別の入金に再利用しないでください。
銀行指示の場合、reference.required が true であれば、reference.value を銀行座標の隣に正確に表示し、コピー可能にしてください。同じ指示セットから返された金額と通貨を表示してください。
発行済み銀行口座はこれとは異なり、後の入金のための再利用可能な情報を提供します。その体験を意図している場合は、銀行口座を発行する をご覧ください。
4. 決済を追跡する
実行後および各イベントの後に、GET /v3/transfers/{transferId} を読み取ります。顧客向けのステータスは、最新の data.state から駆動してください。
送金に別のアクションが必要な場合は、data.stateDetail と data.openTaskIds を使用してください。予想されるスケジュールから完了とマークしないでください。
次に、Webhooks を追加し、送金ステータスが製品が処理する結果に達するまで同期を維持してください。