🍀Fastapesa
Sign in

Transaction Status API

HomeDashboardDocumentationsTransaction Status API

Authentication

Every request requires your API key in the headers.

Content-Typeapplication/json
Header Namex-api-key
AlternativeAuthorization: Bearer KEY

Check Transaction Status

Retrieve the real-time status of any transaction using its reference. Get instant updates on pending, completed, or failed payments.

POSThttps://fastapesa.com/api/v1/status

Request Body (JSON)

FieldTypeRequiredDescription
referencestringYesUnique transaction reference ID
cURL Example
curl -X POST https://fastapesa.com/api/v1/status \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "reference": "PWPD86A82954C"
}'

JSON Response

{
  "type": "success",
  "message": "Transaction completed successfully",
  "data": {
    "reference": "PWPD86A82954C",
    "type": "API Payin",
    "direction": "credit",
    "amount": "1000.00",
    "fee": "0.00",
    "total": "1000.00",
    "currency": "TZS",
    "status": "SUCCESS",
    "status_message": "Transaction completed successfully",
    "resultcode": 0,
    "completed": "2026-06-23 12:00:00",
    "channel": "MOBILE",
    "channelprovider": "mobile",
    "accountnumber": "255687819056",
    "accountname": "JOSEPH",
    "description": "API Payin",
    "created": "2026-06-23 11:55:00",
    "updated": "2026-06-23 12:00:00"
  }
}