VIP Gift Card

Query, and manage (add/remove/update) the VIP status for the GIFT payment type only (PTYP = GIFT).
GIFT_CARD_NUMBER (i.e. 5F67753832224611BF697A590316AA34) and STATUS (i.e. R, D, X) values must be upper case

Endpoints

/rpc/v1/vip/gift.html: The browsable documentation for this API endpoint.
/rpc/v1/vip/gift.json: Endpoint that will return a JSON response.
/rpc/v1/vip/gift.xml: Endpoint that will return an XML response.

Usage

Usage for HTTP POST

Key Name: ptok[GIFT_CARD_NUMBER]: Gift card status (R|D|X) to be set

The parameter ptok should always be treated as an array. The gift card number is the key, and either (R)eview, (D)ecline, or (X)delete as the value. Some examples using curl are provided below. These are case sensitive!

Error Codes

200 Success: Request completed
206 Partial Success: In batch requests, this signifies that there were a mix of successes and failures
401 Authentication: The key provided could not be authenticated
404 Not Found: PTOK not found

Response Samples

Successful Response [XML]

<?xml version="1.0" encoding="UTF-8"?>
<response>
 <status>ok</status>
 <count>
  <success>1</success>
  <failure>0</failure>
 </count>
 <errors/>
 <result>review</result>
</response>

Successful Response [JSON]

{"status":"ok","count":{"success":1,"failure":0},"errors":[],"result":"{\"status\":\"ok\",\"errors\":[],\"result\":\"review\"}"}

Code Examples

POST

curl -d "ptok[6011518688317697]=R" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/vip/gift.xml

POST (batch)

curl -d "ptok[6011904894096699]=R" \
     -d "ptok[6011255117418826]=D" \
     -d "ptok[6011106543032220]=X" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/vip/gift.json