Activate by PAN (Post-paid)

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

Method: PUT

Definitions

FieldTypeDescription
panrequired
string(16)
16-digit card number.
expirationrequired
string(4)
Card expiration
Format: MM/yy
cvvrequired
string(3)
Card verification value.
amountrequired
decimal
The amount Denomination of the reward being used.
Note: Currency is determined by the SKU requested.
pinrequired
integer
4-digit personal identification number assigned to the card to verify point-of-sale Debit transactions.
recipientidresponse only
integer
The unique id for this recipient.
balanceresponse only
decimal
Remaining card balance.
stateresponse 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"
  }
}