Skip to content
Paddle Classic
You're viewing guides for Paddle Classic, which is no longer available for new signups. Head to developer.paddle.com for Paddle Billing guides.

Checkout events

As a part of the Paddle.Setup() call, you can pass an eventCallback parameter. This function is called for every Paddle checkout event, allowing you trigger behaviors based on user interactions with Paddle.

Unlike the Success and Close checkout parameter callbacks, the eventCallback is non-blocking and occurs in the background, letting Paddle.js and the checkout continue with its typical functionality.

Paddle.Setup({
  vendor: 12345,
  eventCallback: function (data) {
    // The data.event will specify the event type
    if (data.event === "Checkout.Complete") {
      console.log(data.eventData); // Data specifics on the event
    } else if (data.event === "Checkout.Close") {
      console.log(data.eventData); // Data specifics on the event
    }
  },
});

List of events

Event Type Description
Checkout.Loaded Checkout has been initialized on the page
Checkout.Customer.Details User lands on the screen to enter their email and location details
Checkout.Payment.Selection User lands on the screen to select payment method
Checkout.Payment.Selected User selected a payment method
Checkout.Complete Checkout has been completed successfully. This is equivalent to when the “successCallback” checkout parameter is fired here.
Checkout.Close Checkout has been closed on the page. This is equivalent to when the “closeCallback” checkout parameter is fired here.
Checkout.User.Subscribed User has opted into/out of marketing emails in the checkout
Checkout.Quantity.Change User has changed the quantity in the checkout
Checkout.CountryChanged User has changed the country
Checkout.Login User has proceeded past the email checkout step
Checkout.Logout User selected ‘Not you? Change’ in bottom right of checkout
Checkout.PaymentMethodSelected Payment method has been selected
Checkout.Coupon.Add User clicked ‘Add Coupon’
Checkout.Coupon.Submit User has submitted a coupon
Checkout.Coupon.Cancel User has cancelled the coupon page
Checkout.Coupon.Applied Valid coupon applied to purchase
Checkout.Coupon.Remove Coupon has been removed
Checkout.Error Any generic checkout error, like an invalid VAT number or payment failure
Checkout.Failed Checkout failed to load because the user is in a sanctioned country.
Checkout.Location.Submit User proceeded past the location page
Checkout.Language.Change Language has been changed in the bottom right
Checkout.Vat.Add User clicked ‘Add VAT Number’
Checkout.Vat.Cancel VAT screen cancelled
Checkout.Vat.Submit VAT number was submitted
Checkout.Vat.Applied VAT number was accepted and applied
Checkout.Vat.Remove VAT number was removed
Checkout.WireTransfer.Complete User completed a checkout with Wire Transfer as the selected payment type. Always fired with Checkout.OfflinePayment.DetailsComplete.
Checkout.OfflinePayment.DetailsComplete User has completed a checkout and selected an offline payment type (in this scenario, any details that the user needs to make their payment offline, are displayed).
Checkout.PaymentComplete Payment has been completed successfully.

Check if the payment has been flagged for manual fraud review in the eventData.flagged property, which returns a boolean value of true or false
Checkout.PaymentMethodChange User has selected “Change Payment Method” when on the payment screen
Checkout.WireTransfer.PaymentMethodChange User has selected “Change Payment Method” when on the Wire Transfer screen