2.1.32开卡(普通模式)-v4

接口地址:/v4/openapi/card/apply

请求方式:POST

请求数据类型:application/json

响应数据类型:application/json

接口描述:

此接口是2.1.21接口的升级版本

接口变动：请求参数中增加mc_trade_no、doc_never_expire、doc_expire_date字段

请求示例:

{
  "base_info": {
    "card_type_id": "40000002",
    "email": "example@gmail.com",
    "first_name": "pan",
    "first_recharge_amount": "188",
    "last_name": "gao",
    "mobile": "1888888888",
    "mobile_code": "86",
    "user_ip": "40.77.166.66"
  },
  "kyc_info": {
    "address": "maizidianjie28hao",
    "back_doc": "",
    "birthday": "1990-01-01",
    "city": "beijing",
    "country_id": "CN",
    "doc_expire_date": "2026-06-16",
    "doc_never_expire": 0,
    "doc_no": 12345678,
    "doc_type": 1,
    "emergency_contact": "John",
    "front_doc": "",
    "gender": 1,
    "mix_doc": "",
    "nationality_id": "CN",
    "sign_img": "",
    "state": "beijing",
    "zip_code": "100100",
    "poa_doc": "",
    "poa_type": "1"
  },
  "mc_trade_no": "48d2741747a4493223feb22"
}

请求参数:

参数名称	数据类型	是否必须	参数说明
mc_trade_no	string	true	请求号，商户自定义；最多64个字符.
base_info	object	true	用户基础信息
card_type_id	string	true	卡种ID
email	string	true	邮箱；字符长度最大64位。
first_name	string	true	用户名；字符长度最大50位
last_name	string	true	用户姓；字符长度最大50位
mobile	string	true	手机号；字符长度最小6位最大11位
mobile_code	string	true	手机号区号；字符长度最大5位
user_ip	string	false	用户IP；字符长度最大20位
first_recharge_amount	string	true	首充金额：开卡后立即充值到卡片法币金额, 必须大于等于0。如果是预开卡，则此字段不要求必填，否则为必填
kyc_info	object	true	用户KYC信息
address	string	true	通讯地址，银行卡会寄到该地址；字符长度最大256位；默认需要符合正则表达式：地址正则表达式的默认正则如果card_type_id在[71000003,71000002]范围内，则需要符合正则表达式：地址正则表达式的71000003,71000002卡片正则
back_doc	string	false	证件照反面；Base64格式的图片文件，照片文件大小应小于2M；支持文件类型：jpg,jpeg,png
birthday	string	true	生日，格式：yyyy-MM-dd
city	string	true	城市；字符长度最大100位
country_id	string	true	所在国家唯一标识，取值范围参考附录【3.2 手机区号和国家编码】-【二字码】；如果已开通卡片列表接口返回的`kyc_country_limit_short`字段有值，则此字段的值必需在`kyc_country_limit_short`字段范围内
doc_no	string	true	证件号码；字符长度最大128位
doc_type	integer	true	证件类型您可以在已开通卡片列表接口获取卡种支持的证件类型
emergency_contact	string	true	紧急联系人；字符长度最大255位
front_doc	string	true	证件照正面；Base64格式的图片文件，照片文件大小应小于2M；支持文件类型：jpg,jpeg,png
gender	integer	true	性别，1男;2女
mix_doc	string	true	手持证件照；Base64格式的图片文件，照片文件大小应小于2M；支持文件类型：jpg,jpeg,png
nationality_id	string	true	国籍唯一标识，取值范围参考附录【3.2 手机区号和国家编码】-【二字码】
sign_img	string	true	签名照片；Base64格式的图片文件，照片文件大小应小于1M；支持文件类型：jpg,jpeg,png
state	string	true	省份；字符长度最大100位
zip_code	string	true	邮编；字符长度最大20位
doc_expire_date	string	false	证件有效期；字符长度最大16位，格式yyyy-MM-dd,示例值(2026-06-16)
doc_never_expire	integer	true	证件永久有效；1代表永久有效，此时忽略doc_expire_date字段，0代表有有效期，doc_expire_date字段必填
poa_doc	string	false	地址证明；Base64格式的图片文件，照片文件大小应小于2M；支持文件类型：jpg,jpeg,png,pdf；如果 2.1.37 商户已开通卡查询-v5 接口的`need_poa`字段值为1, 您可以通过这个字段上传地址证明
poa_type	integer	false	地址证明类型；1 自助提供 2 协助认证；如果选择自助提供，则poa_doc不能为空；如果 2.1.37 商户已开通卡查询-v5 接口的`need_poa`字段值为1, 此字段不能为空

响应参数:

参数名称	类型	参数说明
code	string	错误码
msg	string	错误信息

响应示例:

{
  "code": "00000",
  "msg": "ok"
}

2.1.32开卡(普通模式)-v4

2.1.32开卡(普通模式)-v4

results matching ""

No results matching ""