Subscription Payment Succeeded

Fired when a payment for a subscription is received successfully.

object

Identify this event with the HTTP POST parameter alert_name with a value of subscription_payment_succeeded

alert_name
string
1 validation
alert_id
string

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

1 validation
balance_currency
string

The three-letter ISO currency code of the vendor’s default currency at the time of the transaction. Eg: USD, GBP.

balance_earnings
string

Amount of balance increase as a result of this payment.

balance_fee
string

The fee amount taken from the vendor, in the vendor’s default currency at the time of the transaction.

balance_gross
string

The total amount received from the customer as a result of the payment, in the vendor’s default currency at the time of the transaction.

balance_tax
string

The amount of tax received from the customer, in the vendor’s default currency at the time of the transaction.

checkout_id
string

The checkout id of the order created.

1 validation
country
object

The two-letter ISO country code of the customer. Eg: US, GB. See Supported Countries.

coupon
string

The coupon code that was used on this order

currency
string

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

customer_name
string

The name of the customer (if collected).

earnings
string

The total amount (after taxes and fees) you earned from this payment.

email
string

The email address of the customer.

1 validation
event_time
string

The date and time the event was triggered in UTC (Coordinated Universal Time).

1 validation
fee
string

The total amount in Paddle fees for this payment.

initial_payment
string

The value of this field indicates whether it is the customer’s first payment for this subscription.

1 validation
instalments
string

Number of payments made to date. Integer sent as string.

marketing_consent
string

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

1 validation
next_bill_date
string

The date the next payment is due on this subscription.

next_payment_amount
string

The total amount that the customer will be charged for on their upcoming payment, in the subscription’s currency.

order_id
string

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

passthrough
string

This field contains any values that you passed into the checkout using the passthrough parameter. See the Paddle Checkout (Web) documentation for more information.

payment_method
string

Payment method used to make the transaction.

1 validation
payment_tax
string

Amount of tax paid as a result of this payment.

plan_name
string

Subscription plan name.

quantity
string

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

1 validation
receipt_url
string

URL containing the customer receipt.

1 validation
sale_gross
string

The total amount the customer was charged for this payment. Decimal sent as string.

status
string

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

1 validation
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.

subscription_payment_id
string

The unique ID of the subscription payment.

1 validation
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).

unit_price
string

The price per unit of the subscription.

user_id
string

The customer user id.

p_signature
string

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