Submit evidence
Submit a payment dispute to the payment processor for review. Once submitted, no further edits can be made.
Required permissions:
- payment:dispute
- plan:basic:read
- access_pass:basic:read
- company:basic:read
- payment:basic:read
- member:email:read
- member:basic:read
- member:phone:read
Path parameters
The unique identifier of the dispute to submit to the payment processor for review.
Response
A successful response
Example response
{
"account_id": "biz_xxxxxxxxxxxxxx",
"amount": 150,
"buyer": {
"email": "marcus@shinetime.example",
"member_id": "mber_xxxxxxxxxxxxxx",
"name": "Dana Whitfield",
"user_id": "user_xxxxxxxxxxxxxx",
"username": "danawhitfield"
},
"created_at": "2026-01-01T12:00:00.000Z",
"currency": "usd",
"evidence": {
"access_activity_log": "Vehicle checked in 2026-01-04 09:02, released 2026-01-05 16:40. Signed release on file.",
"billing_address": "4180 Burnet Rd, Austin, TX 78756, US",
"cancellation_policy_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"cancellation_policy_disclosure": "Shown at checkout and again in the booking confirmation email.",
"customer_communication_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"customer_email_address": "marcus@shinetime.example",
"customer_name": "Dana Whitfield",
"documents": [
{
"content_type": "image/png",
"created_at": "2026-01-01T12:00:00.000Z",
"document_type": "customer_order_history",
"filename": "customer-order-history.png",
"id": "file_xxxxxxxxxxxxxx",
"multipart_upload_urls": [
{
"part_number": 1,
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/application.pdf"
}
],
"object": "file",
"size": 1024,
"upload_status": "ready",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"visibility": "public"
}
],
"notes": "Two-day ceramic coating completed and collected. Before and after photos attached.",
"product_description": "Two-stage paint correction with a three-year ceramic coating.",
"refund_policy_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"refund_policy_disclosure": "Linked from the booking page and accepted at checkout.",
"refund_refusal_explanation": "Work was completed and the vehicle collected, so the deposit is non-refundable.",
"service_date": "2026-01-01",
"uncategorized_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
},
"evidence_due_at": "2026-01-01T12:00:00.000Z",
"evidence_locked_reason": "submitted",
"evidence_submitted_at": "2026-01-01T12:00:00.000Z",
"generated_response_attachment": {
"content_type": "image/png",
"filename": "booking-confirmation-email.png",
"id": "file_xxxxxxxxxxxxxx",
"url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"id": "dspt_xxxxxxxxxxxxxx",
"issuer_comments": [
{
"received_at": "2026-01-01T12:00:00.000Z",
"text": "Note: Cardholder states the ceramic coating appointment never took place\nCancellation method: By phone"
}
],
"payment": {
"amount": 249,
"card_brand": "visa",
"card_last4": "4242",
"created_at": "2026-01-01T12:00:00.000Z",
"currency": "usd",
"id": "pay_xxxxxxxxxxxxxx",
"payment_instrument": {
"card": {
"brand": "visa",
"last4": "4242"
},
"display_name": "Visa •••• 4242",
"icons": {
"card": {
"dark": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
},
"light": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
}
},
"square": {
"dark": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
},
"light": {
"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
}
}
},
"payment_method_type": "card"
},
"payment_method_type": "card",
"payment_processor": "stripe"
},
"plan_id": "plan_xxxxxxxxxxxxxx",
"product_id": "prod_xxxxxxxxxxxxxx",
"reason": "other",
"reason_code": "13.1",
"status": "under_review",
"updated_at": "2026-01-01T12:00:00.000Z"
}Changes
Changed in 6 of the 41 revisions of this API.3812121
- ○
added the optional property
evidence/documents/items/multipart_chunk_sizeto the response with the200statusresponse-optional-property-added
- ○
added the optional property
evidence/documents/items/multipart_upload_idto the response with the200statusresponse-optional-property-added
- ○
added the optional property
evidence/documents/items/multipart_upload_urlsto the response with the200statusresponse-optional-property-added
- ○
added the optional property
evidence/documents/items/upload_headersto the response with the200statusresponse-optional-property-added
- ○
added the optional property
evidence/documents/items/upload_urlto the response with the200statusresponse-optional-property-added
- ○
added the required property
evidence/documents/items/created_atto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence/documents/items/objectto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence/documents/items/sizeto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence/documents/items/upload_statusto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence/documents/items/visibilityto the response with the200statusresponse-required-property-added
- ○
- ○
added the required property
evidence/documentsto the response with the200statusresponse-required-property-added
- ○
- ○
added the required property
generated_response_attachmentto the response with the200statusresponse-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
- ○
added the required property
payment/oneOf[DisputePayment]/payment_instrumentto the response with the200statusresponse-required-property-added
- ○
- ○
added the required property
issuer_commentsto the response with the200statusresponse-required-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
- ▲
added
DisputePaymentsubschema #2to thepaymentresponse propertyoneOflist for the response status200response-property-one-of-added
- ▲
the
created_atresponse's property type/format changed fromstringnull/date-timetostring/for status200response-property-type-changed
- ▲
the
paymentresponse's property type/format changed fromobjectnull/to/for status200response-property-type-changed
- ▲
removed the required property
access_activity_logfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
billing_addressfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
cancellation_policy_attachmentfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
cancellation_policy_disclosurefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
companyfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
customer_communication_attachmentfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
customer_email_addressfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
customer_namefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
editablefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
needs_response_byfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
notesfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/billing_reasonfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/card_brandfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/card_last4from the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/created_atfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/currencyfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/dispute_alerted_atfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/idfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/memberfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/membershipfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/paid_atfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/payment_method_typefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/subtotalfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/totalfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/usd_totalfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
payment/userfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
planfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
productfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
product_descriptionfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
refund_policy_attachmentfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
refund_policy_disclosurefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
refund_refusal_explanationfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
service_datefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
uncategorized_attachmentfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
visa_rdrfrom the response with the200statusresponse-required-property-removed
- ●
added the new
bank_cannot_processenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
credit_not_processedenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
declined_authorizationenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
documentation_requestenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
duplicateenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
fraudulentenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
otherenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
processing_errorenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
product_not_receivedenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
product_unacceptableenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
subscription_canceledenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ●
added the new
unrecognizedenum value to thereasonresponse property for the response status200response-property-enum-value-added
- ○
removed the
aedenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
allenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
amdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
apeenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
arsenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
audenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
awgenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
bamenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
bgnenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
bhdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
bobenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
brlenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
bsdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
btcenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
cadenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
chfenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
clpenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
cnyenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
copenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
crcenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
czkenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
dkkenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
dopenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
dzdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
egpenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
etbenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ethenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
eurenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
gbpenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ghsenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
gmdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
gtqenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
gydenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
hkdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
hufenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
idrenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ilsenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
inrenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
jmdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
jodenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
jpyenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
kesenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
khrenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
krwenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
kwdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
kztenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
lkrenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
madenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mdlenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mgaenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mkdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mntenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mopenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
murenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
mxnenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
myrenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
nadenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ngnenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
nokenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
nzdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
omrenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
otherenum value from thestatusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
penenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
phpenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
pkrenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
plnenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
pygenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
qarenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ronenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
rsdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
rubenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
rwfenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sarenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sekenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
sgdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
thbenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
tndenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
tryenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
ttdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
twdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
tzsenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
usdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
usdtenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
uyuenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
uzsenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
vndenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
warning_closedenum value from thestatusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
warning_needs_responseenum value from thestatusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
warning_under_reviewenum value from thestatusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
whop_usdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
xauenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
xcdenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
xofenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
removed the
zarenum value from thecurrencyresponse property for the response status200response-property-enum-value-removed
- ○
added the required property
account_idto the response with the200statusresponse-required-property-added
- ○
added the required property
buyerto the response with the200statusresponse-required-property-added
- ○
added the required property
evidenceto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence_due_atto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence_editableto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence_locked_reasonto the response with the200statusresponse-required-property-added
- ○
added the required property
evidence_submitted_atto the response with the200statusresponse-required-property-added
- ○
added the required property
inquiryto the response with the200statusresponse-required-property-added
- ○
added the required property
plan_idto the response with the200statusresponse-required-property-added
- ○
added the required property
product_idto the response with the200statusresponse-required-property-added
- ○
added the required property
rapid_dispute_resolutionto the response with the200statusresponse-required-property-added
- ○
added the required property
reason_codeto the response with the200statusresponse-required-property-added
- ○
added the required property
updated_atto the response with the200statusresponse-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ▲