---
page_source: https://juspay.io/sea/docs/express-checkout-sdk-global/capacitor/payloads/cards--saved-cards
page_title: Cards - Saved Cards
---


# 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.

> **Note**
> 1. Default value for 'showLoader' param, when not passed, is set to false.
> 2. The 'tokenize' param is optional and should be passed only when the card needs to be tokenized and the customer has given consent for tokenization.






### Step 1.1. EMI Txn - Saved Card


This action starts an EMI based txn using saved card. Refer to 'Card - List Saved' operation to find how to get saved card information. 

> **Note**
> Default value for 'showLoader' param, when not passed, is set to false.






### Step 1.1. 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
      - 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": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.hyperapi",
    "payload": {
        "action": "cardList",
        "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213"
    }
}
```

#### 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",
        "endUrls": [
            "https:\\/\\/shop\\.merchant\\.com\\/payments\\/handleResponse.*"
        ],
        "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",
        "endUrls": [
            "https:\\/\\/shop\\.merchant\\.com\\/payments\\/handleResponse.*"
        ],
        "cardToken": "tkn_844ce1fb-9810-4b87-82a5-c8a62b30ded0",
        "cardSecurityCode": "123",
        "isEmi": true,
        "emiBank": "BANK1",
        "emiTenure": 3,
        "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213",
        "showLoader": true
    }
}
```

### Sample Response:

#### Card - List Saved:
```json
{
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.hyperapi",
    "payload": {
        "action": "cardList",
        "merchantId": "picasso",
        "customerId": "test_customer_ns1",
        "cards": [
            {
                "nickname": "",
                "nameOnCard": "Amaresh",
                "expired": false,
                "cardType": "DEBIT",
                "cardToken": "934bad8b-a522-4e7f-8c13-a2337e2c5c0e",
                "cardReference": "afb0e819d00c1006f550d9f8ac37dde4",
                "cardNumber": "5419-XXXXXXXX-0636",
                "cardIssuer": "JP MORGAN",
                "cardIsin": "541919",
                "cardFingerprint": "43kvhke93lbfrvstuasd4imoot",
                "cardExpYear": "2023",
                "cardExpMonth": "04",
                "cardBrand": "MASTERCARD"
            }
        ]
    },
    "error": false,
    "errorCode": "",
    "errorMessage": ""
}
```

#### 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.pg.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.pg.in/0f573e02a5c1ca13e6b0594af4252a1ca42e1602f8da237d0f9a15dc2802bcad/CommonPgResponseHandler.php"
            }
        }
    },
    "errorCode": "",
    "errorMessage": ""
}
```