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