Skip to content
StraventaDocs

Submit a case disposition

The maker step. By default the disposition lands `pending_approval` for a distinct checker. When `single_reviewer` is true the low-risk one-person path closes the case immediately — REJECTED with `dual_control_required` on a freeze-triggered AML case. The actor is taken from the JWT subject. Requires `fraud.cases.write`.

POST
/v1/fraud/cases/{id}/disposition

The maker step. By default the disposition lands pending_approval for a distinct checker. When single_reviewer is true the low-risk one-person path closes the case immediately — REJECTED with dual_control_required on a freeze-triggered AML case. The actor is taken from the JWT subject. Requires fraud.cases.write.

Authorization

bearerAuth
AuthorizationBearer <token>

PayOps platform JWT issued by the auth-service. The tenant_id claim is extracted server-side; callers do NOT send tenant_id in the request body.

In: header

Path Parameters

id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/fraud/cases/497f6eca-6276-4993-bfeb-53cbbbba6f08/disposition" \  -H "Content-Type: application/json" \  -d '{    "disposition": "sar_ready",    "reason": "structuring pattern detected",    "single_reviewer": false  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "case_id": "c74269e5-1f97-4e20-9164-ffbe3494d8d6",
  "action": "created",
  "state": "pending_approval",
  "disposition": "clear",
  "reason": "string",
  "submitted_by": "6703ac2f-9eb5-40e9-9fde-511b2dbf4be5",
  "approved_by": "02030314-b162-4b4d-8af1-88eabdcc615d",
  "created_at": "2019-08-24T14:15:22Z"
}
{
  "error": "validation_failed",
  "message": "required field 'value' is missing",
  "request_id": "01JA8BHN2P0ECTXN3J6TBKMS7Q"
}
{
  "error": "forbidden",
  "message": "missing required permission: fraud.rules.write",
  "request_id": "01JA8BHN2P0ECTXN3J6TBKMS7Q"
}
{
  "error": "not_found",
  "message": "rule not found",
  "request_id": "01JA8BHN2P0ECTXN3J6TBKMS7Q"
}
{
  "error": "self_approval_forbidden",
  "message": "a disposition cannot be approved or rejected by its submitter",
  "request_id": "01JA8BHN2P0ECTXN3J6TBKMS7Q"
}

Was this page helpful?