Sign in
latestOpenAPI 3.1.02026-08-213914255.9 MB

715c4defcbbf

Dispute alerts

Retrieve Dispute Alert

Retrieves a single dispute alert or early fraud warning by ID.

get/dispute_alerts/{id}

Path parameters

idstring required

The dispute alert ID, prefixed dspa_.

Headers

Api-Version-Datestring
Example:2026-08-21

Pins the request to a dated API version.

Response

dispute alert returned

account_idstring nullable required

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

actionableboolean 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.

amountnumber 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_brandstring nullable 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_atstring required

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

currencystring required

Three-letter ISO currency code of the alerted amount.

fee_chargedboolean 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.

idstring required

Dispute alert ID, prefixed dspa_.

issuerstring nullable required

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

not_actionable_reason'network_resolved' | 'payment_unmatched' | 'payment_not_captured' | 'payment_disputed' | 'payment_refunded' | 'null' nullable 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.

payment_idstring nullable required

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

product_idstring nullable required

The product the alerted payment was for, prefixed prod_.

reported_atstring required

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

transaction_atstring nullable required

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

type'early_fraud_warning' | 'dispute_alert' | 'rapid_dispute_resolution' 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.

updated_atstring required

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

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "amount": 25,
  "card_brand": "visa",
  "created_at": "2026-01-01T12:00:00.000Z",
  "currency": "usd",
  "id": "dspa_xxxxxxxxxxxxxx",
  "not_actionable_reason": "network_resolved",
  "payment_id": "pay_xxxxxxxxxxxxxx",
  "product_id": "prod_xxxxxxxxxxxxxx",
  "reported_at": "2026-01-01T12:00:00.000Z",
  "transaction_at": "2026-01-01T12:00:00.000Z",
  "type": "rapid_dispute_resolution",
  "updated_at": "2026-01-01T12:00:00.000Z"
}