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

# Activate Card by Barcode (Post-paid)

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

**Method:** `PUT`

# Definitions

| Field       | Type                               | Description                                                                                                                                                                                  |
| ----------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| amount      | **required**<br />decimal          | The `amount` Denomination of the reward being issued. <br /> **Note:** Currency is determined by the SKU requested.                                                                          |
| 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. |
| barcode     | **response only**<br /> integer    | The unique id assigned to the card carrier’s barcode.                                                                                                                                        |
| recipientid | **response only**<br /> integer    | The unique id for this recipient.                                                                                                                                                            |
| balance     | **response only**<br /> decimal    | Remaining card balance                                                                                                                                                                       |
| state       | **response only**<br /> string(50) | Current state of the card after activation request: Active, Suspended, or Terminated.                                                                                                        |

# Examples

## Request XML

```text
<card>
   <amount>1.00</amount>
   <pin>1597</pin>
</card>
```

## Request JSON

```text
{
  "card": {
    "amount": 1.00,
    "pin":"1597"
  }
}
```

## Response XML

```text
<card>
   <barcode>5789654132687</barcode>
   <pin>1597</pin>
   <recipientid>2654789</recipientid>
   <balance>1.00</balance>
   <state>ACTIVE</state>
</card>
```

## Response JSON

```text
{
  "card": {
    "barcode": "5789654132687",
    "pin":"1597",
    "recipientid" : "2654789",
    "balance": 1.00,
    "state": "ACTIVE"
  }
}
```