追加
- 受取人の送金先で、ブラジルでの BRL 支払い向けに
pixタイプとpix_safeタイプを使用できるようになりました。Pix 送金先は Pix キーに支払います。Pix Safe 送金先は、名義人の CPF または CNPJ、銀行の ISPB コード、支店、口座番号で特定される銀行口座に支払います。どちらも顧客の ready 状態の Pix ケイパビリティ（pix_pooled）が必要で、その支払いは USDC で資金拠出され、開発者手数料はかかりません。受取人と資金を送るを参照してください。 GET /v3/customers/{customerId}/tasks/{taskId}は、書類要件 ID を指定するdocumentCandidatesForと、代替を持つ要件向けのdocumentAlternativeKeyを受け付けるようになりました。指定すると、レスポンスのdata.documentCandidatesに、顧客がすでにアップロードした書類のうちその要件に回答できるものが、missingMetadataやconflictingMetadataとともに一覧表示されます。ファイルを再度アップロードする代わりに、候補のdocumentIdを不足しているdocumentMetadataとともに送信してください。このクエリにはaccounts:readとcustomers:readが必要で、無効な選択では400 validation_errorが返されます。
変更
GET /v3/webhooks/portalは、1 時間で有効期限が切れるポータル URL をCache-Control: no-storeとともに返します。webhooks:writeを持つ API キーを使用すると、ポータルにはエンドポイントの署名シークレットが表示され、エンドポイントの管理、配信の再試行、リプレイが可能です。webhooks:readのみの場合、ポータルには配信のみが表示されます。Webhookを参照してください。- Citi（
citibank）は法人顧客にのみ提供されます。すべての法人はプール型 Citi を引き続き利用でき、名義型 Citi は米国外で登録された法人にのみ提供されます。顧客に Citi が提供されない場合、サポート対象リストから Citi が除外され、Citi を指定すると422 capability_institutions_unsupportedが返され、Citi のみが提供する方法はdisabledとして表示されます。institutionsを指定しないリクエストでは、残りの銀行から選択されます。既存の申請と口座は変更されません。 - 名義型 CFSB（
cfsb）のケイパビリティは、米国の顧客、つまり米国で登録された法人と米国に居住する個人にのみ提供されます。その他の顧客の場合、サポート対象リストから名義型 CFSB が除外され、指定すると422 capability_institutions_unsupportedが返されます。institutionsを指定しないリクエストでは、残りの銀行から選択されます。プール型 CFSB、国が不明な顧客、既存の申請は変更されません。 - Lead Bank（
lead_bank）の名義型 ACH、Wire、SWIFT ケイパビリティは、法的形態と国に基づいて Lead Bank がオンボーディングできる顧客にのみ提供されます。その他の顧客の場合、サポート対象リストからlead_bankが除外され、指定すると422 capability_institutions_unsupportedが返されます。Lead Bank がすでにオンボーディングした顧客と、未完了のリクエストですでにlead_bankを指定しているケイパビリティは、引き続き利用できます。既存の申請と口座は変更されません。 - RTP はプール型のみになりました。新しいリクエストに
rtp_namedを提供する銀行はないため、サポート対象リストではdisabledとして表示されます。rtp_namedを保有していない顧客の場合、銀行を指定したケイパビリティリクエストまたはタスクのプレビューでは422 capability_institutions_unsupportedが返され、institutionsを指定しないものでは422 capability_variant_unavailableが返されます。プール型 RTP（rtp_pooled）は Citi で提供されるため、リクエストできるのは法人顧客のみです。 - 個人および実質的支配者に対する新しい本人確認書類のリクエストでは
constraints.identityMetadataRequired: trueを設定できるようになり、各ファイルのdocumentMetadataに ID 番号と発行国が必要になります。法人の住所証明書類と所有者の居住証明書類に対する新しいリクエストではconstraints.maxIssueAgeDays: 90を設定できるようになり、各ファイルに発行日が必要になります。既存のタスクは要件を維持するため、各タスクのリクエストで制約を確認してください。 profilePointerが/business/registrationである法人登記リクエストへのタスクの回答には、管轄国、登記番号、提出日より前の設立日をすべてそろえて含める必要があります。このルールはリクエストのvalueSchemaで公開されており、一部のみの回答では400 validation_errorが返されます。- ホスト型の確認の後、住所や納税者番号などの構造化された値を求めるプロファイル要件へのホスト型の回答は、直接の回答と同じスキーマおよび制約のチェックに合格した場合にのみ Swipelux に受け付けられます。合格しない場合、その要件は未完了のままとなるため、その値を
POST /v3/customers/{customerId}/tasks/{taskId}/submissionsで送信してください。この理由で Swipelux がaction_requiredに戻した要件には、reviewFeedback.code: hosted_profile_direct_submission_requiredが含まれます。すでにsatisfiedであるタスクは、そのステータスを維持します。ケイパビリティと要件を参照してください。 - ホスト型の確認によって却下されたタスクは、その確認の判定が後から覆された場合に
rejectedから移行することがあります。その場合、タスクはsatisfiedになるか、新しいrevisionでaction_requiredになり、新しい判定で回答されない要件が再び未完了になります。それらの要件に対する以前の送信はrejectedのままなので、それらの回答を再度送信してください。v3 への移行を参照してください。 - 受取人の送金先の
typeはオープンな列挙型になりました。このリファレンスの以前のバージョンではクローズドとして記載されていたため、未知のタイプを拒否または破棄するクライアントは更新してください。送金先のレスポンスとdestination.status_changedイベントにはpixとpix_safeが含まれる可能性があり、今後さらにタイプが追加されることがあります。 - 受取人の作成リクエストと更新リクエストは、ネストされた
addressを含め、定義されていないフィールドを400 validation_errorを返さずに無視するようになりました。作成リクエストで、もう一方の受取人タイプの名前フィールドまたは業種フィールドを指定した場合は引き続き400が返され、PATCH /v3/customers/{customerId}/recipients/{recipientId}でのtypeとexternalIdも同様です。認識できるフィールドを 1 つも含まないPATCHでは、200ではなく400 validation_errorが返されます。 - 書類のみを求める対象セッションの確認リンクは、Swipelux がホストする書類アップロードページを開くようになりました。リンク自体は変更されず、その他のセッションでは引き続きホスト型の確認フローが開きます。
- 個人顧客と関係者である個人の
employment.occupationは、最大 255 文字まで受け付けます。 - プロフィールの値またはタスクの回答に、RFI、顧客リクエスト、送金追跡リンクなどの Swipelux フォームリンクが含まれている場合、
POST /v3/customers,PATCH /v3/customers/{customerId},POST /v3/customers/{customerId}/related-parties,PATCH /v3/customers/{customerId}/related-parties/{relatedPartyId}、POST /v3/customers/{customerId}/tasks/{taskId}/submissionsは400 validation_errorを返します。これはexternalIdとmetadataには適用されません。拒否された各値はcode: public_form_linkとその JSON Pointer とともにerrors[]に表示され、レスポンスがリンクを繰り返すことはありません。代わりに情報そのものを送信してください。エラーと再試行を参照してください。
修正
- 支払いの見積もりと送金のレスポンスでは、USDC または USDT の送金元金額が小数点以下 6 桁で保持されます（例:
4009.71ではなく4009.711365）。フィアットの金額は小数点以下 2 桁のままです。ステーブルコインの送金元金額が小数点以下 2 桁を超える支払いを作成または読み取っても、500が返されなくなりました。 POST /v3/customers/{customerId}/capabilities/{capabilityId}/cancelのリファレンスが、実際の動作どおりにキャンセルを説明するようになりました。ready状態のケイパビリティはキャンセルでき、stablecoin_transfersケイパビリティはキャンセルできません。また、キャンセルで終了するのはそのケイパビリティのみで、その申請のステータス、タスク、承認は維持されます。institutionsに公開機関 ID ではなく銀行コード（citibankに対するcitiなど）を指定したケイパビリティリクエストまたはタスクのプレビューでは、503 kyc_configuration_unavailableではなく、利用可能な ID を示す422 capability_institutions_unsupportedが返されます。- 顧客に提供する銀行がない方法（サポート対象リストで
disabledとして表示されるもの）に対するケイパビリティリクエストまたはタスクのプレビューでは、顧客がそのケイパビリティをすでに保有している場合を除き、503 kyc_configuration_unavailableではなくretryable: falseを含む422 capability_variant_unavailableが返されます。 documentCandidatesには、完了したホスト型の確認から Swipelux が保持しているファイル（読み取りやダウンロードはできません）が表示されなくなりました。そのようなファイルを指定したタスクの回答では、未知の書類と同様に400 invalid_document_referenceが返されます。
追加
GET /v3/customersはinclude=documentRequirementsを受け付けるようになりました。指定すると、各顧客のサマリーに、ケイパビリティの準備状況とは関係なく、未提出の必須書類の件数が示されます。include=capabilities,documentRequirementsのように組み合わせて指定できます。顧客を参照してください。- マーチャントパネルの Webhooks ページで、エンドポイントのメニューに Replay missed events が追加されました。エンドポイントが受信しなかった過去 13 日間のイベントを再送信し、同じイベントを 2 回送信することはありません。Webhookを参照してください。
- マーチャントパネルの Settings ページに Compliance セクションが追加されました。オーナーと管理者は、コンプライアンス用のメールアドレスを設定し、Swipelux が顧客に関する追加情報を求めた際にメールを受け取るかどうかを選択できます。
- マーチャントは、マーチャントパネルの KYB ページで、自社の KYB コンプライアンス依頼にその場で回答できるようになりました。
変更
- 銀行の受付が完了した後も、顧客および関係者の更新は
409 field_conflicts_with_completed_intakeを返さなくなりました。更新は保存され、新しい銀行申請はそれぞれ独自の要件に照らして最新のプロファイルを確認します。 - ケイパビリティの既存の銀行ルーティングを安全に更新できない場合、ケイパビリティのリクエストは
409 capability_route_header_conflictを返します。再試行する前に Swipelux サポートにお問い合わせください。 institutionsにケイパビリティが提供していない銀行が指定された場合、GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-previewはケイパビリティのリクエストと同様に422 capability_institutions_unsupportedを返します。- サンドボックスでは、ACH、Wire、SWIFT のケイパビリティは JPMorgan Chase でのみ提供されます。
institutionsを省略したリクエストではjpmorganが選択され、他の銀行を指定すると422 capability_institutions_unsupportedが返されます。本番環境のルーティングは変更されません。サンドボックスでテストするを参照してください。 - サンドボックスのケイパビリティのステータスを強制変更する際、シミュレートされたケースが要求されたステータスに到達できない場合は、
statusReason付きで409 capability_status_blockedが返されます。すでに適用済みの強制変更を繰り返すと、変更なしで200が返されます。サンドボックスでテストするを参照してください。 POST /v3/sandbox/tasks/{taskId}/reviewは、Operations または別のワークフローが所有するタスクに対して409 task_not_sandbox_reviewableを返します。POST /v3/sandbox/tasksのタスクと、Swipelux が収集するケイパビリティの受付タスクは引き続きレビューできます。サンドボックスでテストするを参照してください。- 銀行で口座のプロビジョニングがまだ進行中の間に決済設定を変更すると、
PATCH /v3/customers/{customerId}/accounts/{accountId}は409 account_provisioning_unresolvedを返します。プロビジョニングが確定した後に再試行してください。エラーと再試行を参照してください。 POST /v3/transfersが409 quote_execution_evidence_conflictを返す場合があります。新しい見積もりを作成して実行してください。エラーと再試行を参照してください。- マーチャントパネルの Pay out ドロワーでは、送金先の詳細がすべて表示され、口座番号とウォレットアドレスはトグルでマスクされ、支払い方法ごとに到着予定時間が表示されます。
- マーチャントパネルでは、銀行口座が顧客の Payment access タブに統合され、各銀行名を示すタスクカードが表示されます。Documents タブは Profile に移動しました。
- マーチャントパネルでの名前付き銀行口座の開設は 1 ステップになり、各銀行の通貨、方法、オンボーディング期間が一覧表示されます。口座を参照してください。
- 審査のために保留されている銀行口座は、マーチャントパネルで On hold と表示され、口座 ID と Contact support アクションが表示されます。
- Swipelux が申請の提出を準備中で審査が行われていない間、
pendingのケイパビリティはreview_in_progressではなくstatusReason.code: preparing_submissionを報告するようになりました。どちらのコードもresolution: waitを使用します。両者の間で切り替わってもステータスはpendingのままなので、capability.status_changedイベントは送信されません。既存のケイパビリティは、次回の再評価時に新しいコードを取得します。ケイパビリティと要件を参照してください。 - マーチャントパネルの顧客の Payment access タブにある Shared methods テーブルは、ケイパビリティが
preparing_submissionを報告する共有メソッドについて、In review ではなく In preparation と表示します。 - ケイパビリティの
applicationsリストには、ケイパビリティの読み取り（GET /v3/customers/{customerId}/capabilities/{capabilityId}/applicationsを含む）、ケイパビリティリクエストのレスポンス、capability.status_changedイベントで、現在の申請のみが表示されるようになりました。新しい申請に置き換えられた申請は引き続きGET /v3/customers/{customerId}/applicationsに表示され、supersededByApplicationIdが後継の申請を示します。置き換えられた申請の未完了タスクは、引き続きケイパビリティのopenTaskIdsに含まれます。ケイパビリティのステータスとopenTaskIdsは変わらないため、この変更自体では webhook イベントは送信されません。ケイパビリティと要件を参照してください。
修正
- 銀行の承認前に同じ発行済み口座に対して送信された 2 回目の
allowPendingリクエストは、500ではなく、holder.accountIdで待機中の口座を示す409を返すようになりました。銀行口座を発行するを参照してください。 - ケイパビリティをキャンセルすると、まだ銀行の承認待ちだった発行済み口座のリクエストが閉じられるようになったため、同じ銀行での後続のリクエストは新規に開始されます。
- 銀行ケースがすべて却下されたキャンセル済みケイパビリティを再リクエストすると、
canceledからのcapability.status_changedイベントが 1 件だけ発行されます。 - 以前の申請がアーカイブされた後に銀行を再リクエストすると、新しい申請が送信されるようになりました。
- 受取人の送金先は、対応するケイパビリティが
readyになった時点で、409 rail_not_readyを返さずに追加できるようになりました。受取人を参照してください。 - マーチャントパネルの Webhooks ページを初めて開く前に送信された Webhook イベントが保持されるようになったため、それらを新しいエンドポイントにリプレイできます。
- マーチャントパネルのタスクの期日はご自身のタイムゾーンで表示され、銀行の審査ドロワーでは未対応の項目がなくなると All requirements submitted が表示されます。
追加
POST /v3/quotesは、暗号資産から法定通貨への支払い見積もりで承認済みの銀行ルートを選択するための任意のinstitutionIdを受け付けるようになりました。自動ルーティングを維持する場合は省略してください。支払いに利用できない銀行を指定すると422 bank_not_supported_for_customerが返され、他の種類の見積もりでinstitutionIdを送信すると400 validation_errorが返されます。資金を送るを参照してください。POST /v3/customers/{customerId}/accountsでの発行済み銀行口座のリクエストは、フォールバックなしで口座を 1 つの銀行に固定するinstitutionと、その銀行での申請がまだ承認待ちの間もリクエストを保存するallowPending: trueを受け付けます。allowPendingにはinstitutionが必要です。保存されたリクエストは、対応するapplicationIdを返します。銀行口座を発行するを参照してください。- マーチャントパネルに、エンドポイントを管理するためのネイティブな Webhooks ページが追加されました。Webhookを参照してください。
- マーチャントパネルに、名前付き銀行口座、暗号資産入金、確認ステップを備えた Pay in ドロワーが追加されました。
- マーチャントパネルの Pay out フローでは、送金元の選択時にウォレット残高が表示され、Max 金額オプションが追加され、確認ステップが含まれるようになりました。
- マーチャントパネルの顧客プロファイルに Recipients & destinations タブが追加されました。
- タスク要件に短い
title見出しを含められるようになりました。ガイダンスは引き続きリクエストのpromptに含まれます。ケイパビリティと要件を参照してください。
変更
- 共有（プール型）の Wire ルートでの Wire による pay-in の見積もりには、$20 以上が必要になりました。ルートの最小額を下回る見積もり、または送金手数料を賄えないほど少額の見積もりは、汎用的な見積もりエラーではなく
422 amount_not_deliverableを返すようになりました。資金を受け取るを参照してください。 - Webhook ポータルで、v3 のイベントタイプがリソースごとにグループ化され、各イベントのペイロードスキーマと例が表示されるようになりました。レガシーのイベントタイプは別の Legacy グループに表示され、非推奨としてマークされます。すでにそれらをサブスクライブしているエンドポイントは引き続き受信します。新しいサブスクリプションには v3 のイベントタイプを使用してください。Webhookを参照してください。
- サンドボックスでのトップアップで、
transfer.createdおよびtransfer.state_changedの Webhook イベントが発行されるようになりました。サンドボックスでテストするを参照してください。 - 顧客がすでにアクティブな発行済み口座を持っている場合、
accountProvisioningはissuedを返すようになりました。ケイパビリティと要件を参照してください。 - マーチャントパネルの銀行口座の詳細は、銀行ロゴ付きのドロワーで開きます。口座を参照してください。
- マーチャントパネルでは、資金移動のラベルが Pay in と Pay out になり、ログイン状態が 6 時間維持され、ヘルプリクエストはメールで Swipelux サポートに送信されるようになりました。
- 直接送信を受け付ける受付タスクでは、顧客プロファイルまたはアップロード済みの書類によってすでに裏付けられている対象要件が、自動的に
in_reviewに移行するようになりました。ケイパビリティと要件を参照してください。
修正
- キャンセルされたケイパビリティの再リクエストが、置き換えられた申請レコードや古くなった要件が原因で失敗しなくなりました。
- 廃止された Fedwire ID で保存されたケイパビリティが、
500を返さずにwireとして読み取られるようになりました。
追加
GET /v3/customers/{customerId}/applicationsは、顧客の申請ケースを一覧表示し、各ケースに対してリクエストされたケイパビリティと、その承認が対象とするケイパビリティを示します。1 つの銀行での 1 件の承認で複数のケイパビリティを対象にできます。保持されている過去のケースは、supersededByApplicationIdによって後続のケースを指します。この一覧はカーソルページネーションとupdatedAfterをサポートします。ケイパビリティと要件を参照してください。POST /v3/customers/{customerId}/capabilities/{capabilityId}のレスポンスには、ケースに基づくケイパビリティの場合にselectedApplicationIdが含まれます。これは、リクエストが再利用した既存の申請ケース、またはリクエストによって開かれたケースを識別します。ケイパビリティと要件を参照してください。GET /v3/institutionsおよびサポートされるケイパビリティの一覧で返される金融機関には、null 許容のlogoUrlが含まれます。利用可能な場合は銀行のブランディングの表示に使用し、nullの場合は金融機関名を代わりに表示してください。ケイパビリティと要件を参照してください。- USD の SWIFT 支払いが利用可能になりました。SWIFT 支払いには 100 USD 以上が必要です。マーチャントパネルで受取人の SWIFT 銀行指示を収集します。資金を送るを参照してください。
- 発行済み銀行口座は、名義付きの受取情報を使用して SWIFT で受け取れるようになりました。銀行口座を発行するを参照してください。
- USDT が ACH および Wire の支払いの送金元としてサポートされるようになりました。資金を送るを参照してください。
- 発行済み銀行口座は、
USDCまたはUSDTのsettlement.currencyを受け付け、ウォレット口座の通貨とは関係なく、決済ウォレットに届けるステーブルコインを選択できます。ウォレットの通貨で引き続き決済する場合は省略してください。銀行口座を発行するを参照してください。 - SWIFT の銀行口座と受取人の送金先は、
bankCity、bankState、bankPostalCode、bankAddressLine2に加えて、任意のbeneficiaryTaxId、beneficiaryPhoneNumber、ifscBranchCode、paymentCode、および中継銀行の詳細を受け付けます。資金を送るを参照してください。 - 発行済み銀行口座の詳細には、銀行が ACH と Wire で別々のルーティング番号を提供する場合は
achRoutingNumberとwireRoutingNumberが含まれ、受取銀行のbankLogoUrlも含まれます。銀行口座を発行するを参照してください。 capability.createdの Webhook イベントには、applicationIdと、requestedまたはapprovalのoriginが含まれるため、リクエストしたケイパビリティと承認によって対象となったケイパビリティを区別できます。Webhookを参照してください。- 要件のリクエストで、
http_url、us_ssn、us_ein、bank_industry_classificationなどの検証用のconstraints.formatを宣言できるようになりました。ケイパビリティと要件を参照してください。
変更
- マーチャントパネルでの銀行口座の作成は銀行の選択から始まるようになり、銀行口座には ACH と Wire のルーティング番号が別々に表示されます。口座を参照してください。
networkの enum にsolanaが追加されました。これはオープンな enum のため、認識できないネットワーク値も許容してください。口座を参照してください。- 残りの要件に直接送信が必要なタスクでホスト型の本人確認リンクを開くと、
409 verification_session_not_allowedが返されます。代わりに、それらの要件をタスクの送信として提出してください。エラーと再試行を参照してください。 - プロビジョニングが確定していない発行済み口座をアーカイブすると、
409 account_provisioning_unresolvedが返されます。プロビジョニングが確定した後に再試行してください。エラーと再試行を参照してください。 - 新しい名義付き銀行口座のリクエストは、次回の顧客の更新を待たずに、口座の作成と同時にプロビジョニングのキューに追加されるようになりました。銀行口座を発行するを参照してください。
削除
- 共有（プール型）の SWIFT 受取情報は、新しい口座には提供されなくなりました。代わりに名義付きの SWIFT 受取情報を使用してください。銀行口座を発行するを参照してください。
修正
- 支払い送金の取得で、見積もり時の受取人が返されるようになりました。
- 既存の ACH 口座をアーカイブした後に ACH 口座を作成しても
409が返されなくなり、アーカイブされた保留中の口座リクエストが口座枠を占有しなくなりました。 - 現地通貨の pay-in 見積もりの銀行手数料が、正しい法定通貨で報告されるようになりました。
追加
GET /v3/webhooks/{webhookId}で、単一の Webhook エンドポイントとそのeventsの選択を取得できるようになりました。Webhookを参照してください。- タスク要件で、必須の住所フィールドを含むプロファイルフィールドの
allowedValuesと JSON Schema のvalueSchemaが公開されるようになりました。国のフィールドは、valueTypeまたはitemValueTypeとしてcountry（ISO 3166-1 alpha-2 コード）を返します。入力欄や選択肢をハードコードせずにレンダリングできます。ケイパビリティと要件を参照してください。 - 既存の Tron ウォレットから顧客の外部ウォレット口座に USDT を送金できるようになり、送金の取得には Tron トランザクションのブロックエクスプローラーへのリンクが含まれるようになりました。Tron では新しいウォレットを発行できません。資金を送るを参照してください。
- タスク要件で
requiredWhen（指定された「はい/いいえ」の回答が一致する場合にのみ回答）、profileAssertion（us_person）、ownershipPolicyを宣言できるようになり、書類のリクエストではidentityMetadataRequiredとmaxIssueAgeDaysを設定できるようになりました。タスクの回答は、参照される書類についてdocumentMetadata（idNumber、issuingCountry、issuedOn）を受け付け、タスクの取得では、レビュー済みの制御回答がconditionValuesで返されます。ケイパビリティと要件を参照してください。 - 書類要件で
acceptedDocumentSetsを列挙できるようになり、関係者要件ではbeneficial_ownerに加えてassociated_personまたはcontrol_personの資格を求められるようになりました。ケイパビリティと要件を参照してください。 - 送金の
correctionオブジェクトは、資金提供済みの支払いの失敗も対象とするようになりました。recover_source_fundingの補償アクションを伴うkind: funding_failure、unknownまたはreportedのrecoveryStatus、およびUSDTで入金された出力が含まれます。見積もりと送金を参照してください。
変更
PATCH /v3/webhooks/{webhookId}は、エンドポイントがすでにサブスクライブしているレガシーのイベントタイプを受け付けるようになったため、v3 のイベントタイプを追加しながらそれらを維持できます。eventsは選択全体を置き換えるため、保持したいすべてのイベントタイプを含めてください。エンドポイントがまだ持っていないレガシーのイベントタイプを追加すると、400 validation_errorが返されます。Webhookを参照してください。- 受取人と口座の銀行識別子は、保存前に検証されるようになりました。受取人を参照してください。
- ケイパビリティのリクエスト、タスクの送信、サンドボックスでのステータス変更は、ケイパビリティが以前のオンボーディングモデルで作成されていた場合、
500ではなく409 capability_application_staleを返すようになりました。エラーと再試行を参照してください。 - 公開 RFI ページが 1 つの連続したフォームになりました。関係者に対応し、1 人につき 1 つの納税者番号を収集します。書類要件を参照してください。
- 支払いが銀行での顧客の 1 日または 1 か月の残りの利用可能額を超える場合、見積もりと送金は
409 customer_bank_limit_exceededを返し、その利用可能額を確認できない場合は503 customer_bank_limits_unavailableを返します。支払いを見積もりから開始できない場合、送金は409 payout_execution_unavailableを返します。エラーと再試行を参照してください。 - 完了した銀行の受付と競合する顧客および関係者の更新は、
taskIdとfieldsを含む409 field_conflicts_with_completed_intakeを返します。
修正
- キャンセルされたケイパビリティの履歴は引き続き参照できます。
- マーチャントパネルの取引一覧で、wire による支払いが正しく表示・フィルタリングされるようになりました。
変更
POST /v3/transfersと送金の読み取りは、カードチェックアウトの事前選択にpaymentMethodではなくcheckoutMethodを使用し、card、apple_pay、google_pay、cash_app、sepa、blikを受け付けます。このリストはオープンで今後増える可能性があります。paymentMethodは認識されなくなりました。引き続き送信するリクエストは、省略された場合と同様に扱われます。sepaとblikはカードチェックアウト内の支払いオプションであり、Swipelux のケイパビリティではありません。資金を受け取るを参照してください。
追加
POST /v3/transfersは、カードの見積もりに対してオプションのpaymentMethod（card、apple_pay、またはgoogle_pay）を受け付けるようになりました。リクエストした方法が顧客とそのデバイスで利用可能な場合、ホスト型チェックアウトはその方法で開き、送金の読み取りはリクエストを返し、見積もりの金額と手数料は変わりません。資金を受け取るを参照してください。GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-previewはinstitutionsを受け付け、サポートされるケイパビリティの一覧で返される特定の銀行のタスクをプレビューできます。ケイパビリティと要件を参照してください。
変更
- カードの見積もりに、チェックアウト手数料と実際に届く USDC の純額が反映されるようになりました。資金を受け取るを参照してください。
- 拒否された支払い見積もりは、汎用的なエラーではなく特定の問題コード（
quote_amount_out_of_range、quote_volume_limit_exceeded、quote_source_network_unsupported、またはquote_failed）を返し、後で見積もりを再試行できる場合は503 quote_temporarily_unavailableを返します。エラーと再試行を参照してください。
修正
- 手数料の丸めが原因でカードの見積もりが失敗しなくなりました。
- アンケートの回答に余分な空白が含まれている場合でも、ホスト型 KYC リンクを再度開いた際に
409 kyc_process_conflictが返されなくなりました。 - マーチャントパネルで停止していたパスキーによる出金確認が回復するようになりました。
追加
POST /v3/customers/{customerId}/documentsは、storageKey、fileName、typeを含むapplication/jsonボディも受け付けるようになりました。storageKeyは、以前の direct-upload フローで一時保管された、有効期限内の顧客スコープの参照でなければならず、アップロードは multipart アップロードと同じサイズおよびファイル署名の検証を受けます。v3 への移行を参照してください。GET /v3/customers/{customerId}/documents/{documentId}/downloadは、アクティブな顧客ドキュメントのダウンロードurlを返します。URL は 1 時間後に期限切れになり、ファイルを添付ファイルとして提供します。アーカイブ済み、不明、または他の顧客のドキュメントは404を返します。ケイパビリティと要件を参照してください。- 実質的支配者のいないビジネスに対してケイパビリティをリクエストすると、
503で失敗する代わりに、実質的支配者を追加するための受付タスクが作成されるようになりました。続行できないリクエストは、申告済みまたは 25% 以上の所有権を持つ個人の関係者を追加するよう案内する422 beneficial_owner_requiredを返します。株主、UBO、および管理者を参照してください。 - マーチャントパネルのタスクテーブルに、各リクエストの対象者とケイパビリティのスコープが表示されるようになり、コンプライアンスリクエストが誰と何を対象としているかを確認できます。ケイパビリティと要件を参照してください。
- マーチャントパネルの業種分類フィールドで、顧客プロファイルと要件タスクにおいて検索可能な NAICS コードを利用できるようになりました。KYB ワークフローを参照してください。
- 銀行 pay-in の指示に
bankName、bankAddress、accountHolderName、accountHolderAddressを含められるようになりました。他の銀行情報と一緒に表示してください。資金を受け取るを参照してください。 POST /v3/transfersは、カードまたは Apple Pay のホスト型チェックアウト後に顧客をアプリに戻す任意のredirectUrlを受け付けます。この URL に到達しても完了が確認されたことにはならないため、送金の取得または Webhook を使用してください。資金を受け取るを参照してください。- v3 Rule によって作成された送金は、
origin: rule付きで送金の取得と一覧に表示され、他の送金と同様にtransfer.state_changedイベントを発行します。GET /v3/transfers?origin=ruleで絞り込めます。見積もりと送金を参照してください。 - 顧客および関係者の本人確認書類は
sideApplicability（front_only、front_and_back、またはunknown）を受け付け、タスクではtype、number、issuingCountry、issuingRegion、issuedOn、expiresOn、doesNotExpireなどの本人確認書類の詳細を回答として収集できます。ケイパビリティと要件を参照してください。
変更
- 進行中の銀行設定と競合する銀行詳細の送信は、
409 ops_rail_handoff_conflictを返すようになりました。書類を再アップロードするのではなく、アップロード済みの書類 ID を保持し、競合が解消された後に同じ送信を再試行してください。エラーと再試行を参照してください。 - 顧客ウォレットへの事前通知のないステーブルコイン入金の最小額が 10 単位から 1 単位になりました。それより小さい入金は引き続きダストとして扱われます。資金を受け取るを参照してください。
- Webhook の設定が環境ごとに分離されるようになりました。Webhook ポータルはリクエスト元の環境にスコープされた状態で開くため、サンドボックスと本番のエンドポイントが設定を共有しなくなりました。Webhookを参照してください。
- マーチャントパネルは、顧客の v3 ケイパビリティから利用可能な pay-in メソッドを導出するようになり、口座設定では顧客に権限のあるメソッドのみが提供されます。口座を参照してください。
- RFI フォームは、より短く明確なプロンプトで該当する実質的支配者を収集するようになり、RFI 履歴はライフサイクルのマイルストーンとして表示されます。書類要件を参照してください。
- 明示的な期限のない未完了タスクでは、
dueAtのデフォルトが作成から 31 日後になりました。ケイパビリティと要件を参照してください。
削除
- マーチャントパネルでは、新しい pay-in メソッドの追加時に Fedwire を提供しなくなりました。既存の Fedwire 口座は引き続き取得できます。口座を参照してください。
修正
- 顧客ウォレットへの事前通知のない USDT 入金が、無視されずに認識・決済されるようになりました。
- すでに提出した証跡が、同じ項目を必要とする他のタスクに引き継がれるようになり、顧客が同じ書類を二度求められることがなくなりました。
- ケイパビリティを再リクエストしても、すでに準備完了の銀行ルートが破棄されなくなり、発行済みの口座詳細が安定して維持されます。
- マーチャントパネルの銀行指示ビューに、SWIFT アドレスや宛先ウォレットアドレスを含む完全な詳細が表示されるようになりました。
- RFI フォームは、送信時の検証エラーを表示し、送信前に法的形態の説明を検証し、複数のビジネスウェブサイトを受け付けるようになりました。
- RFI フォームで、送信前に関係者のドラフトを編集できるようになりました。
- キャンセルされたコンプライアンスリクエストが、マーチャントパネルのタスクリストに表示されなくなりました。
- マーチャントパネルで書類レビューのステータスが再び正しく表示されるようになりました。
追加
- 顧客スコープのホスト型本人確認および利用規約セッションに、信頼すべき
actionオブジェクトが追加されました。availableまたはunavailableの種類に従ってください。利用可能なアクションでは、トップレベルのurlとexpiresAtは互換性のためのミラーとして残ります。ケイパビリティと要件を参照してください。 - サンドボックスのウォレット入金で、
GET /v3/transfers/{transferId}から取得、またはGET /v3/transfersから一覧取得できる送金 ID が返されるようになりました。完了したステーブルコインの入金として表示されます。サンドボックスでテストするを参照してください。 - 完了後に送金の資金が返還または取り消された場合、送金の取得に
correctionオブジェクトが含まれます。修正のkind、正規化されたproviderStatus、該当する場合はproviderShortfall、および Swipelux が適用するcompensatingIntentが報告されます。見積もりと送金を参照してください。
変更
- カードおよび Apple Pay 向けのマーチャントパネルの First pay-in ガイドで、顧客に Polygon ウォレットが必要になりました。ガイドを開始する前にウォレットを作成してください。口座を参照してください。
- 新しいリクエストと公開レスポンスでは、メソッドおよびケイパビリティの正規名として
sepaを使用します。sepa_instant入力エイリアスと以前に保存されたリソースには互換性がありますが、公開レスポンスではsepaが返されます。口座を参照してください。 - Faster Payments の新しいケイパビリティ、発行口座、見積もりリクエストは利用できません。既存の口座、見積もり、送金は引き続き取得できます。口座を参照してください。
- KYB の最初のページでは代表者の生年月日を収集しなくなりました。株主の生年月日は引き続き別の要件です。KYB ワークフローを参照してください。
- RFI の書類参照で、
image/jpegに加えて MIME エイリアスimage/jpgを受け付けるようになりました。書類要件を参照してください。 - マーチャントパネルのタスク履歴に、リビジョンカウンターを含まない読みやすい監査証跡が表示されるようになりました。ケイパビリティと要件を参照してください。
- 見積もりと送金は、資金が移動する前にケイパビリティがサポートする方向を確認するようになりました。サポートされていない方向でケイパビリティを使用すると
422 capability_direction_unsupportedが返され、ウォレット間の移動にはstablecoin_transfersケイパビリティが必要です。エラーと再試行を参照してください。
削除
- マーチャントパネルでは新しい UAEFTS 口座の設定を提供しなくなりました。既存の UAEFTS 口座は引き続き取得できます。口座を参照してください。
修正
- レビュー担当者が新しい書類提出欄を追加しても、RFI フォームの既存入力が保持され、再送信時に以前の回答が失われなくなりました。
- マーチャントパネルは、有効なリンクを破棄せず、利用可能なアクションからホスト型コンプライアンスセッションを再開します。
- ホスト型の利用規約リンクが、API から返されるすべてのタスクスコープで機能するようになりました。
- マーチャントパネルで Payment Access をリクエストすると、以前のリクエストのタスクではなく、そのリクエストから返された受付タスクが開くようになりました。
- マーチャントパネルの KYB デモで、現在必要なフィールドが求められるようになりました。
- ソースウォレットを
destinationIdとして再利用する見積もりは、プロバイダー処理を開始する前に、対処可能な422 quote_direction_invalidの詳細を返すようになりました。見積もりと送金を参照してください。 - API は不正なクエリ文字列エンコーディングを暗黙に正規化せず、
400エラーで拒否するようになりました。エラーと再試行を参照してください。 POST /v3/customers/{customerId}/documentsは、空、multipart 以外、または不正な形式のリクエストボディを400エラーで拒否するようになりました。
追加
- OpenAPI 仕様に v3 Problem Details カタログを公開しました。これにより、インテグレーターはスキーマから直接エラー応答をマッピングできます。エラーを参照してください。
- v3 の口座 webhook イベントに
customerIdを追加し、追加の読み取りなしに口座アクティビティを所有者の顧客に関連付けられるようにしました。Webhook を参照してください。 - マーチャントパネルで V3 個人プロファイルフィールドを全面的にカバーし、オンボーディング担当者が v3 API 経由で収集されたすべての KYC フィールドを確認・編集できるようになりました。顧客のオンボーディング を参照してください。
- v3 の開発者向け移行ガイドを公開しました。v3 への移行 を参照してください。
変更
- 顧客および口座の国コードは、書き込み時に割り当て済みの ISO 3166-1 alpha-2 値として検証されるようになりました。読み取りはレガシーの保存値を許容するため、既存のレコードは引き続き解決されます。口座とウォレット を参照してください。
- USDC の提供は宛先ネットワークによってスコープが限定されるようになりました。これにより、見積もりと送金は宛先が実際にサポートするネットワーク上でのみ USDC を提供します。
- すべてのオンボーディングフローで Swipelux の利用規約が必須になりました。既存のセッションは引き続き再開できます。顧客のオンボーディングを参照してください。
Capability.readyは引き続き利用権限の承認を示します。口座発行の追跡にはaccountProvisioningを使用し、not_applicable、not_started、in_progress、issued、failedとして追跡してください。ケイパビリティと要件を参照してください。- iPhone からの HEIC アップロードが本人確認および住所確認書類として受け入れられるようになりました。
- 未完了のタスクがまだ必要としている顧客または関係者のフィールドをクリアすると、再試行可能な競合ではなく、ブロックしている
taskIdとfieldsを含む409 field_required_by_open_taskが返されるようになりました。これらのフィールドを変更する前に、タスクを完了またはキャンセルしてください。エラーと再試行を参照してください。
修正
- 使用済みの見積もりを再実行すると、汎用エラーではなく
409 quote_execution_consumedを返すようになりました。見積もりと送金 を参照してください。 - 大量の履歴結果に対する送金一覧の読み取りおよび見積もり金額の読み取りが
500を返さなくなりました。 - 同時実行された KYC リダイレクトは
404ではなくコンフリクトを返すようになり、再試行が正常に解決されるようになりました。ホスト型リダイレクトが途中でロールバックすることはなくなり、KYC リンクは引き続き再開できます。 - 個人顧客の関係者読み取りが
404を返さなくなりました。 - 無効なウォレットフィールドを含む KYB 送信は提出前に拒否されるようになり、同期の失敗がマーチャントパネルで成功として報告されなくなりました。
- マーチャントパネルの要件タスクは、送信済みの回答を完了として表示し、利用規約アクションを個別に追跡し、重複するドキュメントテキストを削除し、開始済みの KYC セッションを完了まで保留状態に保ち、要件ビューを壊すことなく古いタスクを処理するようになりました。
- マーチャントパネルの検証リンク行に、すべての行で Open アクションが表示されるようになり、すべてのタスクリンクが要件ビューにレンダリングされるようになりました。