Skip to main content
GET
TypeScript

Autorizaciones

Authorization
string
header
requerido

An Account API key, an App API key, an account access token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

payout:account:read

Encabezados

Api-Version-Date
string

Pins the request to a dated API version.

Ejemplo:

"2026-11-17"

Parámetros de ruta

id
string
requerido

The card transaction ID, prefixed citx_.

Parámetros de consulta

account_id
string

The account that owns the transaction, prefixed biz_. Provide this or user_id. Defaults to the credential's account.

user_id
string

The user that owns the transaction, prefixed user_. Provide this or account_id. Only that user can read it.

Respuesta

card transaction found

card_id
string
requerido

The card this transaction was charged to, prefixed icrd_.

Ejemplo:

"icrd_xxxxxxxxxxxxxx"

cardholder_id
string | null
requerido

The user the card is assigned to, prefixed user_. Null when the card has no assigned cardholder.

Ejemplo:

"user_xxxxxxxxxxxxxx"

cashback_usd_amount
number | null
requerido

Cashback earned on this transaction as a USD amount. Zero for declined or ineligible transactions, and null when cashback has not been computed yet.

Ejemplo:

0.25

created_at
string
requerido

When the transaction was authorized, as an ISO 8601 timestamp.

Ejemplo:

"2026-01-01T12:00:00.000Z"

currency
string | null
requerido

ISO 4217 currency code the merchant charged in.

Ejemplo:

"EUR"

declined_reason
string | null
requerido

Why the transaction was declined. Null unless status is declined.

Ejemplo:

"account_credit_limit_exceeded"

id
string
requerido

Card transaction ID, prefixed citx_.

Ejemplo:

"citx_xxxxxxxxxxxxxx"

international
boolean
requerido

True when the merchant is outside the card's home country.

Ejemplo:

true

levels_points
number | null
requerido

Whop Levels points this transaction earned for the business. Negative for a refund that takes them back. For a pending transaction, the points it will earn once it settles. Null when it earns none, such as a declined transaction.

Ejemplo:

null

local_amount
number | null
requerido

Amount the merchant charged in their own currency. Pair with currency.

Ejemplo:

22.5

merchant_category
string | null
requerido

Merchant category label, enriched where available and otherwise as the card network reported it.

Ejemplo:

"Car Care Supplies"

merchant_category_code
string | null
requerido

Four-digit ISO 18245 merchant category code (MCC).

Ejemplo:

"5533"

merchant_icon_url
string | null
requerido

URL of the enriched merchant logo. Null when no logo was matched.

Ejemplo:

"https://shinetime.example/icons/lone-star-detail-supply.png"

merchant_name
string | null
requerido

Merchant name, enriched where available and otherwise as the card network reported it.

Ejemplo:

"Lone Star Detail Supply"

posted_at
string | null
requerido

When the card network settled the transaction, as an ISO 8601 timestamp. Null until it settles.

Ejemplo:

"2026-01-01T12:00:00.000Z"

status
enum<string>
requerido

Current status of the transaction.

Opciones disponibles:
pending,
completed,
reversed,
declined
Ejemplo:

"completed"

transaction_type
enum<string>
requerido

The kind of card transaction. Always spend today.

Opciones disponibles:
spend
Ejemplo:

"spend"

usd_amount
number | null
requerido

Amount charged in USD. Negative when the merchant refunded the card.

Ejemplo:

24.99