curl --request POST \
  --url https://api.nomba.com/v1/transactions/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "transactionRef": "POS-WITHDRAW-DFC05-693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
  "status": "SUCCESS",
  "source": "pos",
  "type": "withdrawal",
  "terminalId": "2KUD4AKB",
  "rrn": "230908202632",
  "merchantTxRef": "c90d-4b25-ad0f"
}'

{
  "code": "00",
  "description": "Success",
  "data": {
    "results": [
      {
        "id": "POS-WITHDRAW-DFC05-693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
        "status": "PAYMENT_FAILED",
        "amount": 4000,
        "fixedCharge": 123,
        "source": "pos",
        "type": "withdrawal",
        "gatewayMessage": "Insufficient funds",
        "customerBillerId": "539983 **** **** 5118",
        "timeCreated": "2023-09-08T19:26:34.657000Z",
        "posTid": "2KUD4AKB",
        "terminalId": "2KUD4AKB",
        "providerTerminalId": "2KUD4AKB",
        "rrn": "230908202632",
        "posSerialNumber": "91230309116826",
        "posTerminalLabel": "KEB MUSA ABUBAKAR",
        "stan": "556734",
        "paymentVendorReference": "2KUD4AKB230908202632",
        "userId": "dfc05ca1-4e75-41dd-8e41-2d362d565893",
        "posRrn": "230908202632",
        "merchantTxRef": "c90d-4b25-ad0f"
      }
    ],
    "cursor": "xchbaVFsjdsbaADddd"
  }
}

Filter transactions on the parent account

Filter transactions on a sub-account

You can easily filter transactions using the merchantTxRef which is the reference you pass in upon creating transactions via the Nomba API. This is a quick way to reconcile on your end.

​
POST /v1/transactions/accounts

​
Query parameters

​
limit
integer
This endpoint is paginated. limit describes the size of the page you are querying.
​
cursor
string
The cursor is used to scroll to the next page. When making the first call to list all accounts, there is no need to pass in any cursor since the API has not returned any cursor back to you. Only use cursor when the API provides it. For more information, please see Pagination
​
dateFrom
string
This starting date. (in UTC)
​
dateTo
string
This ending date. (in UTC)

​
Request body

​
transactionRef
string
The transaction ID/Reference.
​
status
string
The transaction status.
​
source
string
The transaction source.
​
type
string
The transaction type.
​
terminalId
string
The terminal ID that carried out the transaction.
​
rrn
string
The RRN (Retrieval Reference Number) of the transaction.
​
merchantTxRef
string
The merchant transaction reference of the transaction.

​
Response body

​
code
string
required
Response code
​
description
string
required
Response description
​
data
object
required
curl --request POST \
  --url https://api.nomba.com/v1/transactions/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "transactionRef": "POS-WITHDRAW-DFC05-693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
  "status": "SUCCESS",
  "source": "pos",
  "type": "withdrawal",
  "terminalId": "2KUD4AKB",
  "rrn": "230908202632",
  "merchantTxRef": "c90d-4b25-ad0f"
}'

{
  "code": "00",
  "description": "Success",
  "data": {
    "results": [
      {
        "id": "POS-WITHDRAW-DFC05-693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
        "status": "PAYMENT_FAILED",
        "amount": 4000,
        "fixedCharge": 123,
        "source": "pos",
        "type": "withdrawal",
        "gatewayMessage": "Insufficient funds",
        "customerBillerId": "539983 **** **** 5118",
        "timeCreated": "2023-09-08T19:26:34.657000Z",
        "posTid": "2KUD4AKB",
        "terminalId": "2KUD4AKB",
        "providerTerminalId": "2KUD4AKB",
        "rrn": "230908202632",
        "posSerialNumber": "91230309116826",
        "posTerminalLabel": "KEB MUSA ABUBAKAR",
        "stan": "556734",
        "paymentVendorReference": "2KUD4AKB230908202632",
        "userId": "dfc05ca1-4e75-41dd-8e41-2d362d565893",
        "posRrn": "230908202632",
        "merchantTxRef": "c90d-4b25-ad0f"
      }
    ],
    "cursor": "xchbaVFsjdsbaADddd"
  }
}