Retrieve Beneficiary
通过指定 beneficiary_id 获取某个特定受益人。
授权
由 UQPay 提供的登录 API Token。
路径参数
资源的通用唯一标识符(UUID v4)。
"b3d9d2d5-4c12-4946-a09d-953e82sed2b0"
响应
OK —— 成功获取受益人。
受益人的通用唯一标识符(UUID v4)。
"b3d9d2d5-4c12-4946-a09d-953e82sed2b0"
系统生成的用于标识该实体的编号。
"P220406-LLCVLRM"
指定用于筛选的受益人实体类型。有效值为:
COMPANY:企业实体INDIVIDUAL:个人账户
COMPANY, INDIVIDUAL 需要指定支付方式,以确保针对该支付方式采集并校验准确的银行信息。
LOCAL:通过本地清算系统的境内支付网络处理的付款。SWIFT:通过 SWIFT 网络处理的跨境国际付款。
LOCAL, SWIFT "LOCAL"
受益人的电子邮箱地址。
"example@uqpay.com"
受益人的状态。
ACTIVE:受益人已完成验证,可以收款。PENDING:受益人正在验证过程中,暂时无法收款。
ACTIVE, PENDING "ACTIVE"
受益人昵称。
120"John Doe"
受益人的公司名称,仅当 entity_type 为 COMPANY 时存在。
-
当
payment_method = SWIFT时:- 仅可包含英文字母、数字、特殊字符(半角格式)和空格。
- 允许的特殊字符:
-_().,@#~ ! $ % ^ & * + = { } [ ] \ | : " ' < > ? /・……
-
当
payment_method = LOCAL时:- 不应用严格的校验规则,支持本地语言字符。
-
当
bank_details.bank_country_code = SG且bank_details.account_currency_code = SGD时无需传入此字段 -
当
bank_country_code = CN且account_currency_code = CNH且payment_method = LOCAL且entity_type = COMPANY时,支持中文字符和中文括号()。
120^[a-zA-Z0-9 -_().,@#~!$%^&*+={}\|:"'<>?/・……]*$"UQPAY TECHNOLOGY SG PTE LTD"
受益人的摘要。
"John Doe"
受益人的名字,仅当 entity_type 为 INDIVIDUAL 时存在。
-
当
payment_method = SWIFT时:- 仅可包含英文字母、数字、特殊字符(半角格式)和空格。
- 允许的特殊字符:
-_().,@#~ ! $ % ^ & * + = { } [ ] \ | : " ' < > ? /・……
-
当
payment_method = LOCAL时:- 不应用严格的校验规则,支持本地语言字符。
-
当
bank_details.bank_country_code = SG且bank_details.account_currency_code = SGD时无需传入此字段
45^[a-zA-Z0-9 -_().,@#~!$%^&*+={}\|:"'<>?/・……]*$"John"
受益人的姓氏,仅当 entity_type 为 INDIVIDUAL 时存在。
-
当
payment_method = SWIFT时:- 仅可包含英文字母、数字、特殊字符(半角格式)和空格。
- 允许的特殊字符:
-_().,@#~ ! $ % ^ & * + = { } [ ] \ | : " ' < > ? /・……
-
当
payment_method = LOCAL时:- 不应用严格的校验规则,支持本地语言字符。
-
当
bank_details.bank_country_code = SG且bank_details.account_currency_code = SGD时无需传入此字段
45^[a-zA-Z0-9 -_().,@#~!$%^&*+={}\|:"'<>?/・……]*$"Doe"
个人受益人的身份证件号码。 当受益人为中国大陆居民且满足以下条件时必填:
bank_details.account_currency_code为CNHpayment_method为LOCAL
"110101199001011234"
受益人的地址。
- 当
bank_details.bank_country_code = SG且bank_details.account_currency_code = SGD时无需传入此字段
受益人的创建时间。
"2024-03-01T00:00:00+08:00"
受益人的更新时间。
"2024-03-01T00:00:00+08:00"
受益人的附加信息。

