---
updatedAt: 2026-09-08T22:12:46.000Z
agentTools:
  projectIndex: https://developers.virtualincentives.com/llms.txt
---

# Activate Card by PAN (Prepaid)

**Endpoint:** `https://rest.virtualincentives.com/{version}/{format}/activate`

**Method:** `POST`

# Definitions

| Field       | Type                               | Description                                                                                                                                                                                  |
| ----------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pan         | **required**<br />string(16)       | 16-digit card number.                                                                                                                                                                        |
| expiration  | **required**<br />string(4)        | Card expiration<br />Format: MM/yy                                                                                                                                                           |
| cvv         | **required**<br />string(3)        | Card verification value.                                                                                                                                                                     |
| pin         | **required**<br /> string(4)       | 4-digit personal identification number assigned to the card to verify point-of-sale Debit transactions. Repeating numbers (e.g., 2222) and consecutive numbers (e.g., 1234) are not allowed. |
| recipientid | **response only**<br /> integer    | The unique id for this recipient.                                                                                                                                                            |
| state       | **response only**<br /> string(50) | Current state of the card after activation request: Active, Suspended, or Terminated.                                                                                                        |

# Examples

## Request XML

```text
<card>
   <pan>1111118227125246</pan>
   <cvv>147</cvv>
   <expiration>1022</expiration>
   <pin>1597</pin>
</card>
```

## Request JSON

```text
{
  "card": {
    "pan": "1111118227125246",
    "cvv" : "147",
    "expiration": "1022",
    "pin":"1597"
  }
}
```

## Response XML

```text
<card>
   <pan>1111118227125246</pan>
   <cvv>147</cvv>
   <expiration>1022</expiration>
   <pin>1597</pin>
   <recipientid>2654789</recipientid>
   <state>ACTIVE</state>
</card>
```

## Response JSON

```text
{
  "card": {
    "pan": "1111118227125246",
    "cvv" : "147",
    "expiration": "1022",
    "pin":"1597",
    "recipientid" : "2654789",
    "state": "ACTIVE"
  }
}
```