Order Status

Set the status for a given order.
Can also optionally add a note.
TRANSACTION_ID (i.e. 79700W3CKRDD) and STATUS (i.e. R, E, D, A) values must be upper case

Endpoints

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

Usage

Usage for HTTP POST

Key Name: status[TRANSACTION_ID]
Status code: Status is A | E | R | D, for Approve, Escalate, Review and Decline.
Key Name: reason[TRANSACTION_ID]
Reason code: Optional, but it must be valid for the given status code if both are provided.
Key Name: agent[TRANSACTION_ID]
Agent email address to which order is assigned (must have a login created within Kount. Permissions for the user are not checked when assignment occurs, meaning a User with Employee permissions could have an order assigned to them)
Key Name: note[TRANSACTION_ID]
Note text
The query string parameters status, agent, reason and note should always be treated as "arrays" with the transaction id 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 [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":["Assigned to KJM (KJM)."]}

Code Examples

POST
curl -d "status[TRANSACTION_ID]=R" \
     -d "agent[TRANSACTION_ID]=joe@company.com" \
     -d "note[TRANSACTION_ID]=Testing" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/orders/status.json
POST (batch)
curl -d "status[TRANSACTION_ID]=R" \
     -d "agent[TRANSACTION_ID]=joe@company.com" \
     -d "note[TRANSACTION_ID]=Testing" \
     -d "status[TRANSACTION_ID]=E" \
     -d "agent[TRANSACTION_ID]=bob@company.com" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/orders/status.json