Skip to main content
GET
Retrieve Dispute Alert

Authorizations

Authorization
string
header
required

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

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-08-10"

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.

actionable
boolean
required

Whether refunding the payment can still avoid a chargeback. false once the payment has been disputed or fully refunded, or when the alert could not be matched to a payment — not_actionable_reason says which.

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.

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.

created_at
string
required

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

currency
string
required

Three-letter ISO currency code of the alerted amount.

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.

id
string
required

Dispute alert ID, prefixed dspa_.

issuer
string | null
required

Name of the bank that issued the card and filed the report.

not_actionable_reason
enum<string> | null
required

Why refunding can no longer avoid a chargeback. network_resolved when a Visa RDR already closed the case, payment_unmatched when no payment matched, payment_not_captured when it never captured money, payment_disputed once the payment carries a dispute, payment_refunded once fully refunded. null while actionable is true.

Available options:
network_resolved,
payment_unmatched,
payment_not_captured,
payment_disputed,
payment_refunded,
null
Example:

"network_resolved"

payment_id
string | null
required

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

product_id
string | null
required

The product the alerted payment was for, prefixed prod_.

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.

transaction_at
string | null
required

When the reported transaction was made, as an ISO 8601 timestamp.

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:

"early_fraud_warning"

updated_at
string
required

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