Settlement transactions represent inbound payments that have been fully cleared and credited to one of your accounts. Unlike the general transaction list, the settlements endpoint filters to confirmed credit events only, making it the right tool for end-of-day reconciliation and balance verification. Use the date range filters to scope results to a specific period and match settlements against your own records.
Endpoint POST https://baasapi.payrepmfb.com/api/v1/transaction/web/fetch_settlement_transactions
Sandbox POST https://shogun-dev.xchangeboxng.com/api/v1/transaction/web/fetch_settlement_transactions
Authentication Include your Bearer token in the Authorization header:
Authorization: Bearer <access_token>
Obtain a token by logging in via User Login .
Request body All filter criteria are nested inside a filters object.
Optional object containing filter criteria for the settlement query. Limit results to settlements for a specific 10-digit account number.
Return only settlements on or after this date. Format: YYYY-MM-DD.
Return only settlements on or before this date. Format: YYYY-MM-DD.
Filter to a single calendar day. Format: YYYY-MM-DD. When provided, takes precedence over start_date and end_date.
Fetch a specific settlement by its unique reference number.
Filter by settlement status. Typically success for cleared records.
Page number for paginated results. Starts at 1.
Number of records to return per page. Minimum 1.
Maximum number of results to return. Minimum 1.
Cursor for cursor-based pagination. Pass the created_at timestamp of the last item from the previous page.
Cursor ID paired with cursor_created_at for stable cursor-based pagination.
Example request curl --request POST \ --url https://baasapi.payrepmfb.com/api/v1/transaction/web/fetch_settlement_transactions \ --header 'Authorization: Bearer <access_token>' \ --header 'Content-Type: application/json' \ --data '{ "filters": { "account_number": "7801234567", "start_date": "2026-04-01", "end_date": "2026-04-28" }, "page": 1, "page_size": 20 }'
Response A successful response returns the standard envelope with an array of settlement records in data.
true when the request succeeded.
Human-readable status message.
Array of cleared settlement objects matching your filters. Unique reference for the settlement record. Use this to match against your own payment records.
The 10-digit account number that received the settlement credit.
The settled amount in NGN (e.g., "25000.00").
ISO 8601 timestamp of when the settlement was cleared and credited to the account.
Settlement status. A value of success confirms the credit has been applied to the account balance.
{ "status" : true , "response_code" : "00" , "message" : "Settlement transactions fetched successfully" , "data" : [ { "reference" : "STL-20260415-00056" , "account_number" : "7801234567" , "amount" : "25000.00" , "settlement_date" : "2026-04-15T14:00:00Z" , "status" : "success" } ] }
Error codes Code Meaning 00Success 41Customer not found — your session token is invalid or expired
