> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/cards/providus/linkinstantcard.md).

# LinkInstantCard

The "LinkInstantCard" endpoint allows customers to link an account to an instant card by providing the card's details and the cardholder's personal information.

<mark style="color:yellow;">`POST`</mark> `/api/Card/v{{version}}/Providus/LinkInstantCard`

{% hint style="info" %}
NB: An instant card is a card which has to have an account tied to it when the card is being requested. On linking the card to the account, you are expected to print the customer's name on the blank card using your card printing machine.
{% endhint %}

To link an account to an instant card, provide the `cardId`, the cardholder's name and personal details (`nameOnCard`, `firstName`, `lastName`, `dob`, address fields), contact details (`phoneNumber`, `email`), the `accountNumber` to link, and the card's `expiration` and `cardPan`.

**Headers**

| Name                                           | Value              |
| ---------------------------------------------- | ------------------ |
| Content-Type<mark style="color:red;">\*</mark> | `application/json` |
| Request-Reference                              | `unique_string`    |

**Body**

<table><thead><tr><th>Name</th><th>Data Type</th><th data-type="checkbox">Required/Optional</th><th>Description</th></tr></thead><tbody><tr><td><code>cardId</code></td><td><em>string</em></td><td>true</td><td>Id of the card to issue.</td></tr><tr><td><code>nameOnCard</code></td><td><em>string</em></td><td>true</td><td>The name to be printed on the card.</td></tr><tr><td><code>firstName</code></td><td><em>string</em></td><td>true</td><td>The cardholder's first name.</td></tr><tr><td><code>lastName</code></td><td><em>string</em></td><td>true</td><td>The cardholder's last name.</td></tr><tr><td><code>dob</code></td><td><em>string</em></td><td>true</td><td>The cardholder's date of birth.</td></tr><tr><td><code>address2</code></td><td><em>string</em></td><td>true</td><td>The cardholder's address.</td></tr><tr><td><code>city</code></td><td><em>string</em></td><td>true</td><td>The cardholder's city.</td></tr><tr><td><code>countryCode</code></td><td><em>string</em></td><td>true</td><td>The cardholder's country code.</td></tr><tr><td><code>phoneNumber</code></td><td><em>string</em></td><td>true</td><td>The cardholder's phone number.</td></tr><tr><td><code>accountNumber</code></td><td><em>string</em></td><td>true</td><td>The account number to link to the card.</td></tr><tr><td><code>email</code></td><td><em>string</em></td><td>true</td><td>The cardholder's email address.</td></tr><tr><td><code>expiration</code></td><td><em>string</em></td><td>true</td><td>The card's expiration date.</td></tr><tr><td><code>cardPan</code></td><td><em>string</em></td><td>true</td><td>The card's Primary Account Number (PAN).</td></tr></tbody></table>

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseUrl}}/api/Card/v{{version}}/Providus/LinkInstantCard' \
--header 'Content-Type: application/json' \
--data-raw '{
  "cardId": "23455667",
  "nameOnCard": "Test Max",
  "firstName": "Kay",
  "lastName": "Wizzle",
  "dob": "0539",
  "address2": "Test Add",
  "city": "Test City",
  "countryCode": "234",
  "phoneNumber": "23400000000",
  "accountNumber": "1234567890",
  "email": "dev@anything.com",
  "expiration": "1127",
  "cardPan": "506125666000000"
}'
```

</details>

<details>

<summary>Response: <code>200</code></summary>

```json
{
  "status": true,
  "message": "Request Successful",
  "data": {
    "success": true
  }
}
```

</details>