GET
/
v1
/
transactions
/
accounts
/
single
curl --request GET \
  --url https://api.nomba.com/v1/transactions/accounts/single \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountid>'
{
  "code": "00",
  "description": "Success",
  "data": {
    "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"
  }
}

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.

Query Parameters

transactionRef
string

Transaction ID/Reference

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 a single transaction on an account