POST
/
v1
/
payments
/
requests
/
status
curl --request POST \
  --url https://api.next.orenda.finance/v1/payments/requests/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentIds": [
    "fb2ce71e-fce7-44a0-a677-c7d69c3e40ab"
  ],
  "status": "COMPLETED"
}
'
{
  "success": true
}
{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}
{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}
{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
programId
string
required

The program the request is scoped to. Required on every endpoint.

Body

application/json
​
paymentIds
string[]
required

Payment-request IDs to resolve (up to 50).

Required array length: 1 - 50 elements
Example:
["fb2ce71e-fce7-44a0-a677-c7d69c3e40ab"]
​
status
enum<string>
required

COMPLETED approves the request (payment proceeds); FAILED rejects it.

Available options:
COMPLETED,
FAILED
​
errorReason
string

Reason stored on the request's history. Only applies when status is FAILED; ignored for COMPLETED.

Example:

"Rejected after manual review"

Response

Resolution recorded.

​
success
boolean
Example:

true