JavaScript is disabled. Some features may not work. You can also read the static version: View text version

Fetch Token and Cryptogram

This API is used to fetch cryptogram and token for processing token repeat transactions.

Request

Response

API Endpoints

Sandbox Link

POST

https://sandbox.juspay.in/v4/card/get

Production Link

POST

https://api.juspay.in/v4/card/get

                      Basic Auth
                      *
                      

required

Base64 Encoded Username:Password

Consists of two parts.

Username: API Key obtained from Juspay dashboard
Password: Empty string

Example:- Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==

                      x-merchantid
                      *
                      

String

Mandatory

Please pass merchant-id given for your merchant

                      Content-type 
                      *
                      

String

Mandatory

Example:- application/json

                      version
                      *
                      

String

Mandatory

Pass the date in YYYY-MM-DD format

Example:- 2023-01-01

                      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.

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

Body

Request Schema: application/json

                      card_reference
                      *
                      

String

Mandatory

It is a unique reference number associated with each card_number.

                      customer_id
                      *
                      

String

Mandatory

It is the ID with which merchant refers to a customer object.

                      submerchantId
                      
                      

String

Optional

Conditional - Required only for reseller based workflows

Response Body

eci

String

                      name_on_card
                      
                      

String

                      token_requestor_id
                      
                      

String

                      fingerprint
                      
                      

String

                      card_type
                      
                      

String

                      reference
                      
                      

String

                      customer_id
                      
                      

String

                      sub_type
                      
                      

String

                      network
                      
                      

String

                      token_details: status
                      
                      

String

                      token_details: first_six
                      
                      

String

                      token_details: last_four
                      
                      

String

                      token_details: exp_month
                      
                      

String

                      token_details: exp_year
                      
                      

String

                      token_details: provider
                      
                      

String

                      token_details: provider_category
                      
                      

String

                      issuer_country_code
                      *
                      

String

Mandatory

                      authentication_details: cryptogram
                      *
                      

String

Mandatory

                      authentication_details: token
                      *
                      

String

Mandatory

                      nickname
                      *
                      

String

Mandatory

                      issuer
                      *
                      

String

Mandatory

                      card_details: last_four
                      *
                      

String

Mandatory

                      card_details: par
                      *
                      

String

Mandatory

                      card_details: exp_month
                      *
                      

String

Mandatory

                      card_details: exp_year
                      *
                      

String

Mandatory

Response Body

                      error
                      
                      

String

Example:- true

                      user_message
                      
                      

String

Example:- Stored Card Entry Not Found

                      error_message
                      
                      

String

Example:- Not Found

Response Body

                      status
                      *
                      

String

Mandatory

Example:- error

                      error_code
                      *
                      

String

Mandatory

Example:- access_denied