Skip to main content
GET
TypeScript

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user 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.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-10-09-2"

Path Parameters

id
string
required

The dispute alert ID, prefixed dspa_.

Response

dispute alert returned

account_id
string | null
required

The account the alerted payment belongs to, prefixed biz_. null while the alert is unmatched.

Example:

"biz_xxxxxxxxxxxxxx"

amount
number
required

The alerted amount, in whole units of currency. This is what the issuer reported, which can differ from the payment's own amount.

Example:

25

auto_refunded
boolean
required

Whether Whop automatically refunded the alerted payment. Reflects the payment, so it can be true for a refund issued by another flow (RDR, resolution) on the same payment.

Example:

false

card_brand
string | null
required

The card network as reported by the issuer, lowercased, such as visa or mastercard. unknown when the report carries neither a network nor a recognizable BIN.

Example:

"visa"

created_at
string
required

When Whop received the alert, as an ISO 8601 timestamp.

Example:

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

currency
string
required

Three-letter ISO currency code of the alerted amount.

Example:

"usd"

fee
object | null
required

The alert fee charged to the account, in the currency it was collected in. null when fee_charged is false.

fee_charged
boolean
required

Whether Whop charged the account an alert fee for this one. Always false for early_fraud_warning, which Whop is not billed for and never passes on.

Example:

false

id
string
required

Dispute alert ID, prefixed dspa_.

Example:

"dspa_xxxxxxxxxxxxxx"

issuer
string | null
required
deprecated

Deprecated: always null outside Whop's own dashboard. Name of the bank that issued the card and filed the report. DEPRECATED: Always null outside Whop's own dashboard.

Example:

null

payment_id
string | null
required

The payment the issuer reported, prefixed pay_. null when Whop could not match the report to a payment.

Example:

"pay_xxxxxxxxxxxxxx"

product_id
string | null
required

The product the alerted payment was for, prefixed prod_.

Example:

"prod_xxxxxxxxxxxxxx"

reported_at
string
required

When the issuer filed the report, as an ISO 8601 timestamp. Earlier than created_at, which is when Whop received it.

Example:

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

transaction_at
string | null
required

When the reported transaction was made, as an ISO 8601 timestamp — falls back to when the matched payment was made if the issuer's own report didn't carry one. Should not be null in practice; treat one as a data issue rather than expected behavior.

Example:

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

type
enum<string>
required

What the issuer sent. early_fraud_warning is a fraud report on a settled payment (Visa TC40 / Mastercard SAFE) — refunding still avoids the chargeback, and Whop never charges a fee for one. dispute_alert is a pre-dispute notice from the issuer's alert network, which Whop pays for and passes on as a fee. rapid_dispute_resolution is a Visa RDR case the network already closed by refunding the payment — nothing is left to act on.

Available options:
early_fraud_warning,
dispute_alert,
rapid_dispute_resolution
Example:

"dispute_alert"

updated_at
string
required

When the alert was last changed, as an ISO 8601 timestamp.

Example:

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