Update Payment Details
Paddle provides a unique update URL for each of your subscribers, which allows them to update the payment method via associated with their subscription.
Update Payment Details URL
When a subscription is created, updated, or when a payment fails, Paddle provides an update_url
within the Subscription Created, Subscription Updated, and Subscription Payment Failed alert. This URL links to a simple payment update page that you can redirect customers to update their payment information.
The update URLs are unique to each customer.
The Update URL changes when a customer's subscription is modified/updated, so make sure you subscribe to the Subscription Updated and Subscription Payment Failed alerts as they contain the updated URLs.
If you are not storing the URLs at the time you receive the subscription created/updated/payment failed webhook alerts, you can alternatively retrieve this by calling the List Users API using the subscription_id
.
Opening Update Page via Paddle.js
The subscription payment details URL can be opened with Paddle.js as either an overlay or inline format on your website, similar to the checkout.
Overlay
Both Paddle.js HTML button and Javascript method support the overlay format. Each take an override parameter that accepts the full update_url
sent by Paddle's alert.
You can additionally redirect the customer to a specified URL, or perform other Javascript action once they have successfully updated their subscription by passing in the 'success' or 'success callback' parameter respectively.
Inline
Paddle.js Javascript method support the inline format. It takes an override parameter that accepts the full update_url
sent by Paddle's alert.
Please note that Branded Inline Checkout is not supported. The inline format will utilize the Brand Color specified in your the Checkout Settings page.
preparing...
You can additionally redirect the customer to a specified URL, or perform other Javascript action once they have successfully updated their subscription by passing in the 'success' or 'success callback' parameter respectively.
preparing...