创建持卡人

创建持卡人。卡片只能发给 cardholder_status 为 SUCCESS 的持卡人。请先查询状态,再开卡。

POSThttps://uqpay.zytong.cn/openapi/v1/cardholders/create

请求参数

参数类型必填说明
out_order_no string 是 商户订单号,客户内唯一
email string 是 邮箱
first_name string 是 名,只能是英文,可包含空格和连字符
last_name string 是 姓,只能是英文,可包含空格和连字符
country_code string 是 两位国家代码,如 SG、US
phone_number string 是 不含国家区号的手机号,长度见手机号校验规则
date_of_birth string 否 生日,YYYY-MM-DD
residential_address object 否 居住地址,字段与 UQPAY 持卡人接口一致

返回参数

参数类型说明
code int 0 成功,-1 失败,-2 处理中或结果未知
success boolean 是否成功
message string 结果说明。失败时为错误原因
data object 业务数据
data.out_order_no string 商户订单号
data.cardholder_id string 持卡人 ID。开卡时使用
data.cardholder_status string SUCCESS 可开卡,PENDING 审核中,INCOMPLETE 资料不全,FAILED 未通过
data.email string 邮箱
data.first_name string 名
data.last_name string 姓

手机号

phone_number 填写不含国家区号的数字。以 + 或 00 开头并带有该国区号时,平台会先去掉区号再校验长度。 查看各国长度