v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

card-transaction

List card transactions

Retrieve a list of card transactions for a specific card. Transactions are ordered by transaction ID in descending order.

Use in conjunction with the card transaction state change webhook for versions V2.1.0 and later.

{% admonition type="warning" %} Only transactions created in the past 90 days can be accessed. A 422 error code will be returned otherwise. {% /admonition %}

The debits and credits fields are not included in list responses. Use the Get card transaction endpoint to retrieve these fields.

get/v4/spend/profiles/{profileId}/cards/{cardToken}/transactions

Path parameters

profileIdinteger required

The ID of the profile that owns the card.

cardTokenstring uuid required

The unique token identifying the card.

Query parameters

fromCreationTimestring date-time required

Start of range for transaction creation time in UTC, in ISO-8601 format.

toCreationTimestring date-time required

End of range for transaction creation time in UTC, in ISO-8601 format.

pageSizeinteger

Page size of query between 10 and 100 inclusive, defaults to 20.

lastIdinteger

A pagination cursor that marks your position in the list. Include the ID of the last transaction from the previous page to retrieve the next page (transactions with IDs less than the provided value).

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Response

Card transactions retrieved successfully.

Example response

{
  "transactions": [
    {
      "id": 342671,
      "cardToken": "59123122-223d-45f9-b840-0ad4a4f80937",
      "type": "ECOM_PURCHASE",
      "state": "IN_PROGRESS",
      "creationTime": "2022-11-28T08:17:54.241Z",
      "modificationTime": "2022-11-28T08:17:54.241Z",
      "purgeTime": "2022-11-28T08:17:54.241Z",
      "transactionAmount": {
        "amount": 1.4,
        "currency": "SGD"
      },
      "fees": [
        {
          "amount": 0.1,
          "currency": "SGD",
          "fee_type": "ATM_ACQUIRER"
        }
      ],
      "transactionAmountWithFees": {
        "amount": 1.5,
        "currency": "SGD"
      },
      "merchant": {
        "name": "Test Payment",
        "location": {
          "country": "France",
          "city": "Rouen",
          "zipCode": "00000"
        },
        "category": {
          "name": "MISCELLANEOUS_FOOD_STORES_CONVEN",
          "code": "5999",
          "description": "5999 R Miscellaneous and Special"
        }
      },
      "authorisationMethod": "MANUAL_ENTRY",
      "approvalCode": "913647",
      "billingAmount": {
        "amount": 1.1,
        "currency": "EUR"
      },
      "arn": "04300014127798385983852",
      "pinValidationResult": "ONLINE_PIN_VALIDATED",
      "balanceChannelReferenceId": "6e71018d-2f4d-4fc3-6711-f517f4664712",
      "debits": [
        {
          "balanceId": 52832,
          "debitedAmount": {
            "amount": 1.1,
            "currency": "EUR"
          },
          "forAmount": {
            "amount": 1.5,
            "currency": "SGD"
          },
          "rate": 1.36363636364,
          "fee": {
            "amount": 0.04,
            "currency": "EUR"
          },
          "creationTime": "2022-11-28T08:17:54.241Z"
        }
      ],
      "credits": [
        {
          "balanceId": 52832,
          "creditedAmount": {
            "amount": 1.5,
            "currency": "SGD"
          },
          "creationTime": "2022-11-28T08:17:54.241Z"
        }
      ],
      "relayAuthorisationData": {
        "responseCode": "APPROVED",
        "fallback": true
      }
    }
  ]
}