Upgraded docs version is here ✨

Your documentation experience is getting an upgrade. Check it out now!

Go To Beta

Docs upgrade is here. Check it out!

Go To Beta
API ReferenceIntegrationsKnowledge Base

2. Fetch a Token and Check its Status

A token represents a mandate registration and is generated after the authorisation transaction is successfully captured. A token contains customer's payment details stored by Razorpay and is used to create a recurring payment.

Handy Tips
For simplicity, tokens are considered to be mandates. Hence, the status of the token determines the status of the mandate registration.

Token Statuses🔗

As the authorisation transaction moves through its different states, the token that is generated also undergoes state changes. Following is the life cycle of a token:


token_status

Description

Next Step

initiated

Indicates that the bank is processing the mandate registration.

Wait for the token.confirmed webhook

confirmed

Indicates that the bank has completed the mandate registration.

Create recurring payment

rejected

Indicates that the mandate registration has failed.

Create the authorization transaction again

cancelled

Indicates that the token has been cancelled.

Create the authorization transaction again if you want to charge the customer.

paused

Indicates that the token has been paused by your customer.

The token is inactive. Your customer has paused the token. Ask them to resume the token to charge them.

resumed

Indicates that the token has been unpaused by your customer.

The token is active and you can charge the customer.

Know more about the turnaround time (TAT) for cards and Emandate from the FAQs.

×