Access tokens1

Account links1

Accounts11

Ad Campaigns9

Ad Groups10

Ad reports1

Ads8

Affiliates10

Ai chats5

API Keys7

Api Logs1

App Builds4

Apps9

Audiences5

Authorized users4

Bounties7

Bounty Submissions5

Cards6

Chat channels3

Checkout Configurations4

Companies5

Company token transactions3

Confirmation Tokens2

Course chapters5

Course lesson interactions2

Course lessons8

Course students2

Courses5

Deposits1

Dispute alerts2

Disputes8

Dm channels5

Dm members5

Entries4

Events4

Experiences8

Exports3

Fee markups3

Files4

Forum posts4

Forums3

Identity profiles4

Invoices9

Leads4

Ledger accounts1

Ledgers3

Media2

Members3

Memberships12

Messages5

Notifications6

Partners6

Payment Method Domains5

Payment methods3

Payments10

Payout accounts1

Payout methods2

Payouts10

People2

Permissions1

Plans6

Products7

Promo Codes6

Reactions4

Recommended Actions4

Refunds2

Resolution Center Cases11

Reviews2

Setup intents3

Setup Intents2

Shipments4

Social Accounts6

Stats5

Support channels3

Swaps4

Team Members5

Topups1

Transfers4

Users18

Verifications4

Webhooks10

Webhooks

Accounts1

Ad Campaigns1

Cards13

Course lesson interactions1

Deposits1

Dispute alerts1

Disputes2

Entries4

Exports2

Invoices5

Ledger accounts1

Members1

Memberships4

Messages1

Payments6

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-08-25-2

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.

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"
}

Changes

Changed in 2 of the 41 revisions of this API.64112

Aug 12, 20266fb1c04bf25563112See the full diff
- ▲
  the created_at response's property type/format changed from string/date-time to string/ for status 200
  response-property-type-changed
- ▲
  removed the required property alert_type from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property charge_for_alert from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property dispute from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property payment from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property transaction_date from the response with the 200 status
  response-required-property-removed
- ●
  removed the optional property error/param from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property error/param from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property error/param from the response with the 404 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 400
  response-non-success-status-removed
- ○
  removed the non-success response with the status 422
  response-non-success-status-removed
- ○
  removed the non-success response with the status 429
  response-non-success-status-removed
- ○
  removed the non-success response with the status 500
  response-non-success-status-removed
- ○
  removed the aed enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the all enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the amd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ape enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ars enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the aud enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the awg enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the bam enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the bgn enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the bhd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the bob enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the brl enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the bsd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the btc enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the cad enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the chf enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the clp enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the cny enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the cop enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the crc enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the czk enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the dkk enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the dop enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the dzd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the egp enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the etb enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the eth enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the eur enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the gbp enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ghs enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the gmd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the gtq enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the gyd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the hkd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the huf enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the idr enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ils enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the inr enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the jmd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the jod enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the jpy enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the kes enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the khr enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the krw enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the kwd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the kzt enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the lkr enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mad enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mdl enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mga enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mkd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mnt enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mop enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mur enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the mxn enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the myr enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the nad enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ngn enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the nok enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the nzd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the omr enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the pen enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the php enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the pkr enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the pln enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the pyg enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the qar enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ron enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the rsd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the rub enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the rwf enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the sar enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the sek enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the sgd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the thb enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the tnd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the try enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ttd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the twd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the tzs enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the usd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the usdt enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the uyu enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the uzs enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the vnd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the whop_usd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the xau enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the xcd enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the xof enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the zar enum value from the currency response property for the response status 200
  response-property-enum-value-removed
- ○
  added the required property account_id to the response with the 200 status
  response-required-property-added
- ○
  added the required property actionable to the response with the 200 status
  response-required-property-added
- ○
  added the required property card_brand to the response with the 200 status
  response-required-property-added
- ○
  added the required property fee_charged to the response with the 200 status
  response-required-property-added
- ○
  added the required property issuer to the response with the 200 status
  response-required-property-added
- ○
  added the required property not_actionable_reason to the response with the 200 status
  response-required-property-added
- ○
  added the required property payment_id to the response with the 200 status
  response-required-property-added
- ○
  added the required property product_id to the response with the 200 status
  response-required-property-added
- ○
  added the required property reported_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property transaction_at to the response with the 200 status
  response-required-property-added
- ○
  added the required property type to the response with the 200 status
  response-required-property-added
- ○
  added the required property updated_at to the response with the 200 status
  response-required-property-added
Jul 26, 202660bbb4a6ffbc1See the full diff
- ●
  added the new bank_wire enum value to the payment/payment_method_type/oneOf[PaymentMethodTypes]/ response property for the response status 200
  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

Full history