Get transaction
Transactions
Get Transaction
Retrieve the full details of a single transaction by its ID.
GET
Get transaction
Retrieve a transaction by ID. Use this to confirm status, display details, or reconcile payments.
When to use this endpoint
- Confirm final status when webhooks are unavailable
- Display transaction details in your application
- Reconcile payments against internal records
Response fields
Polling strategy
After initiating an STK Push:- Wait 15 seconds — most customers respond within this window.
- Poll every 10 seconds while status is
PENDINGorPROCESSING. - Stop when a terminal state is reached:
SUCCESS,FAILED,CANCELLED, orREVERSED. - After 5 minutes without a terminal state, treat the transaction as likely failed.
Authorizations
Paste your PalPluss API key in the username field and leave the password field empty — it is ignored.
Get your key from console → Settings → API Keys (starts with pk_live_ or pk_test_).
In your own code, send the key directly:
Authorization: Basic YOUR_API_KEY
Path Parameters
The transaction ID returned when the payment was initiated.