Skip to main content
GET
Get transaction
Retrieve a transaction by ID. Use this to confirm status, display details, or reconcile payments.
Use webhooks as your primary mechanism for receiving payment results. Poll this endpoint only when webhook delivery has failed.

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:
  1. Wait 15 seconds — most customers respond within this window.
  2. Poll every 10 seconds while status is PENDING or PROCESSING.
  3. Stop when a terminal state is reached: SUCCESS, FAILED, CANCELLED, or REVERSED.
  4. After 5 minutes without a terminal state, treat the transaction as likely failed.
Excessive polling consumes your rate limit. For real-time results, use webhooks.

Authorizations

Authorization
string
header
required

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

id
string<uuid>
required

The transaction ID returned when the payment was initiated.

Response

Transaction details.

success
boolean
required
Example:

true

data
object
required

Response payload. Shape varies by endpoint.

requestId
string<uuid>
required

Unique identifier for this API request. Include in support tickets.

Example:

"c1b2a3d4-e5f6-7890-abcd-ef1234567890"