簡介
在創建或更新收款人之前，先驗證收款人的銀行賬戶詳細資料，以改善客戶體驗並減少錯誤發送的英國支付。
本指南旨在幫助您透過驗證收款人賬戶 API（即我們的受款人確認服務），驗證本地英鎊出賬支付的收款人銀行賬戶詳細資料。驗證收款人有助於避免支付發送至錯誤的賬戶，並為打擊欺詐和騙局增加了另一層保護。
對於與 The Currency Cloud Limited 訂立合約的「贊助」和「財務管理」服務模式下的客戶，如果您向最終客戶提供本地英鎊支付，則必須集成此 API。
測試版通知：
請注意，此 API 仍在測試階段。在此期間，某些回應代碼和原因可能會有所變更。在測試期間實施任何可能造成重大影響的變更之前，我們始終會至少提前 10 天發出通知。
定義是什麼？
驗證收款人賬戶 API 可用於驗證收款人的銀行賬戶號碼，在某些市場中，還可用於查看所提供的個人或公司名稱。
如何操作？
- 最終客戶輸入收款人的賬戶詳細資料。
- Currencycloud 將此請求轉發至收款人的銀行，或與資料集進行交叉比對。
- 對於英國市場，我們會傳回一個顯示驗證結果的回應，其中包含以下欄位：
answer、actual_name、reason_code、reason和reason_type。
誰是最終客戶？需要在哪裡進行驗證？
在大多數情況下，最終客戶是我們與之簽約並向其提供受規管支付服務的個人或企業。要求是最終客戶繼續在您的介面上創建收款人之前，必須能夠接收到驗證回應。例如，如果您是一個應付賬款平台，則使用該平台的最終客戶必須能夠在創建收款人並提交發票支付之前驗證收款人詳細資料。
然而，在某些用例中，最終客戶無法創建收款人，但從技術上講您仍然可提供此服務。舉例來說，財富管理科技可自動填入支付時使用的相同賬戶詳細資料。如果這適用於您的情況，請諮詢您的客戶成功經理和解決方案顧問，我們將與您一起了解您的用例。
可用性
我們目前在英國提供測試版驗證收款人賬戶 API。未來我們會支援更多國家/地區。請聯絡客戶支援或您的客戶成功經理，以獲取更多資訊。
第 1 步：登入
請參閱身份驗證指南，以獲取有關啟動新 API 會話的說明。確保您的聯絡人 ID 已啟用，以便在我們的演示環境中使用此產品。
第 2 步：驗證收款人
請求
若要在英國驗證收款人的銀行賬戶詳細資料，請向驗證收款人賬戶 /v2/beneficiaries/account_verification 端點發出 POST 請求。
POST /v2/beneficiaries/account_verification
請求正文包含以下參數：
Content-Type: multipart/form-data
| 參數名稱 | 參數類型 | 必填 | 示例值 | 註釋 |
|---|---|---|---|---|
| payment_type | 表單資料 | 否 | 常規 | 「優先」（Swift 網絡）或「常規」（本地） |
| bank_country | 表單資料 | 是 | GB | 收款人銀行賬戶所在國家/地區的雙字母代碼 |
| currency | 表單資料 | 是 | GBP | 三字母貨幣代碼 | 匯款至收款人銀行賬戶的貨幣 |
| account_number | 表單資料 | 是 | 73515966 | 英國銀行賬戶號碼 |
| beneficiary_entity_type | 表單資料 | 是 | 個人 | 「個人」或「公司」。如果是個人，則「beneficiary_first_name」和「beneficiary_last_name」必填。如果是公司，則「beneficiary_company_name」必填。 |
| beneficiary_company_name | 表單資料 | 否 | Sousa Ltd | 如果實體是「公司」，則必填。 |
| beneficiary_first_name | 表單資料 | 否 | Ricardo | 如果實體是「個人」，則必填。 |
| beneficiary_last_name | 表單資料 | 否 | Sousa | 如果實體是「個人」，則必填。 |
| routing_code_type_1 | 表單資料 | 否 | sort_code | 本地支付路由系統，例如 sort_code、aba、bsb_code、institution_no、bank_code、branch_code、clabe、cnaps |
| routing_code_value_1 | 表單資料 | 否 | 015561 | routing_code_type_1 的路由編碼。 |
| routing_code_type_2 | 表單資料 | 否 | 本地支付路由系統 | |
| routing_code_value_2 | 表單資料 | 否 | routing_code_type_2 的路由編碼 | |
| bic_swift | 表單資料 | 否 | BIC/Swift 代碼 | |
| iban | 表單資料 | 否 | IBAN（國際銀行賬戶號碼） | |
| secondary_reference_data | 表單資料 | 否 | 無法透過分類代碼和賬戶號碼進行唯一定址，而是依賴其支付服務提供者 (PSP) 透過 SRD 將款項存入其賬戶的客戶賬戶 - 即使用支付中的參考欄位，再加上一個唯一識別碼。 |
請求示例：
{
"payment_type": "regular",
"bank_country":"GB",
"currency":"GBP",
"account_number":"73515966",
"beneficiary_entity_type": "individual",
"beneficiary_company_name": null,
"beneficiary_first_name":"Ricardo",
"beneficiary_last_name":"Sousa",
"routing_code_type_1": "sort_code",
"routing_code_value_1":"015561",
"routing_code_type_2": null,
"routing_code_value_2": null,
"bic_swift": null,
"iban": null,
"secondary_reference_data": null
}
回應
請注意，您必須停用介面快取資料的功能，以免最終客戶在未進行再次受款人確認請求的情況下，存取先前透過受款人確認請求取得的資料。
回應示例
200
{
"answer": "full_match",
"actual_name":"Ricardo Sousa",
"reason_code":"AV100",
"reason":"Full match.",
"reason_type": "okay"
}
200
{
"answer": "close_match",
"actual_name":"Ricardo Sous",
"reason_code":"AV300",
"reason":"String is a close match to the account name.",
"reason_type": "warning"
}
JSON 回應正文中包含以下參數：
| 參數名稱 | 資料類型 | 示例值 | 說明 |
|---|---|---|---|
| answer | 字串 | full_match | 驗證是否產生匹配結果的指標。可能的值為「full_match」、「close_match」或「no_match」 |
| actual_name | 字串 | Ricardo Sousa | 賬戶持有人的真實姓名。如果 reason_code 為 AV100、AV300、AV301 或 AV302，則會顯示。 |
| reason_code | 字串 | AV100 | 編碼原因。如果 answer 為 full_match、close_match 或 no_match，則會顯示。 |
| reason | 字串 | Full match | reason_code 的元資料。僅當顯示 reason_code 時才會填入。值對應於 reason_code 的說明。 |
| reason_type | 字串 | okay | 原因的元資料。僅當顯示 reason_code 時才會填入。類型對應於客戶端使用者介面中的建議警告訊息要求。可能的值為「通過」、「已拒絕」和「警告」。 |
在使用者介面中反映 API 回應的指南
與我們的驗證收款人賬戶 API 集成時，為了提供無縫的使用者體驗，有效處理各種回應至關重要。以下是在您的介面中實現每種回應的建議，以及文案和使用者體驗 (UX) 處理建議。
提醒：如果您是使用 API 與 The Currency Cloud Limited 訂立合約的「贊助」或「財務管理」模式客戶，則在透過我們的創建支付 API 向收款人支付之前，您必須將收款人賬戶驗證步驟作為英國收款人創建流程的一部分。
1.AV100（完全匹配）
請求：
{
"payment_type": "regular",
"bank_country":"GB",
"currency":"GBP",
"account_number":"73515966",
"beneficiary_entity_type": "individual",
"beneficiary_company_name": null,
"beneficiary_first_name":"Ricardo",
"beneficiary_last_name":"Sousa",
"routing_code_type_1": "sort_code",
"routing_code_value_1":"015561",
"routing_code_type_2": null,
"routing_code_value_2": null,
"bic_swift": null,
"iban": null,
"secondary_reference_data": null
}
回應：
200
{
"answer": "full_match",
"actual_name":"Ricardo Sousa",
"reason_code":"AV100",
"reason":"Full match.",
"reason_type": "okay"
}
API 原因：完全匹配
說明：收款人的銀行能夠確認全名和賬戶匹配。
處理：最終客戶可以繼續創建收款人。
使用者介面建議：
2.AV300（近似匹配）
請求：
{
"payment_type": "regular",
"bank_country":"GB",
"currency":"GBP",
"account_number":"73515966",
"beneficiary_entity_type": "individual",
"beneficiary_company_name": null,
"beneficiary_first_name":"Ricardo",
"beneficiary_last_name":"Sous",
"routing_code_type_1": "sort_code",
"routing_code_value_1":"015561",
"routing_code_type_2": null,
"routing_code_value_2": null,
"bic_swift": null,
"iban": null,
"secondary_reference_data": null
}
回應：
200
{
"answer": "close_match",
"actual_name":"Ricardo Sousa",
"reason_code":"AV300",
"reason":"String is a close match to the account name.",
"reason_type": "warning"
}
API 回應：AV300
說明：這是近似匹配。顯示突顯錯誤的訊息，以及繼續創建的風險。在回應中會提供實際 account_name。
處理：如果出現近似匹配，則向最終客戶顯示 actual_name。考慮提供行動呼籲或按鈕，引導使用者提交正確的詳細資料。這樣可以減少認知負荷，讓他們更容易調整自己的選擇。
如果出現近似匹配，您必須清楚說明問題和解決方案。但是，如果最終客戶決定繼續操作，則顯示二次警告對話方塊，提示他們自行斟酌並承擔風險。
使用者介面建議：
3.AV201（不匹配）
請求：
{
"payment_type": "regular",
"bank_country":"GB",
"currency":"GBP",
"account_number":"11235813",
"beneficiary_entity_type": "individual",
"beneficiary_company_name": null,
"beneficiary_first_name":"Ricardo",
"beneficiary_last_name":"Smith",
"routing_code_type_1": "sort_code",
"routing_code_value_1":"314159",
"routing_code_type_2": null,
"routing_code_value_2": null,
"bic_swift": null,
"iban": null,
"secondary_reference_data": null
}
回應：
200
{
"answer": "no_match",
"actual_name": null,
"reason_code":"AV201",
"reason":"String does not match the account name.",
"reason_type": "rejected"
}
API 回應：AV201
回應：字串與賬戶名稱不匹配。
處理：這是不匹配。顯示突顯錯誤的負面通知。在回應中不會提供實際 actual_name。創建一個按鈕，讓最終客戶選擇編輯賬戶詳細資料或保留他們輸入的內容。
如果出現不匹配，您必須清楚說明問題。但是，如果最終客戶決定繼續操作，則顯示二次警告對話方塊，提示他們自行斟酌並承擔風險。
使用者介面建議：
原因代碼
本節提供完整的原因代碼清單，以及在使用者介面上反映這些代碼的建議。
Currencycloud Direct 平台的風格和語調是我們文案和處理建議的基礎。雖然不一定要完全匹配，但您的集成應盡量貼近，以維持一致的使用者體驗。
成功回應 (HTTP 200)
| 結果 | 原因 代碼 |
原因 | 原因類型 | 建議文案 | 如何處理 |
| full_match | AV100 | Full match | 通過 |
 已確認收款人詳細資料已確認輸入的收款人詳細資料完全匹配。請繼續創建收款人。 [返回] [取消] [創建收款人] |
