Subscription created scenario
Simulates all events that occur when a subscription is created from a checkout.
Customer opens checkout
transaction.createdPaddle creates a transaction for the items on the checkout. Its status is draftwhile it's missing customer and address information. Its origin isweb.Customer enters their information
customer.createdWhen a customer enters their email address, Paddle creates a customer if one can't be found that matches the email address. address.createdWhen a customer enters their country and ZIP/postal code, Paddle creates an address related to this customer. transaction.updatedPaddle updates the transaction with the new customer and address that was just created. The transaction status is readybecause the transaction has customer and address information.transaction.readyOccurs because the transaction status changes to ready.Customer enters business information (optional)
business.createdIf a customer chooses to enter a tax/VAT number, Paddle creates a business. address.updatedWhen collecting business information, checkout collects a complete address. Paddle updates the address entity with the new information. transaction.updatedPaddle 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.updatedWhen a customer adds a discount or makes changes to items or quantities, Paddle updates the transaction. Customer completes checkout successfully
transaction.updatedThe transaction status changes to paidnow that the customer has paid successfully. The transaction is updated with information about the successful payment.transaction.paidOccurs because the transaction status changes to paid.subscription.createdPaddle creates a subscription for the customer, address, and business against the transaction. Its status is activeortrialing, depending on the items on the subscription. Includes atransaction_idfield so you can match with the completed transaction.subscription.trialingIf items on a subscription have a trial period, this event occurs because the subscription status is trialing.subscription.activatedIf items on a subscription have no trial period, this event occurs because the subscription status is active.transaction.updatedThe transaction is updated with the ID of the new subscription and information about fees, payouts, and earnings. transaction.updatedAn invoice number is assigned to the transaction. Its status changes to completedas Paddle has finished processing it.transaction.completedOccurs because the transaction status changes to completed.Saved payment method created
payment_method.savedPaddle 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