Tokens (Private)

Learn how to create tokens to save customer’s card details using the Tokens API.

Available in🇮🇳 India

A token represents a customer’s card details stored in Razorpay servers. We use these tokens to securely fetch the saved details for making it quick and easy for customers to make payments. Tokens are generally created with every payment requests and Tokens API can be used to migrate them from your current system to Razorpay.

PCI-DSS Compliance

The customer’s payment information should never reach your servers unless you are PCI-DSS certified. Your site must be PCI-DSS certified to accept, process, store or transmit customer’s card details securely to Razorpay.

Tokens API

POST /customers/:customer_id/tokens

Request Parameters

customer_id : The unique customer ID. To create a customer, refer the Customer API section.

method : The payment method selected by the customer on checkout.

card[number] : The card number.

card[name] : The name on the card.

card[expiry_month] : The expiry month of the card.

card[expiry_year] : The expiry year of the card.

All server-side requests must be authenticated with Basic Auth using the key-id as username and key-secret as password. You can acces your keys on your Dashboard. Know more about API authentication to get started with Razorpay APIs.

Example Request

curl -X POST \
  https://api.razorpay.com/v1/customers/cust_9W8HsFCULn3aTK/tokens \
  -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
  -d 'method=card' \
  -d 'card[name]=Gaurav Kumar' \
  -d 'card[number]=4386289407660153' \
  -d 'card[expiry_month]=1' \
  -d 'card[expiry_year]=2022'