Dispute - Whop Docs

{
	"access_activity_log": "192.168.1.1 - 2024-01-15 12:00:00 UTC",
	"amount": 6.9,
	"billing_address": "123 Main St, New York, NY 10001",
	"cancellation_policy_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"cancellation_policy_disclosure": "All sales are final. No refunds after 30 days.",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "<string>"
	},
	"created_at": "2023-12-01T05:00:00.401Z",
	"currency": "usd",
	"customer_communication_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"customer_email_address": "customer@example.com",
	"customer_name": "Jane Doe",
	"editable": true,
	"id": "dspt_xxxxxxxxxxxxx",
	"needs_response_by": "2023-12-01T05:00:00.401Z",
	"notes": "Customer used the product for 3 months before disputing.",
	"payment": {
		"billing_reason": "subscription_create",
		"card_brand": "mastercard",
		"card_last4": "4242",
		"created_at": "2023-12-01T05:00:00.401Z",
		"currency": "usd",
		"dispute_alerted_at": "2023-12-01T05:00:00.401Z",
		"id": "pay_xxxxxxxxxxxxxx",
		"member": {
			"id": "<string>",
			"phone": "<string>"
		},
		"membership": {
			"id": "mem_xxxxxxxxxxxxxx",
			"status": "trialing"
		},
		"paid_at": "2023-12-01T05:00:00.401Z",
		"payment_method_type": "acss_debit",
		"subtotal": 6.9,
		"total": 6.9,
		"usd_total": 6.9,
		"user": {
			"email": "john.doe@example.com",
			"id": "user_xxxxxxxxxxxxx",
			"name": "John Doe",
			"username": "johndoe42"
		}
	},
	"plan": {
		"id": "plan_xxxxxxxxxxxxx"
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Analytics"
	},
	"product_description": "Monthly subscription to premium analytics dashboard.",
	"reason": "Product Not Received",
	"refund_policy_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"refund_policy_disclosure": "Refunds available within 14 days of purchase.",
	"refund_refusal_explanation": "The customer exceeded the refund window by 60 days.",
	"service_date": "2024-01-15",
	"status": "warning_needs_response",
	"uncategorized_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"visa_rdr": true
}

{
	"access_activity_log": "192.168.1.1 - 2024-01-15 12:00:00 UTC",
	"amount": 6.9,
	"billing_address": "123 Main St, New York, NY 10001",
	"cancellation_policy_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"cancellation_policy_disclosure": "All sales are final. No refunds after 30 days.",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "<string>"
	},
	"created_at": "2023-12-01T05:00:00.401Z",
	"currency": "usd",
	"customer_communication_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"customer_email_address": "customer@example.com",
	"customer_name": "Jane Doe",
	"editable": true,
	"id": "dspt_xxxxxxxxxxxxx",
	"needs_response_by": "2023-12-01T05:00:00.401Z",
	"notes": "Customer used the product for 3 months before disputing.",
	"payment": {
		"billing_reason": "subscription_create",
		"card_brand": "mastercard",
		"card_last4": "4242",
		"created_at": "2023-12-01T05:00:00.401Z",
		"currency": "usd",
		"dispute_alerted_at": "2023-12-01T05:00:00.401Z",
		"id": "pay_xxxxxxxxxxxxxx",
		"member": {
			"id": "<string>",
			"phone": "<string>"
		},
		"membership": {
			"id": "mem_xxxxxxxxxxxxxx",
			"status": "trialing"
		},
		"paid_at": "2023-12-01T05:00:00.401Z",
		"payment_method_type": "acss_debit",
		"subtotal": 6.9,
		"total": 6.9,
		"usd_total": 6.9,
		"user": {
			"email": "john.doe@example.com",
			"id": "user_xxxxxxxxxxxxx",
			"name": "John Doe",
			"username": "johndoe42"
		}
	},
	"plan": {
		"id": "plan_xxxxxxxxxxxxx"
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Analytics"
	},
	"product_description": "Monthly subscription to premium analytics dashboard.",
	"reason": "Product Not Received",
	"refund_policy_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"refund_policy_disclosure": "Refunds available within 14 days of purchase.",
	"refund_refusal_explanation": "The customer exceeded the refund window by 60 days.",
	"service_date": "2024-01-15",
	"status": "warning_needs_response",
	"uncategorized_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"visa_rdr": true
}

access_activity_log

string | null

required

A log of IP-based access activity for the customer on Whop, submitted as evidence in the dispute.Example: 192.168.1.1 - 2024-01-15 12:00:00 UTC

amount

number

required

The disputed amount in the specified currency, formatted as a decimal.Example: 6.9

