🍀Fastapesa
Sign in

Collection API

HomeDashboardDocumentationsCollection API

Authentication

Every request requires your API key in the headers.

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

Mobile Payin (Receive Money)

Request payments from a customer's mobile money account.

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

Request Body (JSON)

FieldTypeRequiredDescription
phonenumberstringYesCustomer phone: 2557XXXXXXXX
amountstring/numberYesAmount in TZS to request
cURL Example
curl -X POST https://fastapesa.com/api/v1/mobilepayin \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "phonenumber": "255617919056",
  "amount": "1000"
}'

JSON Response

{
  "type": "success",
  "message": "Payment request sent successfully",
  "data": {
    "reference": "PWPA1B2C3D4E5",
    "phonenumber": "255617919056",
    "amount": "1000.00",
    "currency": "TZS",
    "status": "PENDING",
    "created": "2026-02-23 14:30:45"
  }
}