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
}
}
Card
Get Card Details
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
}
}
Retrieves detailed information for a single card.
Request Headers
apiKey (merchant credential, bound to IP whitelist)
Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.
Login token (required for all interfaces except Get Token).
Fixed to
application/jsonPath Parameters
Card order number.
Response Parameters
Response status code.
0 indicates success.Response message.
Response data.
Show data
Show data
Card order number
Merchant-side unique order number
Cardholder order number
Card alias
Card package English name
Card package Chinese name
Card type, see [Appendix - Constants] Card Types
Card organization
Last four digits of card number
Fee details.
Show fee_detail
Show fee_detail
Consumption fee rate
Card issuance cost
Cross-border consumption fee rate
Small transaction threshold
Small transaction extra deduction
Free small transaction count
Small transaction fee exemption cycle type, see [Appendix - Constants] Exemption Types
Small transaction fee exemption cycle duration
Refund fee rate
Transaction cancellation fee
Transaction cancellation fee threshold
Decline fee
Number of decline fee waivers
Decline fee waiver cycle type, see [Appendix - Constants] Exemption Types
Decline fee waiver cycle duration
ATM withdrawal fee rate (value present for physical cards)
ATM withdrawal minimum fee (value present for physical cards)
Apple Pay fee rate (value present for some card BINs)
Management fee type, see [Appendix - Constants] Management Fee Types (value present for some card BINs)
Management fee (value present for some card BINs)
Management fee waiver method, see [Appendix - Constants] Management Fee Waiver Methods (value present for some card BINs)
Management fee waiver threshold (Amount → amount threshold; Count → count threshold; value present for some card BINs)
Status, see [Appendix - Constants] Common Status
Card creation time (Unix milliseconds)
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