Update subscription token
Get started
Sign In
Update subscription token
Streamline subscription lifecycle through payment token update

Subscriptions offer a widely adopted model for businesses to ensure ongoing customer access to products or services. Despite the efficiency of automated recurring payments, disruptions can occur, particularly when a customer’s payment information becomes invalid, leading to failed subscription renewals.

A seamless recurring payment process is crucial for both merchants and customers. For customers, the ability to update payment instruments without service disruptions is paramount. Merchants, on the other hand, can proactively address Guide
A subscription cancellation code is used to describe the reason the subscription was cancelled.
payment declines
and maintain customer loyalty, leading to higher LTV when providing flexibility in payment management. Modifying payment details is possible through the payment token update feature for recurring charges. This feature prevents subscription interruptions, whether triggered by card-related issues or a desire to switch to an alternative payment source.

Merchants can elevate their business by implementing payment token updates as it:

  • Enhances customer retention
    Merchants can effectively address payment issues and prevent subscription cancellations. This fosters customer loyalty and ensures continued revenue streams.
  • Reduces payment declines
    Subscription token update addresses the root causes of payment declines, such as expired cards or insufficient funds. By proactively updating payment information, merchants minimize the risk of declines, ensuring a positive payment experience for customers and access to services they value.
  • Streamlines payment management
    Token update streamlines the payment management process for merchants. This frees up time for merchants to focus on other business-critical tasks, improving operational efficiency.
  • Grants flexibility to customers
    Customers can switch payment methods, ensuring uninterrupted access to their favorite products or services. This eliminates the need for cancellations, reduces their effort, and minimizes the risk of errors without repeatedly entering card details.

Ultimately, implementing the payment token update streamlines payment processes, enhances customer satisfaction, and contributes to a more consistent and secure recurring payment experience.

To enable subscription payment method changes, merchants need to set up the payment token update flow. The update requires two subsequent API calls:

  1. API call to the Auth0 endpoint to receive an updated token (card or APM):
    • Merchants who do not have PCI DSS certification make a call through the Solidgate Guide
      Understand how to integrate the payment form into your product.
      Payment Form
      or Guide
      Easily create a safe and simple payment page.
      Payment Page
      . If the merchant wants to use Guide
      Merchants utilize zero-amount authorizations to verify cards for secure storage, future transactions, registration, free trials, and fraud prevention without charging the customer.
      zero-amount authorization
      , the amount field in the request must equal 0.
    • Merchants with PCI DSS certification make an API call utilizing:
      • Guide
        The payment token initiates a billing agreement between your service and a customer, streamlining customer transactions without requiring them to log into their PayPal account for each subsequent payment.
        Create a payment token
        method for PayPal.
      • H2H card charge API method with zero-amount authorization.
  2. API call to the update token endpoint API with the following parameters:
    • token
    • subscription_id

The entire process unfolds as follows:

  1. The customer or merchant initiates the update of the customer’s payment method.
  2. Merchant makes an API call to the Auth0 endpoint depending on the payment option they employed for payment processing.
  3. The merchant receives a new token for the customer’s payment method.
  4. To complete the update process, the merchant makes another API call to the update token endpoint, providing the new token and subscription_id as parameters.
  5. Solidgate saves the received token for further recurring payments.

With the updated payment information securely in place, further recurring payments ensure active subscription and customer’s continued access to products or services.

Looking for help? Contact us
Stay informed with Changelog