Skip to main content
GET
TypeScript

인증

Authorization
string
header
필수

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

payment:dispute_alert:read

헤더

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

경로 매개변수

id
string
필수

The dispute alert ID, prefixed dspa_.

응답

dispute alert returned

account_id
string | null
필수

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

예시:

"biz_xxxxxxxxxxxxxx"

amount
number
필수

The alerted amount, in whole units of currency. This is what the issuer reported, which can differ from the payment's own amount.

예시:

25

auto_refunded
boolean
필수

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.

예시:

false

card_brand
string | null
필수

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.

예시:

"visa"

category
enum<string> | null
필수

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.

사용 가능한 옵션:
fraud,
customer_dispute,
null
예시:

"fraud"

created_at
string
필수

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

예시:

"2026-01-01T12:00:00.000Z"

currency
string
필수

Three-letter ISO currency code of the alerted amount.

예시:

"usd"

fee
object | null
필수

The alert fee charged to the account, in the currency it was collected in. null when fee_charged is false.

fee_charged
boolean
필수

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.

예시:

false

id
string
필수

Dispute alert ID, prefixed dspa_.

예시:

"dspa_xxxxxxxxxxxxxx"

issuer
string | null
필수
지원 중단

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.

예시:

null

payment_id
string | null
필수

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

예시:

"pay_xxxxxxxxxxxxxx"

product_id
string | null
필수

The product the alerted payment was for, prefixed prod_.

예시:

"prod_xxxxxxxxxxxxxx"

reported_at
string
필수

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

예시:

"2026-01-01T12:00:00.000Z"

source
enum<string> | null
필수

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.

사용 가능한 옵션:
ethoca,
cdrn,
rdr,
tc40,
safe,
paypal,
null
예시:

"tc40"

transaction_at
string | null
필수

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.

예시:

"2026-01-01T12:00:00.000Z"

type
enum<string>
필수

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.

사용 가능한 옵션:
early_fraud_warning,
dispute_alert,
rapid_dispute_resolution
예시:

"early_fraud_warning"

updated_at
string
필수

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

예시:

"2026-01-01T12:00:00.000Z"