Report end state

POST /v1/transactions/{id}/report

Report your end state of a transaction. This is optional but highly recommended to improve the quality of the fraud detection. termination_reason can only be set if state is `terminated.

Valid transitions include (NONE means no prior reported state):

  • NONE -> terminated
  • NONE -> completed
  • completed -> reconciled
  • reconciled -> completed
  • terminated -> completed

Path parameters

  • id string Required

    transaction id

application/json

Body Required

  • state string Required

    Values are completed, terminated, or reconciled.

  • termination_reason string

    Values are quota, qualification, or quality.

Responses

  • 200 application/json

    OK

    Hide response attribute Show response attribute object
    • data object

      Additional properties are allowed.
POST /v1/transactions/{id}/report 
curl \
 -X POST https://api.fraud.ink/v1/transactions/{id}/report \
 -H "Content-Type: application/json" \
 -d '{"state":"completed","termination_reason":"quota"}'
Request examples 
{
  "state": "completed",
  "termination_reason": "quota"
}
Response examples (200) 
{
  "data": {}
}