{
"id": "msg_xxxxxxxxxxxxxxxxxxxxxxxx",
"api_version": "v1",
"timestamp": "2025-01-01T00:00:00.000Z",
"type": "dispute.created",
"data": {
"id": "dspt_xxxxxxxxxxxxx",
"amount": 6.9,
"currency": "usd",
"status": "warning_needs_response",
"editable": true,
"created_at": "2023-12-01T05:00:00.401Z",
"visa_rdr": true,
"needs_response_by": "2023-12-01T05:00:00.401Z",
"reason": "Product Not Received",
"plan": {
"id": "plan_xxxxxxxxxxxxx"
},
"product": {
"id": "prod_xxxxxxxxxxxxx",
"title": "Pickaxe Analytics"
},
"company": {
"id": "biz_xxxxxxxxxxxxxx",
"title": "<string>"
},
"payment": {
"id": "pay_xxxxxxxxxxxxxx",
"total": 6.9,
"subtotal": 6.9,
"usd_total": 6.9,
"currency": "usd",
"created_at": "2023-12-01T05:00:00.401Z",
"paid_at": "2023-12-01T05:00:00.401Z",
"dispute_alerted_at": "2023-12-01T05:00:00.401Z",
"payment_method_type": "acss_debit",
"billing_reason": "subscription_create",
"card_brand": "mastercard",
"card_last4": "4242",
"user": {
"id": "user_xxxxxxxxxxxxx",
"name": "John Doe",
"username": "johndoe42",
"email": "john.doe@example.com"
},
"member": {
"id": "<string>",
"phone": "<string>"
},
"membership": {
"id": "mem_xxxxxxxxxxxxxx",
"status": "trialing"
}
},
"access_activity_log": "192.168.1.1 - 2024-01-15 12:00:00 UTC",
"billing_address": "123 Main St, New York, NY 10001",
"cancellation_policy_disclosure": "All sales are final. No refunds after 30 days.",
"customer_email_address": "customer@example.com",
"customer_name": "Jane Doe",
"notes": "Customer used the product for 3 months before disputing.",
"product_description": "Monthly subscription to premium analytics dashboard.",
"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",
"cancellation_policy_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
},
"customer_communication_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
},
"refund_policy_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
},
"uncategorized_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
}
},
"company_id": "biz_xxxxxxxxxxxxxx"
}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{
"id": "msg_xxxxxxxxxxxxxxxxxxxxxxxx",
"api_version": "v1",
"timestamp": "2025-01-01T00:00:00.000Z",
"type": "dispute.created",
"data": {
"id": "dspt_xxxxxxxxxxxxx",
"amount": 6.9,
"currency": "usd",
"status": "warning_needs_response",
"editable": true,
"created_at": "2023-12-01T05:00:00.401Z",
"visa_rdr": true,
"needs_response_by": "2023-12-01T05:00:00.401Z",
"reason": "Product Not Received",
"plan": {
"id": "plan_xxxxxxxxxxxxx"
},
"product": {
"id": "prod_xxxxxxxxxxxxx",
"title": "Pickaxe Analytics"
},
"company": {
"id": "biz_xxxxxxxxxxxxxx",
"title": "<string>"
},
"payment": {
"id": "pay_xxxxxxxxxxxxxx",
"total": 6.9,
"subtotal": 6.9,
"usd_total": 6.9,
"currency": "usd",
"created_at": "2023-12-01T05:00:00.401Z",
"paid_at": "2023-12-01T05:00:00.401Z",
"dispute_alerted_at": "2023-12-01T05:00:00.401Z",
"payment_method_type": "acss_debit",
"billing_reason": "subscription_create",
"card_brand": "mastercard",
"card_last4": "4242",
"user": {
"id": "user_xxxxxxxxxxxxx",
"name": "John Doe",
"username": "johndoe42",
"email": "john.doe@example.com"
},
"member": {
"id": "<string>",
"phone": "<string>"
},
"membership": {
"id": "mem_xxxxxxxxxxxxxx",
"status": "trialing"
}
},
"access_activity_log": "192.168.1.1 - 2024-01-15 12:00:00 UTC",
"billing_address": "123 Main St, New York, NY 10001",
"cancellation_policy_disclosure": "All sales are final. No refunds after 30 days.",
"customer_email_address": "customer@example.com",
"customer_name": "Jane Doe",
"notes": "Customer used the product for 3 months before disputing.",
"product_description": "Monthly subscription to premium analytics dashboard.",
"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",
"cancellation_policy_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
},
"customer_communication_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
},
"refund_policy_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
},
"uncategorized_attachment": {
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
}
},
"company_id": "biz_xxxxxxxxxxxxxx"
}A unique identifier for this webhook request
"msg_xxxxxxxxxxxxxxxxxxxxxxxx"
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"
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"
A dispute is a chargeback or payment challenge filed against a company, including evidence and response status.
Show child attributes
The company ID that this webhook event is associated with
"biz_xxxxxxxxxxxxxx"
Return a 200 status to indicate that the data was received successfully
Was this page helpful?