billing_address

string | null

required

The customer’s billing address from their payment details, submitted as evidence in the dispute.Example: 123 Main St, New York, NY 10001

cancellation_policy_attachment

object | null

required

The cancellation policy document uploaded as dispute evidence. Null if no cancellation policy has been provided.

Show child attributes

content_type

string | null

required

The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).Example: image/jpeg

filename

string | null

required

The original filename of the uploaded attachment, including its file extension.Example: document.pdf

string

required

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

url

string | null

required

A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps.Example: https://media.whop.com/abc123/optimized.jpg

cancellation_policy_disclosure

string | null

required

A text disclosure describing the company’s cancellation policy, submitted as dispute evidence.Example: All sales are final. No refunds after 30 days.

company

object | null

required

The company that the dispute was filed against.

Show child attributes

string

required

The unique identifier for the company.Example: biz_xxxxxxxxxxxxxx

title

string

required

The written name of the company.

created_at

string<date-time> | null

required

The datetime the dispute was created.Example: 2023-12-01T05:00:00.401Z

currency

Currencies

required

The three-letter ISO currency code for the disputed amount.Available options: 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, usdt, kzt, awg, whop_usd, xau

customer_communication_attachment

object | null

required

Evidence of customer communication or product usage, uploaded as a dispute attachment. Null if not provided.

Show child attributes

content_type

string | null

required

The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).Example: image/jpeg

filename

string | null

required

The original filename of the uploaded attachment, including its file extension.Example: document.pdf

string

required

url

string | null

required

A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps.Example: https://media.whop.com/abc123/optimized.jpg

customer_email_address

string | null

required

The customer’s email address from their payment details, included in the evidence packet sent to the payment processor. Editable before submission.Example: customer@example.com

customer_name

string | null

required

The customer’s full name from their payment details, included in the evidence packet sent to the payment processor. Editable before submission.Example: Jane Doe

editable

boolean | null

required

Whether the dispute evidence can still be edited and submitted.

string

required

The unique identifier for the dispute.Example: dspt_xxxxxxxxxxxxx

needs_response_by

string<date-time> | null

required

The deadline by which dispute evidence must be submitted. Null if no response deadline is set.Example: 2023-12-01T05:00:00.401Z

notes

string | null

required

Additional freeform notes submitted by the company as part of the dispute evidence.Example: Customer used the product for 3 months before disputing.

payment

object | null

required

The original payment that was disputed.

Show child attributes

billing_reason

BillingReasons | null

required

The machine-readable reason this charge was created, such as initial subscription purchase, renewal cycle, or one-time payment.Available options: subscription_create, subscription_cycle, subscription_update, one_time, manual, subscription

card_brand

CardBrands | null

required

Card network reported by the processor (e.g., ‘visa’, ‘mastercard’, ‘amex’). Present only when the payment method type is ‘card’.Available options: mastercard, visa, amex, discover, unionpay, jcb, diners, link, troy, visadankort, visabancontact, china_union_pay, rupay, jcbrupay, elo, maestro, tarjeta_naranja, cirrus, nspk_mir, verve, ebt, private_label, local_brand, uatp, wexcard, uzcard, meeza, hrg_store_card, girocard, fuel_card, dankort, carnet, atm_card, china_union_payuzcard, codensa, cabal, hipercard, jcblankapay, cmi, unknown

card_last4

string | null

required

The last four digits of the card used to make this payment. Null if the payment was not made with a card.Example: 4242

created_at

string<date-time>

required

The datetime the payment was created.Example: 2023-12-01T05:00:00.401Z

currency

Currencies

required

The three-letter ISO currency code for this payment (e.g., ‘usd’, ‘eur’).Available options: 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, usdt, kzt, awg, whop_usd, xau

dispute_alerted_at

string<date-time> | null

required

When an alert came in that this transaction will be disputedExample: 2023-12-01T05:00:00.401Z

string

required

The unique identifier for the payment.Example: pay_xxxxxxxxxxxxxx

member

object | null

required

The member attached to this payment.

Show child attributes

string

required

The unique identifier for the company member.

phone

string | null

required

The phone number for the member, if available.

membership

object | null

required

The membership attached to this payment.

Show child attributes

string

required

The unique identifier for the membership.Example: mem_xxxxxxxxxxxxxx

status

MembershipStatus

required

The state of the membership.Available options: trialing, active, past_due, completed, canceled, expired, unresolved, drafted, canceling

paid_at

string<date-time> | null

required

The time at which this payment was successfully collected. Null if the payment has not yet succeeded. As a Unix timestamp.Example: 2023-12-01T05:00:00.401Z

payment_method_type

