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
}
}
获取单张卡的详细信息。
请求头
string
必填
apiKey（商户凭证，与 IP 白名单绑定）
string
必填
Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
string
必填
登录标识（除获取 Token 外必填）
string
默认值:"application/json"
固定为
application/json路径参数
string
必填
卡单号
返回参数
number
响应状态码，
0 表示成功string
响应消息
object
返回数据
显示 data
显示 data
string
卡单号
string
商户侧唯一单号
string
持卡人单号
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 有值）
string
状态，见【附录-常量表】通用状态
number
开卡时间（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
}
}