Introduction
Payins
Payouts
Identity
CRM
Engagement
Courses
Developer
Dispute created
Sent when a dispute is created
Required permissions:
payment:dispute:readplan:basic:readaccess_pass:basic:readcompany:basic:readpayment:basic:readmember:email:readmember:basic:readmember:phone:readwebhook_receive:disputes
Headers
The signature of the webhook request with the webhook version prepended
"v1,BASE64ENCODEDSIGNATURE"
The timestamp in seconds since the Unix epoch that the webhook was sent at on the server
"1727606400"
Body
A unique ID for every single webhook request
"msg_xxxxxxxxxxxxxxxxxxxxxxxx"
The API version for this webhook
"v1""v1"
The timestamp in ISO 8601 format that the webhook was sent at on the server
"2025-01-01T00:00:00.000Z"
The webhook event type
"dispute.created""dispute.created"
An object representing a dispute against a company.
Show child attributes
Show child attributes
The internal ID of the dispute.
"dspt_xxxxxxxxxxxxx"
The amount of the dispute (formatted).
6.9
The currency of the dispute.
usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, eth, ape, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, btc, cny The status of the dispute (mimics stripe's dispute status).
warning_needs_response, warning_under_review, warning_closed, needs_response, under_review, won, lost, closed, other Whether or not the dispute data can be edited.
When it was made.
"2023-12-01T05:00:00.401Z"
Whether or not the dispute is a Visa Rapid Dispute Resolution.
The last date the dispute is allow to be submitted by.
"2023-12-01T05:00:00.401Z"
The reason for the dispute
The payment that got disputed
Show child attributes
Show child attributes
The payment ID
"pay_xxxxxxxxxxxxxx"
The total to show to the creator (excluding buyer fees).
6.9
The subtotal to show to the creator (excluding buyer fees).
6.9
The total in USD to show to the creator (excluding buyer fees).
6.9
The currency of the payment.
usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, eth, ape, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, btc, cny The datetime the payment was created
"2023-12-01T05:00:00.401Z"
The datetime the payment was paid
"2023-12-01T05:00:00.401Z"
When an alert came in that this transaction will be disputed
"2023-12-01T05:00:00.401Z"
Machine-readable identifier for the payment method used on the payment. Examples include card, cashapp ..., local methods such as ideal, sofort, ... BNPL options like klarna, affirm, ..., or crypto. Returns null when the processor does not supply a type.
acss_debit, affirm, afterpay_clearpay, alipay, alma, amazon_pay, apple_pay, au_becs_debit, bacs_debit, bancontact, billie, blik, boleto, card, cashapp, crypto, eps, fpx, giropay, google_pay, grabpay, ideal, kakao_pay, klarna, konbini, kr_card, link, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, pix, promptpay, revolut_pay, samsung_pay, satispay, sepa_debit, sofort, swish, twint, us_bank_account, wechat_pay, zip, bizum, capchase_pay, kriya, mondu, ng_wallet, paypay, sequra, scalapay, vipps, custom, customer_balance, gopay, mb_way, ng_bank, ng_bank_transfer, ng_card, ng_market, ng_ussd, paypal, payto, qris, rechnung, south_korea_market, kr_market, shopeepay, upi, sunbit, netbanking, id_bank_transfer, demo_pay, shop_pay, sezzle, coinbase, splitit, platform_balance, apple, venmo, unknown The reason for the charge.
subscription_create, subscription_cycle, subscription_update, one_time, manual, subscription Card network reported by the processor (for example visa, mastercard, amex). Present only when the underlying payment method type is card.
mastercard, visa, amex, discover, unionpay, jcb, diners, link, troy, visadankort, visabancontact, china_union_pay, rupay, jcbrupay, elo, maestro, unknown The last 4 digits of the card used to make the payment.
The user that made this payment.
Show child attributes
Show child attributes
The internal ID of the user.
"user_xxxxxxxxxxxxx"
The name of the user from their Whop account.
"John Doe"
The username of the user from their Whop account.
"johndoe42"
The email of the user
The membership attached to this payment.
An IP access log for the user from Whop.
The billing address of the user from their payment details.
A cancellation policy disclosure from the company.
The email of the customer from their payment details. This is submitted in the evidence packet to the payment processor. You can change it before submitting the dispute.
The name of the customer from their payment details. This is submitted in the evidence packet to the payment processor. You can change it before submitting the dispute.
Additional notes the company chooses to submit regarding the dispute.
The description of the product from the company.
A refund policy disclosure from the company.
A description on why the refund is being refused by the company.
When the product was delivered by the company.
The cancellation policy for this dispute
Show child attributes
Show child attributes
The ID of the attachment
The name of the file
The attachment's content type (e.g., image/jpg, video/mp4)
This is the URL you use to render optimized attachments on the client. This should be used for apps.
The customer communication for this dispute
Show child attributes
Show child attributes
The ID of the attachment
The name of the file
The attachment's content type (e.g., image/jpg, video/mp4)
This is the URL you use to render optimized attachments on the client. This should be used for apps.
The refund policy for this dispute
Show child attributes
Show child attributes
The ID of the attachment
The name of the file
The attachment's content type (e.g., image/jpg, video/mp4)
This is the URL you use to render optimized attachments on the client. This should be used for apps.
An attachment that did not fit into the other categories
Show child attributes
Show child attributes
The ID of the attachment
The name of the file
The attachment's content type (e.g., image/jpg, video/mp4)
This is the URL you use to render optimized attachments on the client. This should be used for apps.
Response
Return a 200 status to indicate that the data was received successfully
Was this page helpful?