For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Docs

Subscription created scenario

Simulates all events that occur when a subscription is created via checkout.

Customize simulation reference

Adjust the options below to see which webhook events occur.

Whether the simulated subscription is for a new customer, an existing customer, or an existing customer with details prefilled.

Whether to simulate if a new, existing, or no business is provided at checkout.

Whether to simulate if a discount is entered, prefilled, or not provided at checkout.

Whether to simulate if prices in the transaction items have a trial period.

  1. Customer opens checkout

    transaction.createdPaddle creates a transaction for the items on the checkout. Its status is initially draft. Its origin is web.

  2. Customer adds their details and address

    customer.createdPaddle creates a new customer with the information provided by the customer. The customer's status is active.
    address.createdWhen a customer enters their country and ZIP/postal code, Paddle always creates a new address related to this customer.
    transaction.updatedPaddle updates the transaction with the customer and address. The transaction status is ready because the transaction has customer and address information.
    transaction.readyOccurs because the transaction status changes to ready.

  3. Customer completes checkout successfully

    transaction.updatedThe transaction status changes to paid now 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 active as the prices in the transaction items have no trial_period. Includes a transaction_id field so you can match with the completed transaction.
    subscription.activatedOccurs because the subscription has no trial period and is now active.
    transaction.updatedThe transaction is updated with the ID of the new subscription, the billing period, and information about fees, payouts, and earnings.
    transaction.updatedAn invoice number is assigned to the transaction. Its status changes to completed as Paddle has finished processing it.
    transaction.completedOccurs because the transaction status changes to completed.

  4. Payment method is saved

    payment_method.savedOccurs if the customer opted to save their payment method at checkout.

Was this page helpful?