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

Method: PUT

Definitions

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

Examples

Request XML

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

Request JSON

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

Response XML

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

Response JSON

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