curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/package/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"type": "Virtual",
"package_no": "",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [{
"package_no": "",
"package_en_name": "",
"package_cn_name": "",
"card_bin": "",
"card_bin_no": "",
"organization": "",
"package_type": "",
"en_desc": "",
"cn_desc": "",
"en_tag_list": ["tag1", "tag2"],
"cn_tag_list": ["标签1", "标签2"],
"consumption_limit": {
"limit_balance": "",
"limit_week_balance": "",
"limit_atm_day_balance": "",
"limit_atm_month_balance": ""
},
"fee_detail": {
"consume_rate": "",
"open_cost": "",
"cross_consume_rate": "",
"small_consume_threshold": "",
"small_consume_deduct": "",
"free_small_consume_count": 0,
"free_small_excuse_type": "",
"free_small_excuse_days": 0,
"refund_rate": "",
"consume_cancle_fee": "",
"consume_cancel_threshold": "",
"decline_fee": "",
"decline_fee_free_count": 0,
"decline_fee_free_type": "",
"decline_fee_free_days": 0,
"atm_rate": "",
"atm_min_fee": "",
"apple_pay_fee": "",
"manage_fee_type": "",
"manage_fee": "",
"management_fee_free_type": "",
"free_management_fee_threshold": ""
}
}]
}
}
卡相关
获取卡套餐列表
POST
/
open-api
/
v1
/
card
/
package
/
list
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/package/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"type": "Virtual",
"package_no": "",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [{
"package_no": "",
"package_en_name": "",
"package_cn_name": "",
"card_bin": "",
"card_bin_no": "",
"organization": "",
"package_type": "",
"en_desc": "",
"cn_desc": "",
"en_tag_list": ["tag1", "tag2"],
"cn_tag_list": ["标签1", "标签2"],
"consumption_limit": {
"limit_balance": "",
"limit_week_balance": "",
"limit_atm_day_balance": "",
"limit_atm_month_balance": ""
},
"fee_detail": {
"consume_rate": "",
"open_cost": "",
"cross_consume_rate": "",
"small_consume_threshold": "",
"small_consume_deduct": "",
"free_small_consume_count": 0,
"free_small_excuse_type": "",
"free_small_excuse_days": 0,
"refund_rate": "",
"consume_cancle_fee": "",
"consume_cancel_threshold": "",
"decline_fee": "",
"decline_fee_free_count": 0,
"decline_fee_free_type": "",
"decline_fee_free_days": 0,
"atm_rate": "",
"atm_min_fee": "",
"apple_pay_fee": "",
"manage_fee_type": "",
"manage_fee": "",
"management_fee_free_type": "",
"free_management_fee_threshold": ""
}
}]
}
}
获取卡套餐列表(授信模式)。
请求头
apiKey(商户凭证,与 IP 白名单绑定)
Unix 时间戳(毫秒),与服务端偏差须在 60 秒内,且不接受未来时间戳
登录标识(除获取 Token 外必填)
固定为
application/json请求体
套餐类型,见 8.3 卡类型
卡套餐单号
查询页码,默认
0查询条数,默认
10(最多 100 条)返回参数
响应状态码,
0 表示成功响应消息
返回数据
显示 data
显示 data
卡套餐列表
显示 list
显示 list
卡套餐单号
卡套餐英文名称
卡套餐中文名称
卡 BIN
卡 BIN 单号
卡组织
卡套餐类型,见【附录-常量表】卡类型
英文描述
中文描述
英文标签列表
中文标签列表
费用详情
显示 fee_detail
显示 fee_detail
消费费率
开卡成本
跨境消费费率
小额消费阈值
小额消费额外扣除
免小额次数
小额消费免除周期类型,见【附录-常量表】免除类型
小额消费免除周期时长
退款费率
交易取消费用
交易取消费用阈值
拒付费
免除拒付手续费次数
免除拒付手续费周期类型,见 【附录-常量表】免除类型
免除拒付手续费周期时长
ATM 提现手续费费率(实体卡有值)
ATM 提现最小手续费(实体卡有值)
Apple Pay 费率(部分卡 BIN 有值)
管理费类型,见 【附录-常量表】管理费类型(部分卡 BIN 有值)
管理费用(部分卡 BIN 有值)
管理费免除收取方式,见 【附录-常量表】管理费免除方式(部分卡 BIN 有值)
管理费免除阈值(Amount→金额阈值;Count→笔数阈值;部分卡 BIN 有值)
curl --request POST \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/package/list \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token' \
--data '{
"type": "Virtual",
"package_no": "",
"page": 0,
"size": 10
}'
{
"code": 0,
"msg": "Success",
"data": {
"list": [{
"package_no": "",
"package_en_name": "",
"package_cn_name": "",
"card_bin": "",
"card_bin_no": "",
"organization": "",
"package_type": "",
"en_desc": "",
"cn_desc": "",
"en_tag_list": ["tag1", "tag2"],
"cn_tag_list": ["标签1", "标签2"],
"consumption_limit": {
"limit_balance": "",
"limit_week_balance": "",
"limit_atm_day_balance": "",
"limit_atm_month_balance": ""
},
"fee_detail": {
"consume_rate": "",
"open_cost": "",
"cross_consume_rate": "",
"small_consume_threshold": "",
"small_consume_deduct": "",
"free_small_consume_count": 0,
"free_small_excuse_type": "",
"free_small_excuse_days": 0,
"refund_rate": "",
"consume_cancle_fee": "",
"consume_cancel_threshold": "",
"decline_fee": "",
"decline_fee_free_count": 0,
"decline_fee_free_type": "",
"decline_fee_free_days": 0,
"atm_rate": "",
"atm_min_fee": "",
"apple_pay_fee": "",
"manage_fee_type": "",
"manage_fee": "",
"management_fee_free_type": "",
"free_management_fee_threshold": ""
}
}]
}
}
⌘I
