Order Refund/Chargeback Status

Set the refund/chargeback status for a given order.
Can also optionally set the chargeback code.
Key Name values must be lower case. TRANSACTION_ID (i.e. 79700W3CKRDD) and Flag (C or R) values must be upper case

Endpoints

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

Usage

Usage for HTTP POST

Key Name: rfcb[TRANSACTION_ID]: Refund or Chargeback flag: R|C (Required)
Key Name: cbcode[TRANSACTION_ID]: Chargeback reason code (for rfcb 'C' only, optional)

The query string parameters rfcb and cbcode should always be treated as "arrays" with the order number as the key. These are case sensitive!

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 [XML]

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

Successful Response [JSON]

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

Code Examples

POST

curl -d "rfcb[TRANSACTION_ID]=C" \
     -d "cbcode[TRANSACTION_ID]=37" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/orders/rfcb.xml

POST (batch)

curl -d "rfcb[TRANSACTION_ID]=C" \
     -d "cbcode[TRANSACTION_ID]=37" \
     -d "rfcb[TRANSACTION_ID]=C" \
     -d "cbcode[TRANSACTION_ID]=83" \
     -d "rfcb[TRANSACTION_ID]=R" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/orders/rfcb.xml