Skip to main content
GET
Retrieve card transaction
This page documents the Legacy API. For new integrations, use Retrieve Card Transaction in the Current API.
Required permissions:
  • payout:account:read

Autorisaties

Authorization
string
header
vereist

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Scopes

payout:account:read

Padparameters

id
string
vereist

The card transaction ID (citx_xxx).

Respons

A successful response

A card transaction record.

authorization_method
string | null
vereist

How the card was presented or authenticated for the purchase.

Voorbeeld:

"ecommerce"

card_id
string
vereist

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

cashback_usd_amount
number | null
vereist

The cashback reward amount earned on this transaction, in USD.

Voorbeeld:

6.9

created_at
string<date-time>
vereist

The datetime the card transaction was created.

Voorbeeld:

"2023-12-01T05:00:00.401Z"

currency
string | null
vereist

The ISO 4217 currency code for the transaction amount.

Voorbeeld:

"USD"

declined_reason
string | null
vereist

The issuer-provided reason the transaction was declined.

Voorbeeld:

"insufficient_funds"

id
string
vereist

The unique identifier for the card transaction.

international
boolean
vereist

Whether the transaction was made with a merchant outside the card's home country.

local_amount
number | null
vereist

The transaction amount in the merchant's local currency before conversion.

Voorbeeld:

6.9

memo
string | null
vereist

A user-provided note attached to the transaction.

Voorbeeld:

"Team dinner"

merchant_category
string | null
vereist

The enriched or raw category label for the merchant.

Voorbeeld:

"Software"

merchant_category_code
string | null
vereist

The four-digit ISO 18245 merchant category code (MCC).

Voorbeeld:

"5734"

merchant_icon_url
string | null
vereist

A URL to the enriched merchant logo image.

Voorbeeld:

"https://logo.clearbit.com/example.com"

merchant_name
string | null
vereist

The enriched or raw name of the merchant where the purchase was made.

Voorbeeld:

"Acme Corporation"

posted_at
string<date-time> | null
vereist

When the transaction was settled by the card network.

Voorbeeld:

"2023-12-01T05:00:00.401Z"

status
enum<string>
vereist

The current lifecycle status of the transaction.

Beschikbare opties:
pending,
completed,
reversed,
declined
transaction_type
string
vereist

The type of transaction.

Voorbeeld:

"spend"

usd_amount
number | null
vereist

The transaction amount in USD.

Voorbeeld:

6.9