VIP Card

Set the VIP status for a given card.
CARD_NUMBER (i.e. 536009M2Y76DBH4N48YH) and STATUS (i.e. R, D, X) values must be upper case.
  • R = review
  • D = decline
  • X = delete

    • Endpoints

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

    Usage

    Usage for HTTP POST

    Key Name: ptok[CARD_NUMBER]
    Vip status code (R|D|X) (review, decline, or delete) to assign to payment token, where CARD_NUMBER is the payment token to add/update/delete.
    The query string parameter PTOK should always be treated as an "array" with the card number as the key.

    Some examples using curl are provided below.

    Error Codes

    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

    Response Samples

    Successful Response: POST [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: POST [JSON]
    {"status":"ok","count":{"success":1,"failure":0},"errors":[],"result":"review"}

    Code Examples

    POST
    curl -d "ptok[CARD_NUMBER]=R" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/vip/card.json
    POST (batch)
    curl -d "ptok[CARD_NUMBER]=R" \
     -d "ptok[CARD_NUMBER]=D" \
     -d "ptok[CARD_NUMBER]=X" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/vip/card.json