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_limitbilling_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_reportaml_type 字段
2024-05-06 返回参数中增加need_poasupport_poa_type 字段
2024-06-07 返回参数中增加kyc_nationality_limit_id 字段
2024-11-06 返回参数中增加kyc_nationality_limit_shortkyc_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"
}
Copyright © HyperCard 2023 all right reserved,powered by GitbookUpdate Time: 2025-01-14 15:38:46

results matching ""

    No results matching ""