Subscription Payment Failed

Subscription Payment Failed
alert_name
string

The alert name.

Default:
subscription_payment_failed
alert_id
string

The unique identifier for this Paddle webhook alert. Integer value sent as a string.

Match pattern:
\d+
amount
string

The amount that we tried to charge for this payment. Decimal value sent as a string.

Match pattern:
^\d+(\.\d{1,2})?$
cancel_url
string<uri>

A URL of the 'Cancel Subscription' page. See this documentation on cancelation URLs. You should store this URL along with the subscribed customer in your database.

<= 200 characters
checkout_id
string

The checkout id of the order created.

Example:
27835673-chre93c81118fc7-b3092639c1
currency
string

The three-letter ISO currency code. Eg: USD, GBP. See Supported Currencies.

Match pattern:
[A-Z]{3}
email
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).

Match pattern:
[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1]) (2[0-3]|[01][0-9]):[0-5][0-9]:[0-5][0-9]
marketing_consent
integer

The value of this field 0 or 1 indicates whether the user has agreed to receive marketing messages from the vendor.

Allowed values:
01
next_retry_date
string<date>

The date that we will next try to process this failed payment.

Match pattern:
^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
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.

<= 1000 characters
quantity
string

The number of products or subscription seats sold in the transaction.

Match pattern:
\d+
status
string

This is the current status of the subscription. A list of possible values and their meanings can be found under Event Statuses.

Allowed values:
activetrialingpast_duepauseddeleted
subscription_id
string

This is the unique Subscription ID for this customer’s subscription. You should store this with the customer in your database, as it is needed for making API calls.

Match pattern:
\d+
subscription_plan_id
string

The ID of the Subscription Plan the customer is subscribed to. (This is the value that will change upon plan change).

Match pattern:
\d+
unit_price
string

The price per unit of the subscription.

Match pattern:
(\d+\.\d{1,2})
update_url
string<uri>

A URL of the ‘Update Payment Details’ page. See this documentation on update URLs. You should store this URL along with the subscribed customer in your database.

<= 200 characters
subscription_payment_id
string

The unique ID of the subscription payment.

Match pattern:
\d+
instalments
string

Number of payments made to date, starting from 1 for the customer's first payment. Integer sent as string.

Match pattern:
\d+
order_id
string

The Paddle Order ID for this payment. This can be used to look up the order within your Seller Dashboard.

Match pattern:
^\d+(-\d+)?
user_id
string

The customer user ID.

Match pattern:
\d+
attempt_number
string

Number of failed payment attempts made so far for this instalment. This number will reset back to 1 if the “Reset Attempts” button in the subscription management page is clicked.

Match pattern:
\d+
p_signature
string

This field contains an encrypted token that you can use to verify the request authenticity. See Verifying Webhooks.