跳轉到主要內容
用於擷取用於轉帳資金之帳戶的 account_id

概覽

兩種用於查詢轉帳作業收款人的查詢:
  • lookupUser - 依電話或電子郵件尋找使用者
  • lookupBusiness - 依公司名稱尋找企業

lookupUser

查詢個人使用者收款人。

Query (UserLookupInput)

需要QUERY_RECIPIENT 權限範圍。

Input

請僅提供其中一個欄位

Response (UserLookupResult)

範例

依電話:
依電子郵件:
成功:
查無資料:

錯誤代碼


lookupBusiness

依公司名稱查詢企業收款人。

Query

需要QUERY_RECIPIENT 權限範圍。

Input

注意: 同時搜尋登記的企業法定名稱與 DBA 名稱。必須精確相符(不分大小寫)。

Response

範例

單筆相符:
多筆相符(同名,不同 DBA):
查無資料:

錯誤代碼



重要注意事項

lookupUser

  • 電話號碼必須為 E.164 格式(例如:+14155551234)
  • 10 位數的美國號碼會自動正規化
  • 電子郵件不分大小寫
  • 若查無資料則拋出錯誤

lookupBusiness

  • 不分大小寫的精確相符——“acme corporation” 可匹配 “ACME CORPORATION” 或 “Acme Corporation”
  • 同時搜尋企業名稱與 DBA 名稱
  • 回傳陣列(可能包含多家同名企業)
  • 若無相符結果則拋出錯誤
  • 當 DBA 與企業名稱不同時,companyName 會格式化為 “Business Name (DBA Name)”