Payment dispute created
Summary
Section titled “Summary”A payment_dispute_created event is fired when a dispute/chargeback is raised for a card transaction.
Payload
Section titled “Payload”Information sent in the payload for a payment_dispute_created webhook is summarised in the table below.
| Property | Type | Description | Example |
|---|---|---|---|
| alert_id | string | The unique identifier for this Paddle webhook alert. Integer value sent as a string. | |
| alert_name | string | The alert name. Default: payment_dispute_created |
|
| amount | string | The total amount (transaction amount and fee) you were charged for this dispute being raised. | |
| balance_amount | string | The transaction amount you were charged for this dispute being raised, in the vendor’s balance_currency. |
|
| balance_currency | string | The three-letter ISO currency code of the vendor’s account balance at the time of the transaction. | USD GBP EUR |
| balance_fee | string | The fee you were charged for this dispute being raised, in the vendor’s balance_currency. |
|
| checkout_id | string | The checkout id of the order created. | 27835673-chre93c81118fc7-b3092639c1 |
| currency | string | The three-letter ISO currency code. For a full list of supported currencies, see our Supported Currencies page. | USD GBP |
| string<email> | The email address of the customer. | ||
| event_time | string<date-time> | The date and time the event was triggered in UTC (Coordinated Universal Time). | |
| fee_usd | string | The fee you were charged for this dispute being raised (in USD). | |
| marketing_consent | string | The 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_id | string | The Paddle Order ID for this payment. This can be used to look up the order within your Seller Dashboard. | |
| p_signature | string | This field contains an encrypted token that you can use to verify the request authenticity. See Verifying Webhooks. | |
| passthrough | string | This 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 |
|
| status | string | The status of this dispute. Allowed values: open |