Get Card by PAN

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

Method: POST

Definitions

FieldTypeDescription
panrequired
string(16)
16-digit card number.
expirationrequired
string(4)
Card expiration
Format: MM/yy
cvvrequired
string(3)
Card verification value.
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>
</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"
  }
}