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

Method: POST

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.
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>
</card>

Request JSON

{
  "card": {
    "pan": "1111118227125246",
    "cvv" : "147",
    "expiration": "1022"
  }
}

Response XML

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

Response JSON

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