API For Querying Order History

Description

Query Order History

Request URL

/open/api/card/trade/list

Request Method

POST

Request Parameter

ParameterMandatoryTypeDescription
cardIdYstringVirtual Card ID
currentYintegerCurrent page
sizeYintegerNumber of queries

Request Example

{
    "cardId": "c_xxxxxxxxxxx",
     "current": 1,
     "size":10
}

Response Parameter

ParameterTypeDescription
+recordsarrayList
└transactionIdstringCard transaction ID
└cardIdstringCard ID
└cardSeqNostringCard Serial Number
└cardLast4stringThe last four digits of the card number
└despstringDescription of transaction(including purchase information)
Example: TIKTOK ADS, GOOGLE *MBC Group, aliexpress
└reasonstringFail reason
└amountintegerConsumption amount
└currencystringConsumption amount currency
└statusstringTransaction status
PENDING: Transaction authorization PENDING
EXPIRED: Authorization expired
REVERSED: Authorization returned (for example, card-bound withholding refund)
DECLINED: Payment refused
COMPLETE: Transaction completed
REFUND: Transaction refund
FEE: transaction fee
MONTHLY_FEE: monthly fee(Only for monthly fee cards)
└tradeAtstringTrade time
integerintegerNumber of record elements
totalintegerTotal number
currentintegerCurrent page

Response Example

 {
    "success": true,
    "error":false,
    "msg": "成功",
    "code": 0,
    "model": {
        "records": [
            {
                "transactionId": "t_xxxxx",
                "cardId": "c_xxxxxxxxxx",
                "cardSeqNo": "CXXXXXXXX",
                "cardLast4": "9352",
                "desp": "Fake Transaction in Sandbox Mode(-$200.00)",
                "reason": "balance not enough",
                "amount": -20000,
                "currency": "USD",
                "status": "DECLINED",
                "tradeAt": 1646306072727
            },
            {
                "transactionId": "t_xxxxx",
                "cardId": "c_xxxxxxxxxx",
                "cardSeqNo": "CXXXXXXXX",
                "cardLast4": "9352",
                "desp": "Fake Transaction in Sandbox Mode(-$1.00)",
                "reason": null,
                "amount": -100,
                "currency": "USD",
                "status": "PENDING",
                "tradeAt": 1646392472727
            },
            {
                "transactionId": "t_xxxxx",
                "cardId": "c_xxxxxxxxxx",
                "cardSeqNo": "CXXXXXXXX",
                "cardLast4": "9352",
                "desp": "Fake Transaction in Sandbox Mode(-$100.00)",
                "reason": null,
                "amount": -10000,
                "currency": "USD",
                "status": "COMPLETE",
                "tradeAt": 1646392472727
            },
            {
                "transactionId": "t_xxxxx",
                "cardId": "c_xxxxxxxxxx",
                "cardSeqNo": "CXXXXXXXX",
                "cardLast4": "9352",
                "desp": "Fake Transaction in Sandbox Mode($100.00)",
                "reason": null,
                "amount": 5000,
                "currency": "USD",
                "status": "REFUND",
                "tradeAt": 1646478872727
            }
        ],
        "size": 3,
        "total": 3,
        "current": 1
    },
    "traceId": 1646651672727
}