Paddle Logo
Paddle Classic
Get Started
Guides
API Reference
Webhooks
Reference
Search
Login
Webhook Reference
Webhook Reference
Security
Verifying Webhooks
Order Fulfillment
Fulfillment Webhook
Order Fulfillment
Subscription Alerts
Overview
Subscription Created
Subscription Updated
Subscription Cancelled
Subscription Payment Succeeded
Subscription Payment Failed
Subscription Payment Refunded
One-off Purchase Alerts
Overview
Order Processing Completed
Payment Refunded
Payment Succeeded
Risk & Dispute Alerts
Overview
High Risk Transaction Created
High Risk Transaction Updated
Payment Dispute Created
Payment Dispute Closed
Payout Alerts
Overview
Transfer Created
Transfer Paid
Audience Alerts
Overview
New Audience Member
Update Audience Member
Manual Invoicing Alerts
Overview
Invoice Sent
Invoice Paid
Invoice Overdue
Invoice Cancelled
Manual Invoicing Alerts (Legacy)

Payment Dispute Created

Summary

A payment_dispute_created event is fired when a dispute/chargeback is raised for a card transaction.

Payload

Information sent in the payload for a payment_dispute_created webhook is summarised in the table below.

PropertyTypeDescriptionExample
alert_idstringThe unique identifier for this Paddle webhook alert. Integer value sent as a string.
alert_namestringThe alert name.
Default: payment_dispute_created
amountstringThe total amount (transaction amount and fee) you were charged for this dispute being raised.
balance_amountstringThe transaction amount you were charged for this dispute being raised, in the vendor’s balance_currency.
balance_currencystringThe three-letter ISO currency code of the vendor’s account balance at the time of the transaction.USD GBP EUR
balance_feestringThe fee you were charged for this dispute being raised, in the vendor’s balance_currency.
checkout_idstringThe checkout id of the order created.27835673-chre93c81118fc7-b3092639c1
currencystringThe three-letter ISO currency code. For a full list of supported currencies, see our Supported Currencies page.USD GBP
emailstring<email>The email address of the customer.
event_timestring<date-time>The date and time the event was triggered in UTC (Coordinated Universal Time).
fee_usdstringThe fee you were charged for this dispute being raised (in USD).
marketing_consentstringThe value of this field 0 or 1 indicates whether the user has agreed to receive marketing messages from the vendor.
Allowed values: 0 1
order_idstringThe Paddle Order ID for this payment. This can be used to look up the order within your Seller Dashboard.
p_signaturestringThis field contains an encrypted token that you can use to verify the request authenticity. See Verifying Webhooks.
passthroughstringThis field contains any values that you passed into the checkout using the passthrough parameter. See the Pass Parameters documentation for more information.
Max Length: <=1000 characters
statusstringThe status of this dispute.
Allowed values: open