Subscription created scenario
Simulates all events that occur when a subscription is created from a checkout.
Customer opens checkout
transaction.created
Paddle creates a transaction for the items on the checkout. Its status is draft
while it's missing customer and address information. Its origin isweb
.Customer enters their information
customer.created
When a customer enters their email address, Paddle creates a customer if one can't be found that matches the email address. address.created
When a customer enters their country and ZIP/postal code, Paddle creates an address related to this customer. transaction.updated
Paddle updates the transaction with the new customer and address that was just created. The transaction status is ready
because the transaction has customer and address information.transaction.ready
Occurs because the transaction status changes to ready
.Customer enters business information (optional)
business.created
If a customer chooses to enter a tax/VAT number, Paddle creates a business. address.updated
When collecting business information, checkout collects a complete address. Paddle updates the address entity with the new information. transaction.updated
Paddle updates the transaction with the new business that was just created. Totals on the transaction may be updated to reflect changes in tax. Customer adds a discount or makes other changes (optional)
transaction.updated
When a customer adds a discount or makes changes to items or quantities, Paddle updates the transaction. Customer completes checkout successfully
transaction.updated
The transaction status changes to paid
now that the customer has paid successfully. The transaction is updated with information about the successful payment.transaction.paid
Occurs because the transaction status changes to paid
.subscription.created
Paddle creates a subscription for the customer, address, and business against the transaction. Its status is active
ortrialing
, depending on the items on the subscription. Includes atransaction_id
field so you can match with the completed transaction.subscription.trialing
If items on a subscription have a trial period, this event occurs because the subscription status is trialing
.subscription.activated
If items on a subscription have no trial period, this event occurs because the subscription status is active
.transaction.updated
The transaction is updated with the ID of the new subscription and information about fees, payouts, and earnings. transaction.updated
An invoice number is assigned to the transaction. Its status changes to completed
as Paddle has finished processing it.transaction.completed
Occurs because the transaction status changes to completed
.Saved payment method created
payment_method.saved
Paddle creates a saved payment method entity for the payment method that the customer used. It's used for renewals and future charges for this subscription.
Related pages
On this page