Body
Update Card
Update nickname and name_on_card for the stored card
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/card/update
Production Link
POST
https://api.juspay.in/card/update
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-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
card_token
*
string
Required
Card token obtained from /card/list API
customer_id
*
string
Required
Customer ID against which the card is stored. This is same as the object_reference_id using which was customer was created
name_on_card
string
Pass a new value, if name on card needs to be updated, alphabet and spaces allowed with length limit of 64 chars.
nickname
string
Pass a new value, if nickname needs to be updated, alphabet and spaces allowed with length limit of 64 chars.
200 : Success
Response Body
card_token
string
c75a9fca-1121-418e-973c-47d5c4971456
user_message
string
Card details updated
status
string
SUCCESS
400 : Invalid Input data
Response Body
Invalid Customer Id
JSON
error
String
true
error_message
String
BAD_REQUEST
user_message
*
String
Mandatory
Invalid customer id
Nothing to Update
JSON
error
String
true
error_message
String
BAD_REQUEST
user_message
String
Nothing to update
Invalid Card Token
JSON
error
String
true
error_message
String
BAD_REQUEST
user_message
String
Invalid card token