Get Customer account
This is a Server-to-Server API which retrieves the bank entity for a given customer identifier, allowing verification of the customer's existence in the Juspay system.
This API retrieves all bank account related information, including account details, bank account id creation date and the last validated date of the bank account details.
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:- Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
application/x-www-form-urlencoded
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
Customer id
Example:- cst_weoridsfdkl
customer Account Id
Example:- bank_woeriusdfk
Example:- customer_account
ID created at Juspay’s end during Customer account creation
Example:- banh_qn2zdmZ4VAEFaBny
Customer ID
Example:- cst_zqqmw0v4exbhvv2l
Creation date of the customer account ID
Example:- 2023-06-06T13:29:49Z
Account details with which customer account ID created
VPA details
Example:- 4225246777@yesg
Penny drop amount for validation
Example:- 1
Currency of the Validation amount
Example:- INR
Validation status of customer account ID
Possible values:CREATED - Customer account has been created, validation has not yet been completed
ACTIVE - validation is successful at gateway with provided customer bank details
PENDING - Awaiting transaction status on the penny drop transaction
FAILURE - Provided account validation is failure
Example:- ACTIVE
Recent modified date of the customer account ID
Example:- 2023-06-06T13:29:53Z
Status of the get customer api response
Example:- Response: error
error code information
Example:- Sample response: access_denied
Detailed information of the error
User error message
Example:- Response: Unauthorized.
Provide accurate details on the error message
Example:- Sample Response: Invalid API Key. Please pass a valid and active api key.
Denotes the category of the error
Example:- Sample Response: USER_ERROR