Integrate Recurring Payments Using Wallets

Steps to integrate Recurring Payments using Wallet.


Set up recurring payments using Touch'n Go wallet. Customers authorise their wallet once and subsequent payments are processed automatically without additional authentication.

The recurring payments integration involves three main steps:

  1. : Customer authorises their wallet for future charges.
  2. : Retrieve and verify the mandate registration.
  3. : Create subsequent payments as needed.

Mandate registration creates an authorisation transaction where customers provide consent to charge their Touch'n Go wallet for future payments. This generates a secure token that represents the customer's payment authorisation.

Watch Out!

Standard Checkout authorisation can only be created using Razorpay Curlec APIs.

Step 1:

Create a customer record in Razorpay Curlec to associate the mandate with. This returns a customer_id to be used in subsequent steps.

Step 2:

Create an order for the authorisation amount. You can set this to RM 1 for minimal authorisation or the actual first payment amount. Pass the token parameters including max_amount and expire_at to set mandate limits.

Step 3:

Initialise Razorpay Curlec Checkout with the order_id, customer_id and recurring-specific parameters. Specify wallet as the payment method. The customer completes the authorisation on Touch'n Go interface. Once the authorisation is successful, you receive a token_id in the payment response. This token represents the customer's wallet mandate.

Authorisation Payment Statuses

Once the customer has made the Authorisation Payment, it moves through the following states as per the

:

After the authorisation transaction is complete, a token is generated. The token securely stores the customer's wallet authorisation and represents their mandate.

You can retrieve token information using:

Token Lifecycle

Tokens move through different states from creation to expiry:

Token life cycle

Once the token is in confirmed state, you can create recurring payments without customer intervention. Each subsequent payment requires you to create a new charge request.

Important

  • Always ensure the charge amount does not exceed the max_amount specified during token creation. Charges exceeding this limit will fail.
  • Ensure customers maintain sufficient balance in their Touch'n Go wallet for successful recurring charges.

Step 1:

Use the Dashboard search to locate the customer's token. Verify the token status is confirmed.

Step 2:

Click Charge Token and enter the payment amount. Razorpay Curlec automatically creates an order and processes the payment.

Automatic Order Creation

When charging via Dashboard, Razorpay Curlec automatically creates the order for you - no need to create it separately.


Was this page helpful?