Body
Generate Network Token
Use this API to pass the card details and tokenize with respective card network. Juspay will tokenize the card and expose an identifier to be used for future transactions
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/generateToken
Production Link
POST
https://api.juspay.in/generateToken
Authorization Header
Basic Auth
Base64 Encoded Username:Password
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
content-type
String
application/x-www-form-urlencoded
x-routing-id
*
String
Required
We recommend passing the customer_id as the x-routing-id. If the customer is checking out as a guest, you can pass an alternative ID that helps track the payment session lifecycle. For example, this could be an Order ID or Cart ID.
Warning
This ID is associated with the customer. It plays a key role in ensuring consistency and maintaining connections across different systems. If you fail to pass the same x-routing-id for the same customer in all related API calls, it could lead to issues with API functionality. Therefore, it’s crucial that you use the same x-routing-id for all requests tied to the same customer.
Example:- customer_1122
Request Schema: application/json
Basic Parameters
cardData
*
String
Required
Actual Card to be tokenized in an encrypted format. Generate and use an RSA key to generate EncryptedCardData
cardNumber
*
String
Mandatory
15/16 digit card number
expYear
*
String
Mandatory
Year in YY format
expMonth
*
String
Mandatory
Month in MM format
nameOnCard
String
Optional
cardSecurityCode
String
Optional
Card CVV, 3 digits or 4 digits basis the card brand.
orderData
*
JSON
Required
consentId
*
String
Mandatory
unique identifier passed merchant which signifies that user consent is taken. It could be the transaction_id at zohopay's end
customerId
*
String
Mandatory
Customerid of the merchant
audit
JSON
Conditional
Mandatory for AMEX Cards
service
*
String
Required
Specifies the token type
Default: NETWORK_TOKEN
submerchantId
String
Sub Merchant ID on which the Token will be generated
shouldSendToken
Boolean
Boolean indicating whether raw token is needed by merchant or not
keyId
String
keyId to be used for encrypting and decrypting payloads
200 : Success
Response Body
status
*
String
Required
Status of the response
payload
JSON
payload with the token details
cardFingerprint
String
tokenStatus
String
cardReference
String
correlationId
String
par
String
customerId
String
tokenExpiryMonth
String
tokenLastFour
String
tokenExpiryYear
String
tokenIsin
String
errorCode
String
errorCode incase tokenisation fails
errorMessage
String
errorMessage incase tokenisation fails
Have questions?
- Need help? Contact support
- LLM? Read llms.txt