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

Method: PUT

Definitions

Field	Type	Description
pan	required string(16)	16-digit card number.
expiration	required string(4)	Card expiration Format: MM/yy
cvv	required string(3)	Card verification value.
amount	required decimal	The `amount` Denomination of the reward being used. 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.
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>
   <pan>1111118227125246</pan>
   <cvv>147</cvv>
   <expiration>1022</expiration>
   <amount>1.00</amount>
   <pin>1597</pin>
</card>

Request JSON

{
  "card": {
    "pan": "1111118227125246",
    "cvv" : "147",
    "expiration": "1022",
    "amount":1.00,
    "pin":"1597"
  }
}

Response XML

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

Response JSON

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