Introduction
- Welcome to Nomba
- Get API Keys
- Testing
Getting Started
- Dashboard Setup
- Authentication
- Definitions
Plugins and SDKs
Products
- Accounts
- Accept Payments
- Transfers
- Terminals
- Webhooks
- Transactions
- Airtime & Data Vending
- Cable & Bill Payments
Guides
API Patterns
Transaction Requery
Fetching a transaction information particularly for cases of status confirmation.
curl --request GET \
--url https://api.nomba.com/v1/transactions/requery/<sessionId> \
--header 'Authorization: Bearer <token>' \
--header 'accountId: <accountid>'
{
"code": "00",
"description": "Requery Successful",
"data": {
"id": "API-VACT_TRA-185C7-01964b64-5c0a-4c91-81b6-zxv7a421862b",
"status": "SUCCESS",
"amount": "200.0",
"fixedCharge": "1.0",
"source": "api",
"type": "vact_transfer",
"customerBillerId": "0122408496",
"timeCreated": "2024-07-11T16:12:49.656Z",
"walletBalance": "1648.79",
"billingVendorReference": "029004810da38748e93ca4a9",
"paymentVendorReference": "000132891359184717316165338085",
"userId": "185c75d9-6ae0-675r-950e-425666184ed6",
"ktaSenderName": "Smart Hamzat",
"ktaSenderAccountNumber": "0122408496",
"ktaSenderBankCode": "Amucha MFB (Nomba)",
"recipientAccountNumber": "0014701211",
"recipientAccountType": "VIRTUAL",
"senderName": "Smart Hamzat",
"bankCode": "090645",
"productId": "090645",
"isAgentTransaction": true,
"isInternational": false,
"customerCommission": 0,
"recipientAccountName": "John Amazing Doe",
"sessionId": "000132891359184717316165338085",
"accountNumber": "0122408496",
"bankName": "Amucha (Nomba)"
}
}
GET /v1/transactions/requery/<sessionId>
Path parameters
Session Id of the transaction
Response body
Response code
Response description
The transaction ID.
The transaction status.
The transaction amount.
The transaction fixed charge.
The transaction source.
The transaction type.
The customer biller ID.
The creation timestamp.
The wallet balance.
The billing vendor reference.
The payment vendor reference.
The User ID.
The KTA sender name.
The KTA sender account number.
The KTA sender bank code.
The recipient account number.
The recipient account type.
The sender name.
The bank code.
The product ID.
Indicates if it’s an agent transaction.
Indicates if it’s an international transaction.
The customer commission.
The recipient account name.
The session ID.
The account number.
The bank name.
curl --request GET \
--url https://api.nomba.com/v1/transactions/requery/<sessionId> \
--header 'Authorization: Bearer <token>' \
--header 'accountId: <accountid>'
{
"code": "00",
"description": "Requery Successful",
"data": {
"id": "API-VACT_TRA-185C7-01964b64-5c0a-4c91-81b6-zxv7a421862b",
"status": "SUCCESS",
"amount": "200.0",
"fixedCharge": "1.0",
"source": "api",
"type": "vact_transfer",
"customerBillerId": "0122408496",
"timeCreated": "2024-07-11T16:12:49.656Z",
"walletBalance": "1648.79",
"billingVendorReference": "029004810da38748e93ca4a9",
"paymentVendorReference": "000132891359184717316165338085",
"userId": "185c75d9-6ae0-675r-950e-425666184ed6",
"ktaSenderName": "Smart Hamzat",
"ktaSenderAccountNumber": "0122408496",
"ktaSenderBankCode": "Amucha MFB (Nomba)",
"recipientAccountNumber": "0014701211",
"recipientAccountType": "VIRTUAL",
"senderName": "Smart Hamzat",
"bankCode": "090645",
"productId": "090645",
"isAgentTransaction": true,
"isInternational": false,
"customerCommission": 0,
"recipientAccountName": "John Amazing Doe",
"sessionId": "000132891359184717316165338085",
"accountNumber": "0122408496",
"bankName": "Amucha (Nomba)"
}
}
curl --request GET \
--url https://api.nomba.com/v1/transactions/requery/<sessionId> \
--header 'Authorization: Bearer <token>' \
--header 'accountId: <accountid>'
{
"code": "00",
"description": "Requery Successful",
"data": {
"id": "API-VACT_TRA-185C7-01964b64-5c0a-4c91-81b6-zxv7a421862b",
"status": "SUCCESS",
"amount": "200.0",
"fixedCharge": "1.0",
"source": "api",
"type": "vact_transfer",
"customerBillerId": "0122408496",
"timeCreated": "2024-07-11T16:12:49.656Z",
"walletBalance": "1648.79",
"billingVendorReference": "029004810da38748e93ca4a9",
"paymentVendorReference": "000132891359184717316165338085",
"userId": "185c75d9-6ae0-675r-950e-425666184ed6",
"ktaSenderName": "Smart Hamzat",
"ktaSenderAccountNumber": "0122408496",
"ktaSenderBankCode": "Amucha MFB (Nomba)",
"recipientAccountNumber": "0014701211",
"recipientAccountType": "VIRTUAL",
"senderName": "Smart Hamzat",
"bankCode": "090645",
"productId": "090645",
"isAgentTransaction": true,
"isInternational": false,
"customerCommission": 0,
"recipientAccountName": "John Amazing Doe",
"sessionId": "000132891359184717316165338085",
"accountNumber": "0122408496",
"bankName": "Amucha (Nomba)"
}
}