Body
List stored cards
List all the cards stored for a customer. This API gives back only tokens and other metadata relevant to the cards stored in JusPay Locker.
Note
Supported networks - Visa supports cvv-less token transactions across issuers. (Available in sandbox)
Mastercard supports cvv-less token transactions for limited 20 issuers. (To be made available by May 07, 2023)
Supported gateways -
Paytm V2
Cybersource
Payu
Razorpay
Request
Response
API Endpoints
Production Link
GET
https://api.juspay.in/cards
Parameters
options
object
options. atm_pin_auth_support
boolean
This is a boolean variable and accepts true/false. If set to true, then the card eligibility check for ATM PIN payments will be done.
customer_id
string
Customer ID which represents the user uniquely
200 : Success
Response Body
customer_id
string
Customer Id given in the request
merchantId
string
Merchant id associated with Juspay
cards
Array Of Objects
Array of stored cards that belongs to the given user represented by the Customer ID. Each member of the array is an associative array that represents a stored card of the user.
card_token
String
Token representing the card. Payment has to be initiated using this token. Tokens are by definition short lived and so, please do not cache them in your system. Expired tokens will lead to transactions being declined.
card_reference
String
A reference identifier that doesn’t change for the stored card. Use this identifier to store any metadata that you wish. For example, you can store card type or card bin or even transaction data using this reference
card_fingerprint
String
A string that uniquely identifies the card across the board. When the same card is stored across multiple accounts, same fingerprint will be returned. This can be used to identify duplicates.
card_number
String
Masked card number that can be displayed to the customer.
card_isin
String
First 6 digits of the card
card_expiry_year
String
Year of expiry of the card
card_exp_month
String
Month of expiry of the card
card_type
String
Indicates if the card is either CREDIT or DEBIT. Please note that this information is inferred. Not all cards will have this information.
card_issuer
String
Indicates the bank which issued the card. This again is not available all the time. We make our best effort to get this information for all cards.
card_brand
String
Indicates the name of the card switch provider.Please note that this information is inferred
name_on_card
String
Cardholder name given while storing the card
nickname
String
Returns the given nickname while storing the card
expired
String
Indicates whether the stored card is expired or not
atm_pin_auth_support
String
Indicates if the card is eligible for ATM PIN payments.
cvv_less_support
String
Indicates if the tokenised card is eligible for cvv-less payments. Merchants can stop collecting the CVV value for eligible tokens.
cvv_less_supported_gateways
String
List of gateways which are available for cvv-less token transactions. Juspay's dynamic routing will be applied among these gateways. Alternatively, a Gateway ID pertaining to one of the listed gateways can be passed in Create Order API to force route the transaction.
401 : Authentication Failed
Response Body
status
string
error
error_code
string
access_denied