Payments

Retrieve a payment intent

GET/v1/payment_intents/{id}

The intent, all attempts with provider references, and the latest reconciliation status.

Parameters

idstringin pathrequired

Responses

200The intent
400Invalid request
401Missing, invalid or revoked API key
404No such intent for this key
429More than 100 requests in this minute for this keyRetry-After
500Internal error

Error bodies and every code are listed under Errors; limits under Rate limits and Idempotency.

{ "id": "pi_01JB8Q4Z2N5V7K3M9P6R0T1W8X", "object": "payment_intent", "livemode": false, "status": "pending", "amount": 125000, "currency": "KES", "method": "mpesa_stk", "reference": "ORDER-1001", "description": "description", "phone": "+254708374149", "customer_email": "amina@example.co.ke", "metadata": {}, "provider_code": "provider code", "receipt": "receipt", "checkout_url": "checkout url", "reconciliation_status": "matched_exact", "created_at": "2026-10-22T09:30:00.000Z", "succeeded_at": "2026-10-22T09:30:00.000Z", "attempts": [ { "id": "pa_01JB8Q4Z2N5V7K3M9P6R0T1W8X", "object": "payment_attempt", "provider": "daraja", "status": "pending", "provider_ref": "provider ref", "failure_code": "failure code", "created_at": "2026-10-22T09:30:00.000Z", "finished_at": "2026-10-22T09:30:00.000Z" } ] }

Retrieve a payment intent

GET/v1/payment_intents/{id}

The intent, all attempts with provider references, and the latest reconciliation status.

Parameters

idstringin pathrequired

Responses

200The intent
400Invalid request
401Missing, invalid or revoked API key
404No such intent for this key
429More than 100 requests in this minute for this keyRetry-After
500Internal error

Error bodies and every code are listed under Errors; limits under Rate limits and Idempotency.