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": ""
}
}]
}
}
获取卡套餐列表(授信模式)。
请求头
string
必填
apiKey(商户凭证,与 IP 白名单绑定)
string
必填
Unix 时间戳(毫秒),与服务端偏差须在 60 秒内,且不接受未来时间戳
string
必填
登录标识(除获取 Token 外必填)
string
默认值:"application/json"
固定为
application/json请求体
string
套餐类型,见 8.3 卡类型
string
卡套餐单号
number
默认值:"0"
查询页码,默认
0number
默认值:"10"
查询条数,默认
10(最多 100 条)返回参数
number
响应状态码,
0 表示成功string
响应消息
object
返回数据
显示 data
显示 data
object[]
卡套餐列表
显示 list
显示 list
string
卡套餐单号
string
卡套餐英文名称
string
卡套餐中文名称
string
卡 BIN
string
卡 BIN 单号
string
卡组织
string
卡套餐类型,见【附录-常量表】卡类型
string
英文描述
string
中文描述
string[]
英文标签列表
string[]
中文标签列表
object
费用详情
显示 fee_detail
显示 fee_detail
string
消费费率
string
开卡成本
string
跨境消费费率
string
小额消费阈值
string
小额消费额外扣除
number
免小额次数
string
小额消费免除周期类型,见【附录-常量表】免除类型
number
小额消费免除周期时长
string
退款费率
string
交易取消费用
string
交易取消费用阈值
string
拒付费
number
免除拒付手续费次数
string
免除拒付手续费周期类型,见 【附录-常量表】免除类型
number
免除拒付手续费周期时长
string
ATM 提现手续费费率(实体卡有值)
string
ATM 提现最小手续费(实体卡有值)
string
Apple Pay 费率(部分卡 BIN 有值)
string
管理费类型,见 【附录-常量表】管理费类型(部分卡 BIN 有值)
string
管理费用(部分卡 BIN 有值)
string
管理费免除收取方式,见 【附录-常量表】管理费免除方式(部分卡 BIN 有值)
string
管理费免除阈值(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": ""
}
}]
}
}
