SpeedPesa
Speedpesa API v1

Transaction Status API

Angalia hali ya muamala wowote papo hapo.

STATUS · GETUnauliza tu (GET) hali ya muamala: pending, success au failed.
HomeDocumentationCheck Transaction Status

Authentication

Kila ombi linahitaji API key yako kwenye headers.

Required Headers

Authorization

Bearer sk_live_XXXXXXXXXXXX

Content-Type

application/json

Muhtasari

Tumia transaction_id au reference yako kupata hali halisi: pending, success au failed — pamoja na kiasi, channel na muda.

Hatua 3GET

Hatua 3 — Check Payment Status

Angalia hali ya malipo kwa kutumia transaction_id au order reference. Ikiwa muamala bado ni pending, mfumo unathibitisha moja kwa moja na mtoa huduma kabla ya kukurudishia jibu.

GET https://speedpesa.com/api/public/v1/transactions/{transaction_id}

Query Parameters

ParameterTypeRequiredMaelezo
transaction_idstringYesKitambulisho ulichopewa kwenye hatua ya 2 (au reference yako).mfano: STB-8FA21-3D91C
bash
curl -X GET 'https://speedpesa.com/api/public/v1/transactions/STB-8FA21-3D91C' \
  -H 'Authorization: Bearer sk_live_XXXXXXXXXXXX'

Kumbuka: Hali zinazowezekana ni pending, success na failed.

Hali za Muamala

pending

Push imefika kwa mteja; PIN bado haijaingizwa.

Hatua: Subiri webhook au poll /transactions/{id} kila sekunde 5–10 (hadi dakika 3).

success

Malipo yamekamilika na salio limeongezwa.

Hatua: Kamilisha oda yako mara moja; tukio hili haliwezi kubadilika.

failed

Mteja alighairi, PIN si sahihi, au salio halitoshi.

Hatua: Mwambie mteja ajaribu tena kwa reference mpya.

Disbursement APIBalance Check API