Access tokens1

Account links1

Accounts15

Ad Campaigns9

Ad Conversion Value Rules7

Ad Groups10

Ads8

Affiliates10

Ai chats5

API Keys7

Api Logs1

App Builds4

Apps8

Audiences5

Authorized users4

Bounties7

Bounty Submissions5

Cards6

Cashback Rules4

Chat channels3

Checkout Configurations4

Company token transactions3

Confirmation Tokens1

Course chapters5

Course lesson interactions2

Course lessons8

Course students2

Courses5

Deposits1

Dispute alerts2

Disputes6

Dm channels5

Dm members5

Domains5

Economic Intelligence2

Events4

Experiences8

Experiments8

Exports3

Fee markups3

Files4

Forum posts4

Forums3

Identity profiles4

Invoices9

Leads4

Ledger accounts1

Ledgers3

Media2

Members3

Memberships11

Messages5

Notifications6

Partner Referral Requests6

Partners7

Payment Method Domains5

Payment methods3

Payment Rules9

Payments12

Payout accounts1

Payout methods2

Payouts10

People2

Permissions1

Plans6

Products7

Promo Codes6

Reactions4

Refunds2

Resolution Center Cases11

Reviews2

Setup Intents6

Shipments4

Social Accounts7

Stats2

Support channels3

Swaps4

Team Members5

Topups1

Trades5

Transfers4

Users18

Verifications4

Waitlist Entries7

Webhooks9

Webhooks

Accounts3

Ad Campaigns2

Ads1

Cards13

Course lesson interactions1

Deposits1

Dispute alerts1

Disputes2

Entries4

Exports2

Invoices5

Ledger accounts1

Ledgers1

Members2

Memberships4

Messages1

Payments7

Payout accounts1

Payouts4

Plans3

Products5

Reactions1

Refunds2

Resolution Center Cases3

Setup Intents3

Shipments2

Swaps1

Transfers3

Verifications2

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-09-25

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.

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.

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

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

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.

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

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",
  "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": "dispute_alert",
  "updated_at": "2026-01-01T12:00:00.000Z"
}

Changes

Changed in 4 of the 74 revisions of this API.84114

Sep 25, 2026c1dceb26e5051See the full diff
- ○
  added the required property to the response with the status
  response-required-property-added
Sep 23, 2026140d015b996621See the full diff
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ○
  response property issuer deprecated
  response-property-deprecated
Aug 12, 20266fb1c04bf25563112See the full diff
- ▲
  the response's property format changed from date-time to no format for status
  response-property-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ○
  the security scope member:basic:read was removed from the endpoint's security scheme bearerAuth
  api-security-scope-removed
- ○
  the security scope member:email:read was removed from the endpoint's security scheme bearerAuth
  api-security-scope-removed
- ○
  the security scope member:phone:read was removed from the endpoint's security scheme bearerAuth
  api-security-scope-removed
- ○
  the security scope payment:basic:read was removed from the endpoint's security scheme bearerAuth
  api-security-scope-removed
- ○
  the security scope payment:dispute:read was removed from the endpoint's security scheme bearerAuth
  api-security-scope-removed
- ○
  added the new optional header request parameter Api-Version-Date
  new-optional-request-parameter
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the aed enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the all enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the amd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ape enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ars enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the aud enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the awg enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the bam enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the bgn enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the bhd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the bob enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the brl enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the bsd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the btc enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the cad enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the chf enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the clp enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the cny enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the cop enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the crc enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the czk enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the dkk enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the dop enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the dzd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the egp enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the etb enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the eth enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the eur enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the gbp enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ghs enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the gmd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the gtq enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the gyd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the hkd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the huf enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the idr enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ils enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the inr enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the jmd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the jod enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the jpy enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the kes enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the khr enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the krw enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the kwd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the kzt enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the lkr enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mad enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mdl enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mga enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mkd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mnt enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mop enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mur enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the mxn enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the myr enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the nad enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ngn enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the nok enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the nzd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the omr enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the pen enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the php enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the pkr enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the pln enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the pyg enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the qar enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ron enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rsd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rub enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rwf enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the sar enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the sek enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the sgd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the thb enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the tnd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the try enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ttd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the twd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the tzs enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the usd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the usdt enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the uyu enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the uzs enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the vnd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the whop_usd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the xau enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the xcd enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the xof enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the zar enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
Jul 26, 202660bbb4a6ffbc1See the full diff
- ●
  added the new bank_wire enum value to the ///// response property for the response status
  response-property-enum-value-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.

Full history