v1

latestOpenAPI 3.0.12026-07-225791279.7 KB

Split Settlements

Fetch Split Accounts

This retrieves all split settlement accounts belonging to the authenticated merchant.

get/settlement/settlement/merchant/split-account?page=&size=

Query parameters

pageinteger required

The page number to retrieve.

sizeinteger required

The number of records per page.

Response

Fetch Split Accounts Response

codestring

System operational status response code tracking the request performance.

successboolean

Indicates if the request completed successfully.

errorstring nullable

Details regarding operational processing failure conditions. Returns null on success context.

messagestring

Descriptive message confirming the data extraction outcome.

Example response

{
  "code": "00",
  "success": true,
  "data": {
    "items": [
      {
        "id": 116,
        "account_no": "0223456789",
        "code": "SSA_C70E2C391783952664709",
        "account_name": "Jane Doe",
        "name": "Jane doe",
        "email": "janedoe@gmail.com",
        "bank_code": "123456",
        "bank_name": "YOUR BANK",
        "currency": "NGN",
        "country": "NGA",
        "split_type": "FLAT",
        "split_value": 3000,
        "active": true,
        "created_at": "2026-07-13T14:24:24.709239",
        "last_modified": "2026-07-13T14:24:24.713178"
      }
    ],
    "page": 1,
    "size": 2,
    "total_elements": 8,
    "total_pages": 4,
    "has_next": true
  },
  "message": "split accounts fetched successfully"
}