2. Fetch and Manage Tokens

Retrieve tokens using Razorpay APIs to create subsequent payments.


Once you capture a payment, Razorpay Checkout returns a razorpay_payment_id. You can use this ID to fetch the token_id, which is used to create and charge subsequent payments.

You can retrieve the token_id in the following ways:

After you send the registration link, You should wait for the customer to make the payment. You can check the status of the payment using our APIs. The following endpoint fetches the payment_id using an order_id.

GET
/orders/:id/payments

id

string The unique identifier of the order. For example, order_1Aa00000000001.

Use the below endpoint to fetch the token_id using a payment_id.

GET
/payments/:id

Handy Tips

You can also retrieve the token_id via the

.

id

mandatory

string The unique identifier of the payment to be retrieved. For example, pay_1Aa00000000002.

Use the below endpoint to fetch tokens linked to a customer.

A customer can have multiple tokens tied to them. These tokens can be used to create subsequent payments for multiple products or services.

Watch Out!

This endpoint will not fetch the details of expired and unused tokens.

GET
/customers/:id/tokens

id

mandatory

string The unique identifier of the customer for whom tokens are to be retrieved. For example, cust_1Aa00000000002.

The following endpoint deletes a token.

DELETE
/customers/:customer_id/tokens/:token_id

customer_id

mandatory

string The unique identifier of the customer with whom the token is linked. For example, cust_1Aa00000000002.

token_id

mandatory

string The unique identifier of the token that is to be deleted. For example, token_1Aa00000000001.


Is this integration guide useful?