Skip to main content
type separates fraud reports (early_fraud_warning), pre-dispute notices (dispute_alert), and Visa RDR cases the network already closed by refunding (rapid_dispute_resolution). Use the Dispute alerts API to list alerts for an account, filter them by type or payment, and read actionable to see whether refunding can still avoid the chargeback.

Endpoints

Attributes

string
required
Dispute alert ID, prefixed dspa_.
string | null
required
The account the alerted payment belongs to, prefixed biz_. null while the alert is unmatched.
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.
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.
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.
string | null
required
What the cardholder claims. fraud when they say they didn’t make the payment: always for an early_fraud_warning, and for Ethoca fraud alerts and Visa RDR cases filed under a fraud reason. customer_dispute when they made the payment but dispute it, such as a product not received or a canceled subscription. null when the alert carries no claim, such as an issuer’s request for transaction documents.Available options: fraud, customer_dispute
string
required
When Whop received the alert, as an ISO 8601 timestamp.
string
required
Three-letter ISO currency code of the alerted amount.
object | null
required
The alert fee charged to the account, in the currency it was collected in. null when fee_charged is false.

Properties

string
required
The amount in major units, as an exact decimal string. For example, "10.00" is ten dollars. It is a string so that no float rounds it in transit.
string
required
Three-letter ISO 4217 currency code, lowercase.
integer
required
How many decimal places the amount carries. This is the precision the charge itself runs at.
integer
required
How many decimal places to SHOW. Usually equal to decimals, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is 2 and 0. Format the number in your own locale using this.
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.
string | null
required
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.
string | null
required
The payment the issuer reported, prefixed pay_. null when Whop could not match the report to a payment.
string | null
required
The product the alerted payment was for, prefixed prod_.
string
required
When the issuer filed the report, as an ISO 8601 timestamp. Earlier than created_at, which is when Whop received it.
string | null
required
The network program that sent the alert, which type alone doesn’t tell apart. ethoca for Mastercard Ethoca, cdrn for Visa Verifi CDRN, rdr for Visa RDR, tc40 / safe for a Visa / Mastercard fraud report, paypal for a PayPal alert. null when the network didn’t say.Available options: ethoca, cdrn, rdr, tc40, safe, paypal
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.
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
string
required
When the alert was last changed, as an ISO 8601 timestamp.
DisputeAlert