メインコンテンツへスキップ
すべての支払いは、ready 状態で入金済みの発行ウォレットから開始します。送金先モデルは、エンドポイントの所有者に応じて異なります。

​
開始前に必要なもの

送金元ウォレットを再取得します。現在のステータスが支払いを許可し、利用可能な残高が意図する送金元金額をカバーすることを確認してください。レスポンスから得られる ID を SOURCE_WALLET_ID として保存します。 現在の顧客と選択した送金先に対する ready 状態の支払いケイパビリティも必要です。 既存の Tron ウォレットは、stablecoin_transfers の見積もりを使用して、別の Tron ウォレットに USDT を送金できます。入力と出力には同じネットワークと同じステーブルコインを使用する必要があります。Tron では新しい発行ウォレットを作成できません。

​
1. 送金先を準備する

顧客がエンドポイントを所有する場合は、顧客所有の外部銀行口座を使用します。次のヘッダーとともに POST /v3/customers/{customerId}/accounts で作成します。
Request headers
Request body
GET /v3/customers/{customerId}/accounts/{accountId} で読み取ります。現在のステータスが支払いを許可する場合にのみ続行してください。その acc_ ID を PAYOUT_DESTINATION_ID として保存します。

​
2. 支払い見積もりを作成する

次のヘッダーとともに POST /v3/quotes を使用します。
Request headers
Request body
data.id を QUOTE_ID として保存し、返された価格と手数料を提示してください。

​
銀行ルートを選択する

暗号資産からフィアットへの支払いでは、オプションの institutionId を設定して、顧客に対して承認済みの銀行ルートを必須にできます。自動ルーティングを使用する場合は省略してください。
Request body with institutionId
  • 明示的に指定した institutionId が別の銀行にフォールバックすることはありません。選択した銀行に、この顧客、ケイパビリティ、送金先に対する ready 状態のルートがない場合、POST /v3/quotes はポインター /institutionId とともに 422 bank_not_supported_for_customer を返します。
  • institutionId は暗号資産からフィアットへの支払い見積もりでのみ有効です。入金、カード、またはステーブルコイン送金の見積もりで送信すると、400 validation_error が返されます。
  • 見積もりと送金の読み取りでは、銀行を特定できる場合、自動的に選択されたルートを含め、選択されたルートの institutionId が返されます。

​
SWIFT 支払い

本番環境では、USD の SWIFT 支払いには、支払いをサポートする ready 状態の SWIFT ケイパビリティ（swift_pooled または swift_named）が必要です。また、資金は Ethereum、Base、Polygon 上の USDC、または Ethereum、Polygon 上の USDT で拠出される必要があります。手数料差し引き後の受取金額は 100.00 USD 以上である必要があります。 SWIFT の送金先には、bankAddress、bankCity、bankState、bankPostalCode に銀行の所在地住所が必要です。BIC の国は銀行の国と一致している必要があります。Swipelux は受益者の住所を顧客または受取人のプロファイルから取得します。

​
Pix 支払い

Pix と Pix Safe の受取人の送金先は BRL を受け取ります。顧客の ready 状態の Pix ケイパビリティ（pix_pooled）で支払いの見積もりを作成し、USDC で資金を拠出して、out.currency を BRL に設定してください。USDT では BRL の支払いに資金を拠出できません。 Pix 支払いには開発者手数料を付けられません。送金元口座に開発者手数料が設定されている場合は、見積もりリクエストで fees.breakdown.developer を {"fixed": "0.00", "bips": 0} に設定してください。そうしないと、POST /v3/quotes は 400 validation_error を返します。 Swipelux は、送金先の銀行情報が承認された後にのみ見積もりの価格を算出します。確認中の間は、POST /v3/quotes は送金先がまだ確認中であることを示す detail とともに 400 validation_error を返すため、確認が完了したら新しい見積もりをリクエストしてください。銀行情報が却下された場合や送金先のセットアップが完了していない場合は、detail でサポートへの問い合わせが求められ、サポートがセットアップを完了するまで新しい見積もりは失敗し続けます。確認状況をチェックできない場合は 503 quote_temporarily_unavailable が返されるため、後で再試行してください。

​
3. 支払いを実行する

POST /v3/transfers で送金を作成します。この意図した実行には新しいキーを 1 つ使用してください。
Request headers
Request body
送金の data.id を TRANSFER_ID として保存します。作成成功は支払いを開始しますが、配信を証明するものではありません。

​
4. 配信を追跡する

作成後および各イベントの後に、GET /v3/transfers/{transferId} を読み取ります。最新の data.state、data.stateDetail、data.openTaskIds を使用して、待機するか、アクションを実行するか、終端の結果を表示するかを判断してください。 次に、正確な金額、安全な実行のリカバリー、送金タスクについて 見積もりと送金 を確認してください。