Skip to main content
GET
TypeScript

Yetkilendirmeler

Authorization
string
header
gerekli

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

Başlıklar

Api-Version-Date
string

Pins the request to a dated API version.

Örnek:

"2026-11-17"

Yol Parametreleri

id
string
gerekli

The card transaction ID, prefixed citx_.

Sorgu Parametreleri

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.

Yanıt

card transaction found

card_id
string
gerekli

The card this transaction was charged to, prefixed icrd_.

Örnek:

"icrd_xxxxxxxxxxxxxx"

cardholder_id
string | null
gerekli

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

Örnek:

"user_xxxxxxxxxxxxxx"

cashback_usd_amount
number | null
gerekli

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

Örnek:

0.25

created_at
string
gerekli

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

Örnek:

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

currency
string | null
gerekli

ISO 4217 currency code the merchant charged in.

Örnek:

"EUR"

declined_reason
string | null
gerekli

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

Örnek:

"account_credit_limit_exceeded"

id
string
gerekli

Card transaction ID, prefixed citx_.

Örnek:

"citx_xxxxxxxxxxxxxx"

international
boolean
gerekli

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

Örnek:

true

levels_points
number | null
gerekli

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.

Örnek:

null

local_amount
number | null
gerekli

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

Örnek:

22.5

merchant_category
string | null
gerekli

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

Örnek:

"Car Care Supplies"

merchant_category_code
string | null
gerekli

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

Örnek:

"5533"

merchant_icon_url
string | null
gerekli

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

Örnek:

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

merchant_name
string | null
gerekli

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

Örnek:

"Lone Star Detail Supply"

posted_at
string | null
gerekli

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

Örnek:

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

status
enum<string>
gerekli

Current status of the transaction.

Mevcut seçenekler:
pending,
completed,
reversed,
declined
Örnek:

"completed"

transaction_type
enum<string>
gerekli

The kind of card transaction. Always spend today.

Mevcut seçenekler:
spend
Örnek:

"spend"

usd_amount
number | null
gerekli

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

Örnek:

24.99