向最終客戶顯示正面通知，表明驗證成功。 |
| no_match | AV200 | 指定賬戶號碼的賬戶不存在。 | 已拒絕 |
 無法確認賬戶詳細資料提供的收款人賬戶號碼和分類代碼與記錄不匹配。請檢查您輸入的資訊，必要時按一下「返回」以進行更新，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 3.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。 4.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| no_match | AV201 | 字串與賬戶名稱不匹配。 | 已拒絕 |
收款人姓名不匹配 您提供的收款人姓名與記錄不匹配。請檢查您輸入的資訊，必要時按一下「返回」以進行更新，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 3.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。 4.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| no_match | AV202 AV203 AV204 AV205 |
無法檢查賬戶詳細資料。 | 已拒絕 |
無法檢查提供的詳細資料 無法檢查您提供的詳細資料。請檢查您輸入的資訊，必要時按一下「返回」以進行更新，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 3.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。 4.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| no_match | AV206 | 二級客戶參考資料無效。 | 已拒絕 |
提供的詳細資料不匹配 您提供的收款人參考資料與記錄不匹配。請檢查您輸入的資訊，必要時按一下「返回」以進行更新，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 3.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。 4.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| no_match | AV207 | 無法檢查賬戶詳細資料。 | 已拒絕 | 使用測試套件中未包含的資料會導致在我們的演示環境中出現此回應。如果在生產環境中出現這種情況，請報告至 support@currencycloud.com。 | |
| close_match | AV300 | 字串與賬戶名稱近似匹配 | 警告 |
 收款人姓名不正確您提供的收款人詳細資料與記錄近似匹配，但姓名是「[actual_name]」。請檢查您輸入的資訊，必要時按一下「返回」以將收款人姓名更新為「[actual_name]」，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人]（在做出選擇之前處於停用狀態） 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.會提供 actual_name。將提供的文案填入到 [actual_name] 中。3.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 4.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。5.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| close_match | AV301 | 字串與賬戶名稱近似匹配。當請求中指明為個人時，賬戶類型為企業。 | 警告 |
