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
​
client_id
string
required

Client identifier

​
sender
string
required

Sender's entity title

​
timestamp
integer
required

Timestamp of the request

​
salt
string
required

Salt for the request

​
signature
string
required

Signature for the request

​
params
object
required

Response

200
application/json
Success
​
success
boolean
Example:

true

​
message
string
Example:

"Transaction data fetched successfully."

​
data
object
Example:
{
  "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"
}