--- page_title: Cards - Saved Cards product: EC Headless platform: Android page_source: https://juspay.io/in/docs/ec-headless/android/payloads/cards--saved-cards llms_txt: https://juspay.io/in/docs/llms.txt product_llms_txt: https://juspay.io/in/docs/ec-headless/llms.txt --- # Credit / Debit Saved Card transaction ### Step 1.1. Card - List Saved This operation needs to be called before loading the payment page to get the details of the cards stored by the user. ### Step 1.1. Card Txn - Saved Cards This action starts a saved card transaction with THREE_DS authentication. Create Payload to call Process API for New Cards transaction. Refer code snippets on the right for reference. **Payload Parameters** ## Request Payload - **RequestId**: - Description: Unique uuid-v4 string Example: abcd-12345-abcd-12345 - Value: value - Tags: String, Mandatory - **Service**: - Description: Value: in.juspay.hyperapi - Tags: String, Mandatory - **Payload**: - Description: Parameters required to call Hyper SDK API - Value: - **Action**: - Description: Must be cardTxn for Card Process calls. - Tags: String, Mandatory - **OrderId**: - Description: order id pertaining to the order for which the payment is started. - Tags: String, Mandatory - **CardToken**: - Description: A valid card token obtained using /card/list API or cardList SDK call. 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. - Tags: String, Mandatory - **CardSecurityCode**: - Description: CVV of the card. Usually three digits. Optional for all VISA saved cards, PLUXEE | SODEXO saved cards, and saved cards of select issuing banks of MASTERCARD - Tags: String, Mandatory - **ClientAuthToken**: - Description: Required for client side authentication - Tags: String, Mandatory - **PaymentMethod**: - Description: This is network of the card number provided. One of VISA/MASTERCARD/MAESTRO/AMEX/RUPAY. Mandatory for AMEX to verify the input of 4 digit CVV. - Value: jdwqkdks - Tags: String - **ShowLoader**: - Description: To show a loader for the processing state. - Tags: Boolean - **Tavv**: - Description: Cryptogram is required to be passed in tavv - Tags: String - **RequestorId**: - Description: Pass Token requester id - Value: - Tags: String - **Par**: - Description: The PAR value as is received from the network. Can be used to check uniqueness of cards for use case of Offers, EMI etc. - Tags: String - **CardLastFour**: - Description: Token's last four. Optional in case of certain networks. - Tags: String - Tags: JSON, Mandatory ## Sample Code Snippets: ### Sample Request: #### Card - List Saved Code Snippet: ```card - list saved { "requestId": "bfc553f2-bb20-4bc6-b8a1-a4eea116d67c", "service": "in.juspay.hyperapi", "payload": { "action": "cardList", "clientAuthToken": "tkn_e715521dddd2409ea3febd012107a92b", "checkCvvLessSupport": "true" } } ``` #### Card Txn - Saved Code Snippet: ```card txn - saved { "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9", "service": "in.juspay.hyperapi", "payload": { "action": "cardTxn", "orderId": "hyperorder45314", "paymentMethod": "VISA", "cardToken": "tkn_844ce1fb-9810-4b87-82a5-c8a62b30ded0", "cardSecurityCode": "123", "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213", "showLoader": true, "tokenize": true } } ``` #### EMI Txn - Saved Card Code Snippet: ```emi txn - saved card { "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9", "service": "in.juspay.hyperapi", "payload": { "action": "cardTxn", "orderId": "hyperorder45314", "paymentMethod": "VISA", "cardToken": "tkn_844ce1fb-9810-4b87-82a5-c8a62b30ded0", "cardSecurityCode": "123", "isEmi": true, "emiBank": "HDFC", "emiTenure": 3, "supportedGatewayId": [74,21], "emiType": "NO_COST_EMI", "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213", "showLoader": true } } ``` #### Card Txn - Using Token and Cryptogram Code Snippet: ```card txn - using token and cryptogram { "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9", "service": "in.juspay.hyperapi", "payload": { "cardLastFour": "3497", "tavv": "XXXXXXXXXXXXXXXX", // Cryptogram is required to be passed in tavv "requestorId": "{trid}", // token.requestor_id "eci": "{eci}", "cardNumber": "4788080252078243", // Token number is required to be passed in card_number "par": "V0010014622122423467188903638", "cardExpMonth": "11", // token_expiry_month "orderId": "test123", "cardExpYear": "2029", // token_expiry_month "action": "cardTxn", "cardBin": "559344", "amount": "805.00", "cardSecurityCode": "123", "clientAuthToken": "tkn_df6fbf7efd214f82ae85d1a0ff92097d" } } ``` ### Sample Response: #### Card - List Saved: ```json { "requestId": "bfc553f2-bb20-4bc6-b8a1-a4eea116d67c", "service": "in.juspay.hyperapi", "payload": { "merchantId": "picasso", "action": "cardList", "customerId": "test_customer", "cards": [{ "cardIsin": "459156", "cardFingerprint": "3rij7q99sdcerj72g82ca59csb", "providerCategory": "NETWORK", "nameOnCard": "name", "cardIssuerCountry": "INDIA", "cardNumber": "XXXX-XXXXXXXX-1614", "provider": "VISA", "expired": false, "cardToken": "tkn_39aa4c3520674d2e96e2fe4c57ae1c3d", "cardExpMonth": "04", "cardReference": "cref_35b79c2e6c334c24a17967ddfc084b85", "juspayBankCode": "JP_SBI", "cardExpYear": "2026", "cardIssuer": "SBI", "cardType": "DEBIT", "cardSubType": "VISA CLASSIC", "tokenizeSupport": false, "cardBrand": "VISA", "nickname": "", "token": { "expiryMonth": "04", "cardIsin": "449136560", "cardFingerprint": "3rij7q99sdcerj72g82ca59csb", "lastFourDigits": "9815", "cvvLessSupport": true, "par": "VRIPPIFILTERED0014621146339479287179970", "tokenizationStatus": "ACTIVE", "cardReference": "cref_35b79c2e6c334c24a17967ddfc084b85", "cvvLessSupportedGateways": [ "CYBERSOURCE", "PAYU", "PAYTM_V2", "BILLDESK", "RAZORPAY", "EASEBUZZ" ], "expiryYear": "2026" } } ] }, "errorCode": "", "errorMessage": "", "error": false } ``` #### Card Txn - Saved: ```plaintext { "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9", "service": "in.juspay.hyperapi", "error": false, "payload": { "orderId": "hyperorder45314", "status": "CHARGED", "otherInfo": { "url": "https://api.juspay.in/end?status_id=21&status=CHARGED&order_id=hyperorder75189&signature=6O7eP9XnT0BVyaBgdjL92xSwBpeUjgs85VuxecfRd2c%3D&signature_algorithm=HMAC-SHA256", "realtime": { "requestId": "d5de7279-7eff-4ebb-9510-54053298f723", "merchantId": "picasso", "customerId": "balas0011@gmail.com", "clientId": "picasso_android", "environment": "production", "merchantLoader": "false", "isWrapper": "false", "lastVisitedUrl": "https://test.payu.in/0f573e02a5c1ca13e6b0594af4252a1ca42e1602f8da237d0f9a15dc2802bcad/CommonPgResponseHandler.php" } } }, "errorCode": "", "errorMessage": "" } ``` #### EMI Txn - Saved Card: ```plaintext { "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9", "service": "in.juspay.hyperapi", "error": false, "payload": { "orderId": "hyperorder45314", "status": "CHARGED", "otherInfo": { "url": "https://api.juspay.in/end?status_id=21&status=CHARGED&order_id=hyperorder75189&signature=6O7eP9XnT0BVyaBgdjL92xSwBpeUjgs85VuxecfRd2c%3D&signature_algorithm=HMAC-SHA256", "realtime": { "requestId": "d5de7279-7eff-4ebb-9510-54053298f723", "merchantId": "picasso", "customerId": "balas0011@gmail.com", "clientId": "picasso_android", "environment": "production", "merchantLoader": "false", "isWrapper": "false", "lastVisitedUrl": "https://test.payu.in/0f573e02a5c1ca13e6b0594af4252a1ca42e1602f8da237d0f9a15dc2802bcad/CommonPgResponseHandler.php" } } }, "errorCode": "", "errorMessage": "" } ``` --- ## See Also - [Cards - New Cards](https://juspay.io/in/docs/ec-headless/android/payloads/cards--new-cards) - [CVV Less Flow](https://juspay.io/in/docs/ec-headless/android/payloads/cvv-less-flow)