POST
/
v1
/
transactions
/
accounts
/
{accountId}
curl --request POST \
  --url https://api.nomba.com/v1/transactions/accounts/{accountId} \
  --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",
  "orderReference": "693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
  "orderId": "285e4ad2-665f-453b-8795-e854cab5757b"
}'
{
  "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"
  }
}

Authorizations

Authorization
string
headerrequired

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

accountId
string
required

The parent accountId of the business.

Path Parameters

accountId
string
required

The accountId whose terminals are to be fetched.

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

dateFrom
string

This starting date (UTC)

dateTo
string

This ending date

Body

application/json
transactionRef
string

Transaction ID/Reference

status
enum<string>

Transaction status

Available options:
NEW,
PENDING_PAYMENT,
PAYMENT_SUCCESSFUL,
PAYMENT_FAILED,
PENDING_BILLING,
SUCCESS,
REFUND
source
enum<string>

Transaction source

Available options:
api,
pos,
web,
android_app,
ios_app
type
enum<string>

Transaction type

Available options:
withdrawal,
purchase,
transfer,
p2p,
online_checkout,
qrt_credit,
qrt_debit
terminalId
string

Terminal ID

rrn
string

RRN (Retrieval Reference Number)

merchantTxRef
string

Merchant transaction reference

orderReference
string

Online checkout order reference

orderId
string

Online checkout order id

Response

200 - application/json
code
string
required

Response Code

description
string
required

Response description

data
object
required
Fetch transactions on an accountFetch transactions on the parent account