跳转到主要内容
用于检索用于转账资金的 account_id

概览

用于查找转账操作收款方的两个查询:
  • lookupUser - 通过电话或邮箱查找用户
  • lookupBusiness - 通过公司名称查找企业

lookupUser

查找个人用户收款方。

查询(UserLookupInput)

需要QUERY_RECIPIENT 权限范围。

输入

仅提供且必须提供一个字段

响应(UserLookupResult)

示例

按电话:
按邮箱:
成功:
未找到:

错误代码


lookupBusiness

按公司名称查找企业收款方。

查询

需要QUERY_RECIPIENT 权限范围。

输入

注意: 同时搜索注册企业名称与 DBA 名称。必须精确匹配(不区分大小写)。

响应

示例

单个匹配:
多个匹配(同名,不同 DBA):
未找到:

错误代码



重要说明

lookupUser

  • 电话号码必须为 E.164 格式(例如:+14155551234)
  • 美国 10 位号码会自动规范化
  • 邮箱不区分大小写
  • 未找到则抛出错误

lookupBusiness

  • 不区分大小写的精确匹配——“acme corporation” 可匹配 “ACME CORPORATION” 或 “Acme Corporation”
  • 同时搜索企业名称与 DBA 名称
  • 返回数组(可能包含多个同名企业)
  • 未匹配到则抛出错误
  • 当 DBA 与企业名称不同,companyName 格式为 “Business Name (DBA Name)”