Query Card Balance

Check the balance of a specific card.

Request URI

POST /issuing/card/query-card-balance

Request Body

Refer to : common

Biz_data :

Name	Type	Description
card_token*	string	Card token

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "request_id": "E97BB43e-de41-4f3D-6238-5b95184C",
    "timestamp": "2025-04-07 13:56:37",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "card_token": "450620141926"
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!

Response

Name	Type	Description
account_name	string	Account Name
account_num	string	Account number
currency	string	Account currency. As a 3-letter ISO currency code.
balance	string	Total balance.Unit
available_balance	string	Available balance.Unit
block_amount	string	Block amount.Unit
card_token	string	Card token

200:OK

{
    "code": "10000",
    "msg": "Success",
    "total": 7,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": [{
        "account_num": "658704******3982",
        "account_name": "Test User",
        "currency": "USD",
        "balance": "100012063.26",
        "available_balance": "100012063.26",
        "block_amount": "0.00",
        "card_token": "450620141926"
    }, {
        "account_num": "658704******3982",
        "account_name": "Test User",
        "currency": "EUR",
        "balance": "100000000.00",
        "available_balance": "100000000.00",
        "block_amount": "0.00",
        "card_token": "450620141926"
    }]
}
// The data in this example has already been decrypted.

400: invalid-signature

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}