v1

latestOpenAPI 3.0.02026-08-06102185472.3 KB
Orchestration payments

Get orchestration payments

Gets a list of orchestration payments.

get/v4/orchestration/payment

Query parameters

pageinteger

The page number for paginated results.

The value is zero-based, where 0 represents the first page.

Set it to 0 to get the first page of results.

sizeinteger

Number of objects to return per page.

sort_field'CREATED_AT' | 'MODIFIED_AT'

Attribute to sort the results on.

Enum:Sort by
CREATED_ATCreated date-time
MODIFIED_ATModified date-time
sort_direction'ASC' | 'DESC'

Direction of sorted results based on sort_field.

Enum:Description
ASCSort ascending
DESCSort descending
unique_reference_numberstring

Parameter for filtering with unique reference number.

orchestration_status'INITIAL' | 'RUNNING' | 'COMPLETED' | 'PAUSED' | 'FAILURE' | 'DECLINED' | 'RETRY'

Parameter for filtering with status of the orchestration payment.

EnumDescription
INITIALFilter by payments in the initial state
RUNNINGFilter by payments in the running state
COMPLETEDFilter by completed payments
PAUSEDFilter by paused payments
FAILUREFilter by payment failures
DECLINEDFilter by declined payments
RETRYFilter by payments that have a retry status
range_fieldstring

Range field

Designates the column name of the payments database table that is used for filtering payments before/after/between time stamps.

The following options are valid:

Range fieldDescription
CREATED_ATFilter by created date-time
MODIFIED_ATFilter by modified date-time

Example usage

If you specify range_field = MODIFIED_AT, you need to specify a time stamp (in the 24 character ISO 8601 format used in payment objects: YYYY-MM-DDTHH:mm:ss.sssZ) as the value for before and/or after to fetch payments before, after, or between the specified time range(s) (inclusive).

Dependency: If you specify range_field, you must also specify before and/or after.

beforestring

Before time stamp

Filters for payments where the range_field column value is before this specified time stamp (inclusive).

You can also specify after to create a time range between after and before.

Dependency: If you specify before, you must also specify range_field.

Example: 2023-10-13T10:16:29.000Z

afterstring

After time stamp

Filters for payments where the range_field column value is after this specified time stamp (inclusive).

You can also specify before to create a time range between after and before.

Dependency: If you specify after, you must also specify range_field.

Example: 2023-10-13T10:16:29.000Z

Response

Successfully fetched all orchestration payments.

firstboolean

true if this is the first page.

lastboolean

true if this is the last page.

numberinteger

page number

numberOfElementsinteger

Number Of elements in this request

sizeinteger

page size

totalElementsinteger

Total number of elements for the given request

totalPagesinteger

Total number of pages for the given request

Example response

{
  "sort": [
    {
      "direction": "ASC",
      "nullHandling": "NULLS_FIRST",
      "ascending": true
    }
  ],
  "content": [
    {
      "uuid": "5492648d-2132-4e70-9ded-2fc86f22b321",
      "unique_reference_number": "00310000015",
      "sender_end_to_end_id": "00310000015",
      "payment_id": "26bf269b-1a2b-c3d4-872a-7f18d7dcf9f2",
      "payment_status": "SUCCESS",
      "previous_payment_status": "EXECUTED",
      "orchestration_template": "default_template",
      "orchestration_status": "RUNNING",
      "current_activity": "get_quote_v1",
      "current_activity_status": "SUCCESS",
      "created_at": "2018-04-06T20:33:35Z",
      "modified_at": "2018-04-06T20:33:35Z"
    }
  ]
}