Query Authorizations

View authorization attempts (successful/failed) and settlement statuses.

Request URI

POST /issuing/card/query-card-authorizations

Request Body

Refer to : common

Biz_data :

Name	Type	Description
card_token	string	Card token
auth_id	string	Auth ID
data_type	string	Data Type
transaction_id	string	Transaction ID
transaction_type	integer	Transaction Type.Refer to: TransactionType
start_date*	string	Begin time.Format:yyyy-MM-dd HH:mm:ss
end_date*	string	End time.Format: yyyy-MM-dd HH:mm:ss
page_num	integer	Default value: 1
page_size	integer	Default value: 10. Max value is 30

max query time range : 31 days

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "request_id": "4CdbC1dD-EfbD-6ea8-941a-e9b32feC",
    "timestamp": "2025-04-07 13:56:56",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "card_token": 450620141926,
        "start_date": "2024-01-06 00:00:00",
        "end_date": "2024-09-20 00:00:00",
        "page_num": 1,
        "page_size": 30
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!

Response

Name	Type	Description
auth_id	string	Auth ID
data_type	string	Data Type(cardAuthorization、cardSettlement、cardAuthorizationExpired)
card_token	string	Card token
card_pan	string	Card PAN
transaction_id	string	Transaction ID
transaction_type	integer	Transaction type.Refer to: TransactionType
process_status	integer	Process Status.Refer to: ProcessStatus
original_auth_id	string	Original Auth ID
auth_status	integer	Auth status.Refer to:AuthStatus
auth_code	string	Auth Code
response_code	string	Response Code: responseCode
settle_status	integer	Settle Status.Refer to:SettleStatus
acquirer_id	string	Acquirer ID
mcc_code	string	Mcc Code
merchant_id	string	Merchant ID
merchant_name	string	Merchant Name
note	string	Note
transaction_amount	string	Transaction Amount
transaction_currency	string	Transaction Currency
transaction_country_code	string	Transaction country code
bill_amount	string	Billing Amount
bill_currency	string	Billing Currency
fee	string	Fee
settled_amount	string	Settled Amount
base_exchange_rate	string	Exchange Rate
create_time	string	Create time
card_remark	string	Card Remark

200:OK

{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": [{
        "auth_id": "100000000030",
        "data_type": "cardAuthorization",
        "card_pan": null,
        "card_token": "450620141926",
        "transaction_id": null,
        "transaction_type": 2,
        "process_status": 1,
        "original_auth_id": null,
        "auth_status": null,
        "auth_code": "915119",
        "response_code": null,
        "settle_status": null,
        "acquirer_id": "00000361603",
        "mcc_code": null,
        "merchant_id": "1715679487057813",
        "merchant_name": "Test User",
        "note": null,
        "transaction_amount": "-100000.00",
        "transaction_currency": "USD",
        "transaction_country_code": null,
        "bill_amount": "-100000.00",
        "bill_currency": "USD",
        "fee": "0.00",
        "settled_amount": "0.00",
        "base_exchange_rate": null,
        "create_time": "2024-09-12 03:52:28"
    }]
}
// 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"
}