Dispute alerts

Retrieve Dispute Alert

Changed on

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

get/dispute_alerts/{id}

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/dispute_alerts/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The dispute alert ID, prefixed dspa_.

Headers

Api-Version-Datestring
Example:2026-10-15

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",
  "fee": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "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