公司名稱不正確 您提供的收款人詳細資料與記錄近似匹配，但公司名稱是「[actual_name]」。請檢查您輸入的資訊，必要時按一下「返回」以將公司名稱更新為「[actual_name]」，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人]（在做出選擇之前處於停用狀態） 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.會提供 actual_name。將提供的文案填入到 [actual_name] 中。3.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 4.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。5.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| close_match | AV302 | 字串與賬戶名稱近似匹配。當請求中指明為企業時，賬戶類型為個人。 | 警告 |
收款人姓名不正確 您提供的收款人詳細資料與記錄近似匹配，但姓名是「[actual_name]」。請檢查您輸入的資訊，必要時按一下「返回」以將收款人姓名更新為「[actual_name]」，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人]（在做出選擇之前處於停用狀態） 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.會提供 actual_name。將提供的文案填入到 [actual_name] 中。3.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 4.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。5.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| close_match | AV303 | 字串與賬戶名稱匹配，但當請求中指明為個人時，賬戶類型為企業。 | 警告 |
收款人類型不正確 您提供的收款人詳細資料與記錄近似匹配，但收款人被認定為公司而非個人。請檢查您輸入的資訊，必要時按一下「返回」以將收款人類型更新為「公司」，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 3.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。 4.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| close_match | AV304 | 字串與賬戶名稱近似匹配，但當請求中指明為企業時，賬戶類型為個人。 | 警告 |
收款人類型不正確 您提供的收款人詳細資料與記錄近似匹配，但收款人被認定為個人而非公司。請檢查您輸入的資訊，必要時按一下「返回」以將收款人類型更新為「個人」，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 3.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。4.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
| close_match | AV305 | 賬戶已切換至其他組織。 | 警告 |
賬戶已切換 您提供的收款人詳細資料與記錄近似匹配，但該賬戶已切換至其他組織。請檢查您輸入的資訊，必要時按一下「返回」以進行更新，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
1.顯示突顯錯誤的負面通知。 2.創建一個按鈕，讓最終客戶選擇返回、取消或創建收款人。 3.如果使用者按一下/輕觸「返回」，則必須提交新的 API 請求，以檢查新的詳細資料。 4.如果使用者按一下/輕觸「創建收款人」，最終客戶應透過對話方塊收到二次警告。 |
技術錯誤
HTTP 503 - 服務不可用
| 錯誤代碼 | 錯誤 原因 |
必要文案 | 如何處理 |
| service_unavailable | 服務暫時不可用 |
無法檢查提供的詳細資料 目前無法檢查您提供的收款人詳細資料。請稍後再嘗試創建收款人，或者如果您確定詳細資料正確，請按一下「創建收款人」。 [返回] [取消] [創建收款人] 您確定要繼續嗎？ 向此人或企業支付可能會導致您的資金被匯入錯誤賬戶。我們可能無法為您追回這筆資金。 [取消] [仍然繼續] |
連接失敗 1.顯示突顯問題的負面通知。 2.在向使用者顯示錯誤之前，引入內部重試機制。 3.如果使用者按一下/輕觸「返回」到詳細資料，最終客戶將返回收款人創建螢幕。 4.需要提出新的請求，以檢查新的詳細資料。 5.如果使用者按一下/輕觸「仍然繼續」，最終客戶應收到二次警告。 |
HTTP 400 - 錯誤請求
必要文案和處理要求不適用於 HTTP 400 錯誤，因為最終客戶應該無法觸發這些驗證。
| 錯誤代碼 | 錯誤原因 |
|---|---|
| invalid_bank_country | bank_country 不受支援 |
| invalid_field_bank_country | bank_country 必須匹配「^[A-Z]{2}$」 |
| invalid_field_account_number | account_number 必須匹配 ^[0-9]{1,8}$ |
| invalid_field_routing_code_value_1 | routing_code_value_1 必須匹配 ^[0-9]{6}$ |
| invalid_field_beneficiary_type | beneficiary_entity_type 必須是「個人」或「公司」。 |
| expect_individual_names_only | 當 beneficiary_entity_type 為個人時，不可提供 beneficiary_company_name。 |
| expect_company_name_only | 當 beneficiary_entity_type 為公司時，不可提供 beneficiary_first_name 和 beneficiary_last_name。 |
| missing_individual_names | 當 beneficiary_entity_type 為個人時，beneficiary_first_name 和 beneficiary_last_name 必填。 |
| missing_company_name | 當 beneficiary_entity_type 為公司時，beneficiary_company_name 必填。 |
第 3 步：創建或更新收款人
成功驗證詳細資料後，您可以使用收款人 API 設定新的收款人記錄或更新現有記錄。向創建收款人 /v2/beneficiaries/create 端點發出 POST 請求以創建新的收款人，或向更新收款人 /v2/beneficiaries/{id} 端點發出 POST 請求以更新現有收款人。
請記住，如果在賬戶驗證過程中出現「近似匹配」，且使用者從回應中選擇了賬戶名稱，則您需要在創建或更新收款人時使用這些詳細資料。
如果收款人已成功創建或更新，則回應訊息將包含您 Currencycloud 賬戶中記錄的收款人完整詳細資料。
請記錄收款人的唯一 ID (id)。您需要提供此 ID 才能向收款人支付。
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "aea097c2-39e4-49b5-aaa6-c860ca55ca0b",
"bank_account_holder_name":"Acme GmbH",
"name":"Acme GmbH",
"email": null,
"payment_types": [
"regular"
],
"beneficiary_address": [],
"beneficiary_country":"DE",
"beneficiary_entity_type": null,
"beneficiary_company_name": null,
"beneficiary_first_name": null,
"beneficiary_last_name": null,
"beneficiary_city": null,
"beneficiary_postcode": null,
"beneficiary_state_or_province": null,
"beneficiary_date_of_birth": null,
"beneficiary_identification_type": null,
"beneficiary_identification_value": null,
"bank_country":"DE",
"bank_name":"Test Bank Plc",
"bank_account_type": null,
"currency":"EUR",
"account_number": null,
"routing_code_type_1": null,
"routing_code_value_1": null,
"routing_code_type_2": null,
"routing_code_value_2": null,
"bic_swift":"COBADEFF",
"iban": "[Sensitive data redacted]",
"default_beneficiary": "false",
"creator_contact_id":"1993263d-be07-42d4-b75b-ae4ea18bcb6c",
"bank_address": [],
"created_at":"2021-02-02T11:52:23+00:00",
"updated_at":"2021-02-02T11:52:23+00:00",
"beneficiary_external_reference": null
}
第 4 步：開發您的使用者旅程
將驗證收款人賬戶 API 集成到您的應用程式時，建議遵循以下最佳做法：
- 清晰訊息：確保每個回應所附的訊息簡潔、資訊豐富且易於使用者使用。
- 視覺回饋：使用圖示、顏色和訊息橫幅等視覺元素，為使用者提供清晰回饋。
- 錯誤處理：部署強大的錯誤處理功能，以妥善處理來自驗證收款人賬戶 API 的意外回應或錯誤。
- 可存取性：設計所有使用者均可存取的使用者介面，確保回應訊息可感知且可理解。
透過遵循這些指引，您可以將驗證收款人賬戶 API 回應與您的介面無縫集成，在驗證收款人詳細資料時為使用者提供流暢直觀的體驗。
示例如下：
