Body
Add Card
Add a credit card or debit card of a customer to JusPay Locker. customer_id parameter identifies the customer to whom this card belongs.
Note
As a part of CoFT regulations, the above API can be used for only international cards. Using it for storing domestic cards will lead to failure.
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/card/add
Production Link
POST
https://api.juspay.in/card/add
Authorization Header
Basic Auth
*
Base64 Encoded Username:Password
Mandatory
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
Content-Type
*
String
Mandatory
application/x-www-form-urlencoded
x-merchantid
*
String
Mandatory
Merchant ID provided by Juspay
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
Parameters
token
string
The token obtained during tokenize card API. If token is used within 15 minutes, then card_number, card_exp_year, and card_exp_month are not required. merchant_id and customer_id are required in either case.
merchant_id
*
string
Required
Merchant ID which represents the merchant storing the card
customer_id
*
string
Required
Customer ID which represents the user uniquely
customer_email
string
Email address of the customer
card_number
string
A valid card number.
Required only if token is not used in the request.
card_exp_year
string
Expiry year of the card (Format: yyyy) Example: 2020
Required only if token is not used in the request.
card_exp_month
string
Expiry month of the card (Format: mm) Example: 06
Required only if token is not used in the request.
name_on_card
string
Cardholder name
nickname
string
A tag or a label for the card so that the user can easily identify the card
200 : Success
Response Body
card_token
string
c75a9fca-1121-418e-973c-47d5c4971456
card_reference
string
df2c47951a71e4486827039fad7b039a
card_fingerprint
string
c7uapov1smt3a0rd5f9b1l21i