Listing Card Transactions

This section provides instructions on how you can retrieve transactions from a specific time range for a given card. This can be useful in generating card statements for your customers.

Listing Card Transactions

Step 1: Retrieve card details

Identify the corresponding Public Token for the card to be used.
A card's public token is returned in the response to creating a card within the publicToken object.

Step 2: Retrieve card transactions

After identifying the public token for the card, you can list the transactions linked to the card using the List card transaction(s) endpoint. You can define the start and end date period over which to return transactions by using the dateFrom and dateTo headers to define the date range you want returned from the API. See the below example that will return transactions between the 1st January 2021 and the 31st December 2022.

{{base-url}}/cards/{{publicToken}}/transactions?fromDate=20210101&toDate=20221231

If successful, a 200 response will be returned with details of the transactions between the dates specified. See below for an example response:

[
    {
        "id": 6156362505,
        "description": "Unload",
        "dateTime": "2023-02-23T10:33:38.337Z",
        "lifeCycleId": null,
        "type": {
            "code": "U",
            "description": "Unload"
        },
        "status": {
            "code": "S",
            "description": "Settled"
        },
        "amount": {
            "billingValue": 10.00,
            "billingCurrency": "GBP",
            "transactionValue": 10.0000,
            "transactionCurrency": "GBP"
        },
        "fees": {
            "id": 0,
            "fixedFee": 0.00,
            "rateFee": 0.00,
            "fxPadding": 0.00,
            "mccPadding": 0.00
        },
        "productId": 10005,
        "cardNetwork": "VISA",
        "processingCode": "230000",
        "recordId": 0,
        "note": "API Load by ",
        "systemTraceAuditNumber": 0,
        "transactionCountry": "GBR",
        "transactionLink": 6156362505,
        "additionalDetail": null
    },
    {
        "id": 6156362474,
        "description": "string",
        "dateTime": "2023-02-23T10:14:08.13Z",
        "lifeCycleId": null,
        "type": {
            "code": "L",
            "description": "Load"
        },
        "status": {
            "code": "S",
            "description": "Settled"
        },
        "amount": {
            "billingValue": 1000.00,
            "billingCurrency": "GBP",
            "transactionValue": 1000.0000,
            "transactionCurrency": "GBP"
        },
        "fees": {
            "id": 0,
            "fixedFee": 0.00,
            "rateFee": 0.00,
            "fxPadding": 0.00,
            "mccPadding": 0.00
        },
        "productId": 10005,
        "cardNetwork": "VISA",
        "processingCode": "220000",
        "recordId": 0,
        "note": "API Load by ",
        "systemTraceAuditNumber": 0,
        "transactionCountry": "GBR",
        "transactionLink": 6156362474,
        "additionalDetail": null
    },
    {
        "id": 6156362473,
        "description": "Description",
        "dateTime": "2023-02-23T10:13:33.533Z",
        "lifeCycleId": null,
        "type": {
            "code": "B",
            "description": "Balance Adjustment"
        },
        "status": {
            "code": "S",
            "description": "Settled"
        },
        "amount": {
            "billingValue": 500.00,
            "billingCurrency": "GBP",
            "transactionValue": 500.0000,
            "transactionCurrency": "GBP"
        },
        "fees": {
            "id": 0,
            "fixedFee": 0.00,
            "rateFee": 0.00,
            "fxPadding": 0.00,
            "mccPadding": 0.00
        },
        "productId": 10005,
        "cardNetwork": "VISA",
        "processingCode": "021000",
        "recordId": 0,
        "note": "API Load by ",
        "systemTraceAuditNumber": 0,
        "transactionCountry": "GBR",
        "transactionLink": 6156362473,
        "additionalDetail": null
    }
]

👍

API Explorer

See the List card transaction(s) endpoint.