Transaction Status
Get Transaction Status
Authentication
- Generate Signature
- Verify Signature
Collections
- Unified Collections
- Payment Links
Disbursements
- Unified Payments
Account Balance
Transaction Status
Transaction Status
Get Transaction Status
POST
/
api
/
v2
/
get-unified-transaction-status
curl --request POST \
--url https://dev.users.niobi.co/api/v2/get-unified-transaction-status \
--header 'Content-Type: application/json' \
--data '{
"client_id": "<string>",
"sender": "<string>",
"timestamp": 123,
"salt": "<string>",
"signature": "<string>",
"params": {
"id": "<string>"
}
}'
{
"success": true,
"message": "Transaction data fetched successfully.",
"data": {
"amount": 5,
"fee": 5,
"currency": "USD",
"status": "success",
"payee": "Notification Tester",
"invoice_no": "PAY-738525",
"mobile": "+2547408000000",
"account_number": "1234",
"ref": "03024080611FMOSE",
"balance": 661,
"transaction_detail": "Disbursement made through payment method",
"payment_channel": "Payment channel",
"transaction_date": "2024-08-06 00:00:00",
"created_at": "2024-06-06T11:58:12.000000Z",
"updated_at": "2024-06-06T11:58:27.000000Z",
"callback_url": "https://your-domain.com/niobi/result"
}
}
Please ensure that a new signature
is generated each time you create a transaction status request
Body
application/json
Data needed for unified transaction status
The body is of type object
.
Response
200
application/json
Success
The response is of type object
.
curl --request POST \
--url https://dev.users.niobi.co/api/v2/get-unified-transaction-status \
--header 'Content-Type: application/json' \
--data '{
"client_id": "<string>",
"sender": "<string>",
"timestamp": 123,
"salt": "<string>",
"signature": "<string>",
"params": {
"id": "<string>"
}
}'
{
"success": true,
"message": "Transaction data fetched successfully.",
"data": {
"amount": 5,
"fee": 5,
"currency": "USD",
"status": "success",
"payee": "Notification Tester",
"invoice_no": "PAY-738525",
"mobile": "+2547408000000",
"account_number": "1234",
"ref": "03024080611FMOSE",
"balance": 661,
"transaction_detail": "Disbursement made through payment method",
"payment_channel": "Payment channel",
"transaction_date": "2024-08-06 00:00:00",
"created_at": "2024-06-06T11:58:12.000000Z",
"updated_at": "2024-06-06T11:58:27.000000Z",
"callback_url": "https://your-domain.com/niobi/result"
}
}