Skip to main content

​
Collect payments through Centipid

CENTIPID is the managed collection path. Payments are collected by Centipid on your behalf rather than into an account you hold with a provider, and the balance is paid out to you through the Withdrawals flow on the Payments page. You hold no provider credentials at all. Listed in the country catalog for Uganda (UG). Where it is enabled for an ISP in Kenya, the form asks for a payout number instead of provider keys.

​
Before you start

  1. Confirm with support that Centipid Collections is enabled for your account — this is a commercial arrangement, not a self-service switch.
  2. Decide which mobile money number receives your payouts.
  3. Link a MikroTik router and bring it online. This gateway will not send a payment prompt otherwise.
Centipid Collections, Paybill, Till, and Bank all require a linked MikroTik router that is currently online. If none is linked, checkout stops with “Link a MikroTik router and bring it online before sending payment prompts.” and no prompt is sent. See Routers.

​
Configure the gateway

1

Open Settings → Payments → Centipid Collection

Select it from the payment marketplace.
2

Enter a payment number (Kenya only)

Payment number (required in Kenya, maximum 10 characters, starts with 0) is the number that receives payouts from Centipid. Outside Kenya the form asks for nothing — you enter the recipient at withdrawal time instead.
3

Save and switch

In Kenya the payment number gates the switch. Elsewhere nothing does.
4

Run a controlled test payment

Pay a small amount from the captive portal, confirm the prompt arrives and the payment reaches the ledger, then confirm it appears under Collections.

​
Credentials

Outside Kenya there is no stored recipient: withdrawal details are entered each time you withdraw, so a compromised login cannot quietly redirect a standing payout destination.

​
Callback URLs

None to register. In Uganda, collections run over the Iotec rail using the platform’s Iotec credentials, and results are posted to https://<your-host>/iotec/callback.

​
What the payer must provide

A mobile money number, which receives the payment prompt. In Kenya the payment method is labelled Mpesa throughout the application; elsewhere it is labelled Mobile Money.

​
How a payment completes

1

Request

Centipid Billing raises the prompt using the platform’s own provider credentials — the M-Pesa rail in Kenya, the Iotec rail in Uganda.
2

Authorization

The payer authorizes on their handset.
3

Confirmation

The provider result records the payment and applies the subscriber’s package asynchronously. The money is held by Centipid, and appears under Collections.
4

Withdrawal

You request a withdrawal from the Payments page. It is OTP-protected, has a minimum amount, and dispatches money externally — see Collections and withdrawals.
Do not read the payment ledger as your withdrawable balance. Manual and offline payments, and unsettled transactions, do not fund the wallet. Use the available balance shown in the withdrawal flow.

​
Troubleshooting

For every gateway’s fields in one place, see the credential reference.