Skip to main content
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

​
Api-Key
string
required
apiKey (merchant credential, bound to IP whitelist)
​
Timestamp
string
required
Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.
​
Access-Token
string
required
Login token (required for all interfaces except Get Token).
​
Content-Type
string
default:"application/json"
Fixed to application/json

​
Request Body

​
type
string
Package type, see Appendix Constants - Card Types.
​
package_no
string
Card package order number.
​
page
number
default:"0"
Query page number. Defaults to 0.
​
size
number
default:"10"
Number of records per page. Defaults to 10 (max 100).

​
Response Parameters

​
code
number
Response status code. 0 indicates success.
​
msg
string
Response message.
​
data
object
Response data.
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": ""
      }
    }]
  }
}