2.1.37 商户已开通卡查询-v5
接口地址:/v5/openapi/card/list
请求方式:POST
请求数据类型:application/json
响应数据类型:application/json
接口描述:
此接口是2.1.34接口的升级版本
注意⚠️:在接口的请求和返回报文后续可能会增加更多字段;因此在使用此接口时需要忽略不识别的新字段,防止报错
接口更新日志:
更新日期 | 更新内容 |
---|---|
2023-07-20 | 返回参数中增加card_detail_obtain_way 字段 |
2023-09-06 | 返回参数中增加kyc_country_limit 、billing_kyc_column_limit 字段 |
2023-09-18 | 返回参数中增加can_change_billing_address 字段 |
2024-02-19 | 返回参数中增加doc_type 字段 |
2024-03-15 | 返回参数中增加can_repeat 字段 |
2024-04-09 | 请求参数中增加card_type_id 字段,返回参数中增加status 字段 |
2024-04-23 | 返回参数中增加black_list_types 字段 |
2024-04-26 | 返回参数中增加need_aml_report 、aml_type 字段 |
2024-05-06 | 返回参数中增加need_poa 、support_poa_type 字段 |
2024-06-07 | 返回参数中增加kyc_nationality_limit_id 字段 |
2024-11-06 | 返回参数中增加kyc_nationality_limit_short 、kyc_country_limit_short 字段 |
2024-12-17 | 返回参数中增加multiple_boolean_config 字段 |
请求参数:
{
"card_type_id": "40000002"
}
请求参数:
参数名称 | 数据类型 | 是否必须 | 参数说明 |
---|---|---|---|
card_type_id | string | false | 卡种ID |
响应参数:
参数名称 | 类型 | 参数说明 | |
---|---|---|---|
code | string | 错误码 | |
data | array | 响应数据 | |
activate_type | integer | 激活方式 | |
apply_pay_coin | string | 开卡支付币种 | |
apply_type | integer | 申请方式,不同的申请方式对应的卡片申请接口不一致;申请方式取值范围 | |
card_coin | string | 卡片币种 | |
card_fee | string | 单位usdt 保留8位小数 | |
card_org | integer | 卡组织 | |
card_sub_type | string | 卡片材质类型;取值范围:3.9 卡片材质类型 | |
card_type | string | 银行卡类型;取值范围:3.8 银行卡类型 | |
card_type_id | string | 卡种ID | |
china_postage | string | 中国邮费 单位usd | |
kyc_nationality_limit | integer | KYC出生国限制规则,此字段已废弃,请使用kyc_nationality_limit_id 字段 |
|
max_recharge_amount | string | 单日最高充值金额 | |
max_single_recharge_amount | string | 单笔充值最大金额 | |
min_single_recharge_amount | string | 单笔最低充值金额 | |
non_china_postage | string | 非中国邮费 单位usd | |
recharge_fee | string | 充值手续费 | |
recharge_pay_coin | string | 充值支付币种 | |
support_business | string | 支持的操作;如果有多个按照逗号分隔,取值范围:3.11 操作类型 | |
support_refund | integer | 是否支持退款 | |
need_first_recharge | integer | 首充金额是否必须,如果必须请使用v2版本以上的开卡接口;1:必须,0:非必须 | |
min_first_recharge_amount | string | 最小首充金额,单位同卡片币种 | |
more_card | integer | 是否支持同一个用户开多张相同类型的卡;1:支持,0:不支持 | |
can_recharge | integer | 卡片是否支持冲值;1:支持,0:不支持;如果不支持充值,则此卡片无法充值并且不允许进行开卡申请 | |
card_detail_obtain_way | integer | 银行卡详情信息获取方式;0:通过API接口获取,1:加密方式获取(用户打开页面输入密码查询卡号),2:通过邮件获取 1和2只能调用2.1.37银行卡信息查询-v2 接口。 0 通过API接口获取:可以继续使用2.1.7银行卡信息查询接口,建议升级至2.1.37银行卡信息查询-v2 |
|
kyc_country_limit | string | 国家限制,值为使用逗号分割的国家ID; 如果此字段不为空,则在卡片申请时的 country_id 字段的取值必需在此字段的国家范围内 |
|
kyc_country_limit_short | string | 国家限制,值为使用逗号分割的国家二字码; 如果此字段不为空,则在卡片申请时的 country_id 字段的取值必需在此字段的国家范围内 |
|
billing_kyc_column_limit | integer | 账单模式卡片申请 字段限制, 只有当此接口的apply_type = 4时, 这个字段才有值; 1: 所有字段都要求; 2: 部分字段要求 |
|
can_change_billing_address | integer | 是否允许修改账单地址; 1允许, 0不允许 | |
doc_type | string | 支持的证件类型;支持多种时使用逗号隔开 | |
can_repeat | integer | 是否允许相同的邮箱或手机号申请此卡片, 1 可以重复;0 不允许重复;您必须使用v4版以上的卡片申请接口才能使用重复的邮箱 | |
status | integer | 卡片状态, 1 启用;0 禁用;禁用的卡片无法申请开卡 | |
black_list_types | array | 黑名单列表 | |
black_list_type | string | 黑名单类型 | |
black_list_details | array | 黑名单详情 | |
black_list_name | string | 黑名单名称 | |
black_list_image | string | 黑名单图片地址 | |
need_aml_report | integer | 是否需要上传AML报告,如果需要,此值为1,否则为0 | |
aml_type | integer | AML报告提供方式; 1:由商户通过2.1.45附件上传接口提供,2: 由平台自动提供 | |
need_poa | integer | 是否需要地址证明照;0:不需要 1:需要; 如果需要地址证明照,则2.1.32开卡(普通模式), 2.1.39 开卡(账单模式) 和 2.1.44开卡(在线申请模式)接口的poa_type 字段不能为空 |
|
support_poa_type | string | 支持的地址证明照提供方式;1 自助提供 2 协助认证;支持多种的话用逗号隔开;3.21 地址证明范围要求 | |
kyc_nationality_limit_id | string | 不支持的国籍Id,多个使用逗号分割,如果此字段不为空,则在卡片申请时的 nationality_id 字段的取值必需不在此字段的国家范围内 |
|
kyc_nationality_limit_short | string | 不支持的国籍二字码,多个使用逗号分割,如果此字段不为空,则在卡片申请时的 nationality_id 字段的取值必需不在此字段的国家范围内 |
|
annual_fee | string | 年费,单位 usdt | |
multiple_boolean_config | integer | 多重boolean类型的卡片配置,当multiple_boolean_config&1=1时为是否需要sdk,如果需要sdk则2.1.38银行卡信息查询、2.1.46 卡片PIN码查询、2.1.42 3ds交易授权、2.1.43 3ds交易授权状态查询、接口需要在sdk中对接;sdk需要的token信息请使用2149_sdk_token接口获取 | |
msg | string | 错误信息 |
响应示例:
{
"code": "00000",
"data": [
{
"activate_type": "1",
"apply_pay_coin": "[\"usdt\",\"btc\",\"eth\",\"hbt\"]",
"apply_type": "1",
"card_coin": "usd",
"card_fee": "100.00000000",
"card_org": "1",
"card_sub_type": "1",
"card_type": "1",
"card_type_id": "40000002",
"china_postage": "100.02",
"kyc_nationality_limit": "1",
"max_recharge_amount": "100000.00000000",
"max_single_recharge_amount": "1000.00000000",
"min_single_recharge_amount": "10.00000000",
"min_first_recharge_amount": "100.00",
"need_first_recharge": 1,
"non_china_postage": "10.02",
"recharge_fee": "0.02800000",
"recharge_pay_coin": "[\"usdt\",\"btc\"]",
"support_business": "1,2,3",
"support_refund": "0",
"more_card": 1,
"can_recharge": 1,
"card_detail_obtain_way": 1,
"kyc_country_limit": "1,2,3,4",
"doc_type": "1,2",
"can_repeat": "1",
"status": 1,
"black_list_types": [
{
"black_list_type": "online pay",
"black_list_details": [
{
"black_list_name": "alipay",
"black_list_image": "https://hyperpay.oss-ap-southeast-1.aliyuncs.com/2024-03/20240305150642158571.png"
}
]
}
],
"need_aml_report": 1,
"aml_type": 1,
"need_poa": 1,
"support_poa_type": "1,2",
"kyc_nationality_limit_id": "1,2",
"annual_fee" : "0.00000000",
"kyc_country_limit_short" : "CN,US",
"kyc_nationality_limit_short": "CN,US",
"multiple_boolean_config": 1
}
],
"msg": "ok"
}