---
page_source: https://juspay.io/sea/docs/express-checkout-sdk-global/react-native/base-sdk-integration/2a-cards
page_title: 5.2a Cards
---


# Cards




### Card Txn - New Substep


This action starts a new card transaction with THREE_DS authentication. NOTE: The 'tokenize' and 'cardNickName' params are optional. The 'tokenize' param should be passed only when the card needs to be tokenized and the customer has given consent for tokenization.




### Card Txn - Saved Substep


This action starts a saved card transaction with THREE_DS authentication. Refer to 'Card - List Saved' operation to find how to get saved card information. 

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






### EMI Txn - New Card Substep


This action starts an EMI based txn using new card.Please refer to [this page](https://docs.juspay.in/api-reference-global/docs/express-checkout/credit--debit-card-transaction) for valid combinations of emiBank and emiTenure.




### EMI Txn - Saved Card Substep


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

Please refer to [this page](https://docs.juspay.in/api-reference-global/docs/express-checkout/credit--debit-card-transaction) for valid combinations of emiBank and emiTenure.

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






### Card Mandate Substep


This action starts a card mandate registration transaction.



Detailed Note on the payload parameters can be referred [here](https://juspay.io/sea/docs/express-checkout-sdk-global/react-native/payloads/cards-integration-workflow)

## Sample Code Snippets:
### Sample Request:

#### Card Txn - New Code Snippet:

```card txn - new
{
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.hyperapi",
    "payload": {
        "action": "cardTxn",
        "orderId": "hyperorder45314",
        "endUrls": [
            "https:\\/\\/shop\\.merchant\\.com\\/payments\\/handleResponse.*"
        ],
        "paymentMethod": "VISA",
        "cardNumber": "4622540011002200",
        "cardExpMonth": "05",
        "cardExpYear": "25",
        "cardSecurityCode": "123",
        "saveToLocker": true,
        "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213",
        "tokenize": true,
        "cardNickName": "User - BANK1"
    }
}
```

#### 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 - New Card Code Snippet:

```emi txn - new card
{
    "requestId": "eee6f65e-23dc-42e1-ad7c-ec3cddd64ac9",
    "service": "in.juspay.hyperapi",
    "payload": {
        "action": "cardTxn",
        "orderId": "hyperorder45314",
        "clientAuthToken": "tkn_0e37edc631d647fdb606ab48ccfc4213",
        "endUrls": [
            "https:\\/\\/shop\\.merchant\\.com\\/payments\\/handleResponse.*"
        ],
        "paymentMethod": "MASTERCARD",
        "cardNumber": "4622540011002200",
        "cardExpMonth": "05",
        "cardExpYear": "25",
        "cardSecurityCode": "123",
        "saveToLocker": true,
        "nameOnCard": "Test Customer",
        "emiBank": "BANK1",
        "isEmi": true,
        "emiTenure": 3
    }
}
```

#### 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
    }
}
```

#### Card Mandate Code Snippet:

```card mandate
{
    "requestId": "9ce6c34b-d200-4222-a2d7-13d683ac4a4d",
    "service": "in.juspay.hyperapi",
    "payload": {
      "clientAuthToken": "tkn_997d200379944f8fa0c21c6b8dad8221",
      "action": "cardTxn",
      "orderId": "hyperorder79736",
      "endUrls": [
        "https://api.juspay.in/end"
      ],
      "paymentMethod": "VISA",
      "cardNumber": "4************4",
      "cardExpMonth": "04",
      "cardExpYear": "26",
      "cardSecurityCode": "***",
      "shouldCreateMandate": true,
      "saveToLocker": true,
      "merchantId": "picasso"
    }
}
```

### Sample Response:

#### Card Txn - New:
```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": ""
}
```

#### 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 - New 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": ""
}
```

#### 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": ""
}
```

#### Card Mandate:
```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": ""
}
```