PaymentMethodTypes | null

required

The type of payment instrument used for this payment (e.g., card, Cash App, iDEAL, Klarna, crypto). Null when the processor does not supply a type.Available options: acss_debit, affirm, afterpay_clearpay, alipay, alma, amazon_pay, apple, apple_pay, au_bank_transfer, au_becs_debit, bacs_debit, bancolombia, bancontact, billie, bizum, blik, boleto, bre_b, ca_bank_transfer, capchase_pay, card, card_installments_three, card_installments_six, card_installments_twelve, cashapp, claritypay, coinbase, crypto, custom, customer_balance, demo_pay, efecty, eps, eu_bank_transfer, fpx, gb_bank_transfer, giropay, google_pay, gopay, grabpay, id_bank_transfer, ideal, interac, kakao_pay, klarna, klarna_pay_now, konbini, kr_card, kr_market, kriya, kueski, link, mb_way, m_pesa, mercado_pago, mobilepay, mondu, multibanco, naver_pay, nequi, netbanking, ng_bank, ng_bank_transfer, ng_card, ng_market, ng_ussd, ng_wallet, nz_bank_account, oxxo, p24, pago_efectivo, pse, pay_by_bank, payco, paynow, paypal, paypay, payto, pix, platform_balance, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, scalapay, sencillito, sepa_debit, sequra, servipag, sezzle, shop_pay, shopeepay, sofort, south_korea_market, spei, splitit, sunbit, swish, tamara, twint, upi, us_bank_account, us_bank_transfer, venmo, vipps, webpay, wechat_pay, yape, zip, coinflow, unknown

subtotal

number | null

required

The subtotal to show to the creator (excluding buyer fees).Example: 6.9

total

number | null

required

The total to show to the creator (excluding buyer fees).Example: 6.9

usd_total

number | null

required

The total in USD to show to the creator (excluding buyer fees).Example: 6.9

user

object | null

required

The user that made this payment.

Show child attributes

string | null

required

The user’s email address. Requires the member:email:read permission to access. Null if not authorized.Example: john.doe@example.com

string

required

The unique identifier for the user.Example: user_xxxxxxxxxxxxx

name

string | null

required

The user’s display name shown on their public profile.Example: John Doe

username

string

required

The user’s unique username shown on their public profile.Example: johndoe42

plan

object | null

required

The plan associated with the disputed payment. Null if the dispute is not linked to a specific plan.

Show child attributes

string

required

The unique identifier for the plan.Example: plan_xxxxxxxxxxxxx

product

object | null

required

The product associated with the disputed payment. Null if the dispute is not linked to a specific product.

Show child attributes

string

required

The unique identifier for the product.Example: prod_xxxxxxxxxxxxx

title

string

required

The display name of the product shown to customers on the product page and in search results.Example: Pickaxe Analytics

product_description

string | null

required

A description of the product or service provided, submitted as dispute evidence.Example: Monthly subscription to premium analytics dashboard.

reason

string | null

required

A human-readable reason for the dispute.Example: Product Not Received

refund_policy_attachment

object | null

required

The refund policy document uploaded as dispute evidence. Null if no refund policy has been provided.

Show child attributes

content_type

string | null

required

The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).Example: image/jpeg

filename

string | null

required

The original filename of the uploaded attachment, including its file extension.Example: document.pdf

string

required

url

string | null

required

A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps.Example: https://media.whop.com/abc123/optimized.jpg

refund_policy_disclosure

string | null

required

A text disclosure describing the company’s refund policy, submitted as dispute evidence.Example: Refunds available within 14 days of purchase.

refund_refusal_explanation

string | null

required

An explanation from the company for why a refund was refused, submitted as dispute evidence.Example: The customer exceeded the refund window by 60 days.

service_date

string | null

required

The date when the product or service was delivered to the customer, submitted as dispute evidence.Example: 2024-01-15

status

DisputeStatuses

required

The current status of the dispute lifecycle, such as needs_response, under_review, won, or lost.Available options: warning_needs_response, warning_under_review, warning_closed, needs_response, under_review, won, lost, closed, other

uncategorized_attachment

object | null

required

An additional attachment that does not fit into the standard evidence categories. Null if not provided.

Show child attributes

content_type

string | null

required

The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).Example: image/jpeg

filename

string | null

required

The original filename of the uploaded attachment, including its file extension.Example: document.pdf

string

required

url

string | null

required

A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps.Example: https://media.whop.com/abc123/optimized.jpg

visa_rdr

boolean

required

Whether the dispute was automatically resolved through Visa Rapid Dispute Resolution (RDR).

Disputealert created

List disputes

⌘I