curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/C202605220001/detail \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"card_no": "",
"card_unique_no": "",
"cardholder_no": "",
"card_name": "",
"package_name_en": "",
"package_name_cn": "",
"card_type": "",
"organization": "",
"card_last_no": "",
"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": ""
},
"status": "",
"time": 0
}
}
卡相关
获取卡详情
GET
/
open-api
/
v1
/
card
/
{card_no}
/
detail
curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/C202605220001/detail \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"card_no": "",
"card_unique_no": "",
"cardholder_no": "",
"card_name": "",
"package_name_en": "",
"package_name_cn": "",
"card_type": "",
"organization": "",
"card_last_no": "",
"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": ""
},
"status": "",
"time": 0
}
}
获取单张卡的详细信息。
请求头
apiKey(商户凭证,与 IP 白名单绑定)
Unix 时间戳(毫秒),与服务端偏差须在 60 秒内,且不接受未来时间戳
登录标识(除获取 Token 外必填)
固定为
application/json路径参数
卡单号
返回参数
响应状态码,
0 表示成功响应消息
返回数据
显示 data
显示 data
卡单号
商户侧唯一单号
持卡人单号
卡别名
卡套餐英文名称
卡套餐中文名称
卡类型,见 【附录-常量表】卡类型
卡组织
卡号后四位
费用详情
显示 fee_detail
显示 fee_detail
消费费率
开卡成本
跨境消费费率
小额消费阈值
小额消费额外扣除
免小额次数
小额消费免除周期类型,见【附录-常量表】免除类型
小额消费免除周期时长
退款费率
交易取消费用
交易取消费用阈值
拒付费
免除拒付手续费次数
免除拒付手续费周期类型,见【附录-常量表】免除类型
免除拒付手续费周期时长
ATM 提现手续费费率(实体卡有值)
ATM 提现最小手续费(实体卡有值)
Apple Pay 费率(部分卡 BIN 有值)
管理费类型,见 【附录-常量表】管理费类型(部分卡 BIN 有值)
管理费用(部分卡 BIN 有值)
管理费免除收取方式,见 【附录-常量表】管理费免除方式(部分卡 BIN 有值)
管理费免除阈值(Amount→金额阈值;Count→笔数阈值;部分卡 BIN 有值)
状态,见【附录-常量表】通用状态
开卡时间(Unix 毫秒)
curl --request GET \
--url https://sandbox-openplatform.keysecure.io/open-api/v1/card/C202605220001/detail \
--header 'Content-Type: application/json' \
--header 'Api-Key: your_api_key' \
--header 'Timestamp: 1716307200000' \
--header 'Access-Token: your_access_token'
{
"code": 0,
"msg": "Success",
"data": {
"card_no": "",
"card_unique_no": "",
"cardholder_no": "",
"card_name": "",
"package_name_en": "",
"package_name_cn": "",
"card_type": "",
"organization": "",
"card_last_no": "",
"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": ""
},
"status": "",
"time": 0
}
}
⌘I
