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
Ensure a successful Create Customer API was called before this and use customer_id (or) object_reference_id obtained in the response.
Two possible scenarios for this API
Raw Card details
card_number
card_exp_year
card_exp_month
Card token
Token - Ensure it is a fresh token used within 15 mins of generation- obtained from Tokenize card API
Request
Response
API Endpoints
Sandbox Link
POST
https://api.sandbox.juspay.io/card/add
Production Link
POST
https://api.juspay.io/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==
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
Unique identifier assigned to the merchant account.
customer_id
*
string
Required
Unique identifier of the customer created and managed by the merchant using the platform APIs.
customer_email
string
Email address of the customer
card_number
*
string
Required
A valid card number.
Required only if token is not used in the request.
card_exp_year
*
string
Required
Expiry year of the card (Format: yyyy) Example: 2020
Required only if token is not used in the request.
card_exp_month
*
string
Required
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
A valid card token obtained using /card/list API. If you send this parameter, then card_number, name_on_card, card_exp_year, card_exp_month fields are not required. If the token is generated using the /card/tokenize API, card_number, name_on_card, card_exp_year, card_exp_month and card_security_code fields are not required.
NOTE: expiry of card_token is 15 mins from the time generation.
EXAMPLE : c75a9fca-1121-418e-973c-47d5c4971456
card_reference
string
A reference identifier for the card.
Example : df2c47951a71e4486827039fad7b039a
card_fingerprint
string
A unique Identifier for card
Example : c7uapov1smt3a0rd5f9b1l21i
card_global_fingerprint
String
Have questions?
- Need help? Contact support
- LLM? Read llms.txt