1. 受取人を作成する
POST /v3/customers/{customerId}/recipients で個人または事業者を作成します。次のヘッダーを送信します。
Request headers
Request body
relationship は受取人と顧客の関係を示します。POST /v3/customers/{customerId}/recipients のリクエストスキーマから値を選んでください。other を送る場合でも自由記述フィールドを追加しないでください。Swipelux はリクエストスキーマで定義されていないフィールドを無視するため、そのテキストは保存されません。
フィアット送金先を作成する前に住所を含めてください。返された受取人の data.id を RECIPIENT_ID として保存し、その現在のステータスを保持してください。
2. 送金先を追加する
POST /v3/customers/{customerId}/recipients/{recipientId}/destinations でエンドポイントを作成します。この意図された送金先には新しいキーを使用してください。
Request headers
- 銀行送金先
- Pix 送金先
- Pix Safe 送金先
- ウォレット送金先
pix_pooled）が必要です。Pix 送金先は Pix キーに支払います。Pix キーには、数字のみの CPF または CNPJ、+55 の後に 10 桁または 11 桁が続く電話番号、メールアドレス、ランダムキーを使用できます。Pix Safe 送金先は、taxId に指定した名義人の CPF または CNPJ、bankCode に指定した銀行の 8 桁の ISPB コード、支店、チェックディジット付きの口座番号で特定されるブラジルの銀行口座に支払います。レスポンスと Webhook では、taxId は下 4 桁を残してマスクされて返されます。
Swipelux は、銀行送金先の作成時に、IBAN、BIC、ABA ルーティング番号、CPF または CNPJ 番号などの銀行識別子をチェックサムも含めて検証します。不正な値は 400 validation_error を返します。これらのチェックで確認されるのは形式のみで、口座が実在するかどうかや、その所有者は確認されません。
self_custodied は、受取人がそのウォレットを管理している場合にのみ使用してください。別のカストディアンが保有するウォレットの場合は、現在の API リファレンスのバリエーションに従ってください。
返された送金先の data.id を DESTINATION_ID として保存し、その現在のステータスを保持してください。
3. 送金先が ready になるまで待つ
見積もりを作成する前に、GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId} を読み取ります。
現在の送金先ステータスが支払いを許可し、その通貨、方法、ネットワークが意図する資金移動と一致する場合にのみ続行してください。受取人と送金先のステータスは独立しています。
支払い見積もりでは dst_ の送金先 ID を使用してください。rcp_ の受取人 ID は所有者レコードを識別するもので、見積もりの送金先ではありません。
次に、ready 状態の送金先を持って 資金を送る に進んでください。