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": ""
}
}]
}
}
Card
Get Card Package List
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": ""
}
}]
}
}
Retrieves the card package list (credit extension mode).
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/jsonRequest Body
string
Package type, see Appendix Constants - Card Types.
string
Card package order number.
number
default:"0"
Query page number. Defaults to
0.number
default:"10"
Number of records per page. Defaults to
10 (max 100).Response Parameters
number
Response status code.
0 indicates success.string
Response message.
object
Response data.
Show data
Show data
object[]
Card package list.
Show list
Show list
string
Card package order number
string
Card package English name
string
Card package Chinese name
string
Card BIN
string
Card BIN order number
string
Card organization
string
Card package type, see [Appendix - Constants] Card Types
string
English description
string
Chinese description
string[]
English tag list
string[]
Chinese tag list
object
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)
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": ""
}
}]
}
}