---
title: Card Replacement
description: This API is used for card replacement request with a new one.
---

This API is used for card replacement request with a new one. We must pass entity id, kit no, dob and expiry date in request. If the request has valid details, we will get a success response along with card no, cardtype, kit no and cvv.

post

```
https://kraken.airpay.co.in/airpay/ms/cards/api/card-replacement
```

## Header

| Field | Type | Description |
| --- | --- | --- |
| token | text | Will be provided by Airpay (length 10, required) |
| checksum | text | $string = $param.self::$secret_key; sha256(<concate all values+SECRET KEY>);(dynamic, required) |

## Parameter

| Field       | Type    | Required | Description                                          |
| ----------- | ------- | -------- | ---------------------------------------------------- |
| entity_id   | Text    | Yes      | Customer ID registered with the system (length 50)   |
| kit_no      | Text    | Yes      | Proxy card or kit number (length 16)                 |
| dob         | Date    | Yes      | Date of birth in `DDMMYYYY` format (length 10)       |
| expiry_date | Date    | Yes      | Expiry month and year in `YYMM` format (length 10)   |
| old_kit_no  | Text    | No       | Kit number of the old card that needs to be replaced |
| new_kit_no  | Numeric | No       | New kit number for the new card                      |

## Request-Example:

```
 curl --location --request POST 'https://kraken.airpay.co.in/airpay/ms/cards/api/gets-cvv' \
--header 'token: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'checksum: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'entity_id=91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--data-urlencode 'dob=10071998' \
--data-urlencode 'kit_no=100000001275' \
--data-urlencode 'expiry_date=2402'
```
## Request-Example:
```
curl --location --request POST 'https://kraken.airpay.co.in/airpay/ms/cards/api/card-replacement' \
--header 'token: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'checksum: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'entity_id=91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps'\
--data-urlencode 'old_kit_no=' \
--data-urlencode 'new_kit_no='
```

## Success 200

| Field | Type | Description |
| --- | --- | --- |
| status | numeric | 400- fail,200-success(length 3, required) |
| message | text | Success, Fail(required) |
| data | json | { "card_no": "462294XXXXXX3713", "card_type":"VIRTUAL", "kit_no":"123456789", "cvv": "186" }(required) |
## Success-Response:
```
{
    "status": 200,
    "message": "SUCCESS",
    "data": {
        "card_no": "462294XXXXXX3713",
        "card_type": "VIRTUAL",
        "kit_no": "123456789",
        "cvv": "186"
    }
}
```
## Success-Response:
```
{
    "status": 200,
    "message": "success",
    "data": []
}
```
## Fail-Response:

```
{
    "status": 400,
    "message": "fail"
}

/**
```
## Fail-Response:
```
{
    "status": 400,
    "message": "fail"
}
```