Skip to main content
POST
/
api
/
v3
/
get-unified-transaction-status
Fetch unified transaction status (v3)
curl --request POST \
  --url https://sandbox.users.niobi.co/api/v3/get-unified-transaction-status \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": "<string>",
  "sender": "<string>",
  "timestamp": 123,
  "salt": "<string>",
  "signature": "<string>",
  "params": {
    "id": "<string>",
    "type": "payin/payout"
  }
}
'
{
  "success": true,
  "message": "Transaction data fetched successfully.",
  "data": {
    "amount": "987",
    "fee": 10,
    "currency": "KES",
    "status": "success",
    "payee": "N/A",
    "invoice_no": "N/A",
    "mobile": "2547xxxxxxx",
    "account_number": "N/A",
    "ref": "NIO-SXXXXX",
    "balance": "N/A",
    "transaction_detail": "N/A",
    "payment_channel": "SENDMONEY",
    "transaction_date": "2026-05-19T04:34:42.000000Z",
    "created_at": "2026-05-19T04:34:42.000000Z",
    "updated_at": "2026-05-19T04:45:41.000000Z",
    "callback_url": "https://webhook.site/<REDACTED>",
    "status_code": "000006",
    "failureReason": {
      "failureCode": null,
      "failureMessage": null
    }
  }
}
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 (v3)

​
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

Success

​
success
boolean
Example:

true

​
message
string
Example:

"Transaction data fetched successfully."

​
data
object
Example:
{
  "amount": "987",
  "fee": 10,
  "currency": "KES",
  "status": "success",
  "payee": "N/A",
  "invoice_no": "N/A",
  "mobile": "2547xxxxxxx",
  "account_number": "N/A",
  "ref": "NIO-SXXXXX",
  "balance": "N/A",
  "transaction_detail": "N/A",
  "payment_channel": "SENDMONEY",
  "transaction_date": "2026-05-19T04:34:42.000000Z",
  "created_at": "2026-05-19T04:34:42.000000Z",
  "updated_at": "2026-05-19T04:45:41.000000Z",
  "callback_url": "https://webhook.site/<REDACTED>",
  "status_code": "000006",
  "failureReason": {
    "failureCode": null,
    "failureMessage": null
  }
}