API ReferenceIntegrationsKnowledge Base

2. Fetch a Token and Check its Status

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

Note:
For simplicity, tokens are considered to be mandates. Therefore, the status of the token determines the status of the mandate registration.

Token Statuses#

As the authorization transaction moves through its different states, the token that is generated also undergoes state changes. Below is the life cycle for 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.

Learn more about the turnaround time (TAT) for cards and Emandate from the FAQ section.