Tanzania

Currency	TZS
Country code	TZ
Phone format	Country code 255 + number, digits only, no + (e.g. 255754123456)
Collect with	Mobile money push, Checkout
Send with	provider: "INTASEND-XB"
Amount limits	TZS 500 to 5,000,000

Networks

Network	Detected by prefix / operator_code
Vodacom M-Pesa	VODACOM
Airtel Money	AIRTEL
Tigo Pesa / Yas	TIGO
HaloPesa	HALOTEL

Collect a payment

Send a mobile money prompt to the customer's phone:

curl -X POST https://api.intasend.com/api/v1/payment/intasend-xb-push/ \
  -H "Authorization: Bearer $INTASEND_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 5000,
  "currency": "TZS",
  "country": "TZ",
  "phone_number": "255754123456",
  "api_ref": "order-123",
  "operator_code": "VODACOM"
}'

operator_code is recommended for Tanzania. On Checkout with currency: "TZS", customers can choose M-Pesa, Tigo Pesa, Airtel or HaloPesa (amount 500 to 5,000,000).

The response contains an invoice in PENDING or PROCESSING state. Wait for the collection_event webhook or poll payment status until state is COMPLETE or FAILED.

Send money

Initiate the payout

curl -X POST https://api.intasend.com/api/v1/send-money/initiate/ \
  -H "Authorization: Bearer $INTASEND_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "currency": "TZS",
  "country": "TZ",
  "provider": "INTASEND-XB",
  "requires_approval": "NO",
  "callback_url": "https://example.com/intasend/payouts",
  "transactions": [
    {
      "name": "Asha Juma",
      "account": "255754123456",
      "operator_code": "VODACOM",
      "amount": "5000",
      "narrative": "Payout"
    }
  ]
}'

operator_code is required

Tanzanian payouts must include operator_code: VODACOM, AIRTEL, TIGO or HALOTEL. List them with GET /send-money/operator-codes/tz/?channel_type=MOBILE_MONEY.

Track it with /send-money/status/ using the returned tracking_id.