---
title: "List cross-tenant payments"
method: GET
path: "/eclipse-conductor/rest/v1/global/payments"
tags: ["z) Global Functionality"]
---

# List cross-tenant payments

`GET /eclipse-conductor/rest/v1/global/payments`

Returns a cross-tenant list of payments with optional filtering by status, date range, payment type, amount, bank account, and reference. Only available to administrators.

## Query parameters

- `amount` string
- `bankAccount` string
- `dateFilterOn` string
- `dateFromIncl` string
- `dateToExcl` string
- `limit` integer
- `offset` integer
- `onlyUnmatched` boolean
- `paymentReference` string
- `paymentType` string
- `status` string
- `walletId` integer

## Response `200`

OK

- EclipseGlobalPayment[]
  - `amount` number — Amount in the major currency unit e.g. 50.80 for 50 GBP and 80 pence
  - `authCode` string
  - `bankAccount` string
  - `bankName` string
  - `cardBin` string
  - `cardExpires` string, date-time
  - `cardLast4` string
  - `cardName` string
  - `cardPhone` string
  - `cardType` string
  - `completionUrl` string — URL to open in an iFrame or browser where customer can securely complete 3DS details if required. Normally this will not be provided until the payment has been posted/updated with sufficient data to be processable. However this is provided for GLOBAL_PAYMENT_LINK payments as these dont require further info from the API caller for the payment to be made
  - `created` string, date-time — When the payment was created
  - `currency` string — Currency of the transaction. E.g. USD, ZAR, NGN etc
  - `description` string
  - `errorDescription` string — This will only be populated if there was an error
  - `expires` string, date-time
  - `externalUniqueId` string
  - `gateway` string
  - `gatewayTransactionId` string — The transaction identifier for this payment as provided by the gateway itself
  - `paId` string
  - `paymentId` integer
  - `paymentReference` string
  - `status` 'BUILDING' | 'CANCELLED' | 'ERROR_PERM' | 'ERROR_TEMP' | 'PENDING' | 'REVERSED' | 'SUCCESSFUL' | 'TIMEOUT' — Status of a payment BUILDING: Not yet submitted as more data needs to be captured, PENDING:Being processed and can no longer be enhanced, SUCCESSFUL: Successfully completed, ERROR_PERM: Failed and wont ever succeed, ERROR_TEMP: Currently having an error but its being retried and may succeed or permanently fail, TIMEOUT: Failed as the process was not finalised in time, CANCELLED: Cancelled prior to SUCCESS or FAILURE, REVERSED: Reversed after success
  - `subType` string
  - `type` string
  - `walletId` integer

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.dev/eftcorp/apis/eclipse-rest-api.md) · [All operations](https://skmtc.dev/eftcorp/apis/eclipse-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eftcorp/eclipse-rest-api/revisions/9213d52d49a3/schema)