Body
Fetch Alt ID and Cryptogram API
This API is used to Fetch Network Alt ID and Cryptogram (TAVV) for Guest Checkout transactions, using the original card number collected from user
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/get/altId
Production Link
POST
https://api.juspay.in/get/altId
Authorization Header
Basic Auth
*
required
Base 64 encoding
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
x-merchantId
*
String
Mandatory
Merchant ID provided by Juspay
Example:-
merchant-id
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
mandatory
Provide actual card details in an encrypted (Algorithm: RSA-OAEP-256
ENC: A128GCM) payload generated using RSA Keys.
Refer to the following doc to understand what encryption is required - https://docs.juspay.in/resources/docs/card-network-tokenization/card-details-encryption
Acceptable Card Brands: VISA, MASTERCARD, AMEX, DINERS, RUPAY
cardNumber
*
String
Mandatory
Pass the 16-19 digit card number
expYear
*
String
Mandatory
Pass it in YYYY format
expMonth
*
String
Mandatory
Pass it in MM format
cardSecurityCode
String
Conditional
orderData
*
JSON
Mandatory
Provide the following order-related parameters.
amount
*
Double
mandatory
Pass the order amount
currency
*
String
Mandatory
Pass the currency in which transaction is supposed to happen.
authRefNumber
String
Conditional
For Rupay, the AltID is generated post successful Authentication hence this field is required only for Rupay cards processing.
submerchantId
String
Conditional
Value needed incase you have master merchant - submerchant model implementation. Pass the identifier that denotes a submerchant.
Note: Travel Networks can use it to pass airline codes.
correlationId
String
Optional
Unique reference Id that can be passed by merchant; else it is generated by Juspay
keyId
String
Optional
key uuid returned from the Dashboard when the public key is uploaded. Pass the key uuid incase you have multiple Public-Private key pairs published on dashboard.
shouldSendRawCard
String
Conditional
Pass true if you want us to return the card data shared in request body. Applicable incase of International cards where ALT_ID is not relevant.
Example:- true, false
200 : Success
Response Body
200 : Response
Object
status
String
payload
Object
cardIssuerCountry
String
correlationId
String
cardIssuerBank
String
altIdDetails
*
String
Mandatory
cardBrand
*
String
Mandatory
provider
*
String
Mandatory
providerCategory
*
String
Mandatory
errorCode
String
errorMessage
String
Decrypted Card Details
Object
altId
String
expMonth
String
expYear
String
tavv
String
par
String
Have questions?
- Need help? Contact support
- LLM? Read llms.txt