Skip to main content
POST
Trigger a mobile (USSD) collection

Authorizations

Authorization
string
header
required

Bearer token from POST /generate-token. Expires ~1h; on 401, re-generate and retry once.

Body

application/json
amount
number
required

Collection amount. Minimum 1,000.

currency
string
required
Example:

"TZS"

payerPhone
string
required

Payer phone in international (E.164) format.

Example:

"+255700000000"

fspId
string
default:CLICKPESA
required

Currently CLICKPESA (covers Airtel Money, Mixx by Yas, Halotel). More FSPs coming soon; bank collections on request.

Example:

"CLICKPESA"

transactionId
string
required

Your unique reference; used to poll status and as the idempotency key.

Response

Collection initiated (a USSD prompt is sent to the payer)