Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
card-transaction

Get card transaction (V3)

{% admonition type="warning" %} This endpoint is deprecated. Use the V4 Get card transaction endpoint instead. {% /admonition %}

Retrieve a card transaction by its ID.

Use in conjunction with the V2.0.0 card transaction state change webhook.

When a refund happens, a separate transaction will be added with a REFUND transaction type.

get/v3/spend/profiles/{profileId}/cards/transactions/{transactionId}

Path parameters

profileIdinteger required

The ID of the profile that owns the card.

transactionIdstring required

The ID of the transaction.

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 transaction retrieved successfully.

idstring

ID of the transaction

cardTokenstring

Unique identifier of the card

type'ACCOUNT_CREDIT' | 'ACCOUNT_FUNDING' | 'CASH_ADVANCE' | 'CASH_WITHDRAWAL' | 'CHARGEBACK' | 'CREDIT_TRANSACTION' | 'ECOM_PURCHASE' | 'POS_PURCHASE' | 'REFUND'

Type of the transaction. One of:

  • ACCOUNT_CREDIT
  • ACCOUNT_FUNDING
  • CASH_ADVANCE
  • CASH_WITHDRAWAL
  • CHARGEBACK
  • CREDIT_TRANSACTION
  • ECOM_PURCHASE
  • POS_PURCHASE
  • REFUND
declineReasonstring nullable

Code of the decline reason if applicable

detailedDeclineReasonstring nullable

Code of the detailed decline reason if applicable

createdDatestring date-time

When the transaction was created

state'IN_PROGRESS' | 'COMPLETED' | 'DECLINED' | 'CANCELLED' | 'UNKNOWN'

The current state of the transaction. One of:

  • IN_PROGRESS
  • COMPLETED
  • DECLINED
  • CANCELLED
  • UNKNOWN
cardLastDigitsstring

Last 4 digits of the card

authorisationMethodstring

Authorisation method

balanceTransactionIdinteger nullable

Associated balance transaction ID if applicable

Example response

{
  "id": "342671",
  "cardToken": "59123122-223d-45f9-b840-0ad4a4f80937",
  "type": "ECOM_PURCHASE",
  "createdDate": "2022-11-28T08:17:54.241236Z",
  "state": "IN_PROGRESS",
  "cardLastDigits": "3086",
  "transactionAmount": {
    "amount": 1.5,
    "currency": "SGD"
  },
  "fees": [
    {
      "amount": 0.1,
      "currency": "SGD",
      "fee_type": "ATM_ACQUIRER"
    }
  ],
  "transactionAmountWithFees": {
    "value": 1.5,
    "currency": "SGD"
  },
  "merchant": {
    "name": "Test Payment",
    "location": {
      "country": "France",
      "city": "Rouen",
      "zipCode": "00000"
    },
    "category": {
      "name": "RMiscellaneousAndSpecial",
      "code": "5999",
      "description": "5999 R Miscellaneous and Special"
    }
  },
  "authorisationMethod": "MANUAL_ENTRY",
  "balanceTransactionId": 2598366,
  "debits": [
    {
      "balanceId": 52832,
      "debitedAmount": {
        "amount": 1.06,
        "currency": "EUR"
      },
      "forAmount": {
        "amount": 1.5,
        "currency": "SGD"
      },
      "rate": 1.43073,
      "fee": {
        "amount": 0.01,
        "currency": "EUR"
      }
    }
  ],
  "credit": {
    "balanceId": 52832,
    "creditedAmount": {
      "amount": 1.5,
      "currency": "SGD"
    }
  },
  "relayAuthorisationData": {
    "responseCode": "APPROVED",
    "fallback": true
  }
}