開始前に必要なもの
同じ顧客に対する ready 状態の入金ケイパビリティと ready 状態の発行済み入金先ウォレットが必要です。オープン中の作業は ケイパビリティとタスク を通じて完了し、両方のリソースを再取得してください。1. 見積もりを作成する
POST /v3/quotes で価格を作成します。次のヘッダーを送信します。
data.id を QUOTE_ID として保存します。レートから再計算するのではなく、返された金額と手数料を提示してください。
2. 見積もりを実行する
有効期限前にPOST /v3/transfers で現在の見積もりを実行します。この意図した送金には新しいキーを使用してください。
data.id を TRANSFER_ID として保存し、その現在の状態を保持してください。
カードおよび Apple Pay のリターン URL を追加する
カードまたは Apple Pay の見積もりの場合、同じリクエストにオプションのredirectUrl を含めることができます。顧客がホスト型チェックアウトを完了すると、チェックアウトページはこの URL を開き、顧客をアプリに戻します。
redirectUrl は最大 2048 文字の絶対 HTTPS URL であり、埋め込みの認証情報を含んではいけません。リターンナビゲーションをサポートしない見積もりに対して redirectUrl を送信すると、無視されるのではなくバリデーションが失敗します。
redirectUrl への到達は、ブラウザのナビゲーションにすぎません。支払いまたは送金が完了したことを確認するものではありません。完了はステップ 4 の送金状態と Webhook イベントから判断してください。
カードの見積もりでチェックアウト方法を事前選択する
カードの見積もりの場合、同じリクエストにオプションのcheckoutMethod を含めて、ホスト型チェックアウトがどの支払いオプションで開くかを選択できます。現在の値は card、apple_pay、google_pay、cash_app、sepa、blik です。このリストはオープンで今後増える可能性があるため、送金の読み取りでは認識できない値も許容してください。リクエストした方法が顧客とそのデバイスで利用可能な場合、チェックアウトはその方法で開き、顧客はチェックアウトが提供する他の方法を引き続き選択できます。省略すると、デフォルトの事前選択が維持されます。
checkoutMethod は優先設定であり、保証ではありません。利用可否は顧客、そのデバイス、およびチェックアウトによって決まるため、方法をリクエストしても利用可能になるわけではありません。ここでの sepa と blik はカードチェックアウト内の支払いオプションであり、Swipelux のケイパビリティ、レール、口座ではありません。事前選択は見積もりのケイパビリティ、金額、手数料を変更せず、最終的な手数料はチェックアウトで確認されます。送金の読み取りはリクエストした値を返しますが、顧客が実際に使用した方法を確認するものではありません。カードの見積もりではない見積もりに対して checkoutMethod を送信すると、無視されるのではなくバリデーションが失敗します。また、同じ冪等キーで再送する場合は、同じ checkoutMethod を送信する必要があります。
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 を追加し、送金ステータスが製品が処理する結果に達するまで同期を維持してください。