创建持卡人
创建持卡人。卡片只能发给 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 开头并带有该国区号时,平台会先去掉区号再校验长度。 查看各国长度