Fapshi
Collect payments with Fapshi
FAPSHI collects by wallet push. The payer enters their number on the
portal, a PIN prompt appears on their phone, and they approve it there. They
never leave the portal page.
Offered in the country catalog for Cameroon (CM), in CFA francs (XAF), for MTN MoMo and Orange Money numbers and payments of XAF 100 or more. An ISP that prices in another currency is refused at checkout, so a USD 10 plan is never charged as XAF 10.
Centipid Billing uses two calls from Fapshi’s API:
POST /direct-paysends the PIN prompt.GET /payment-status/{transId}reports whether it was paid.
Nothing is credited until the status reads SUCCESSFUL for the amount the
payer was asked to pay.
Configure the gateway
Ask Fapshi to enable Direct Pay
Direct Pay is off by default on a live Fapshi account. Request it from the Fapshi dashboard (Fapshi reviews each use case, and does not offer it to payment aggregators). Centipid talks only to Fapshi’s live host, so use the live API user and API key.
Open Settings → Payments → Fapshi in Centipid
Enter the API user and API key, and the Webhook secret if you set one.
Add the webhook in Fapshi
Paste the Webhook URL shown on the Centipid page into the service’s webhook setting on the Fapshi dashboard.
Run a controlled test payment
Pay XAF 500 from the captive portal, approve the prompt on the phone, and confirm the payment reaches the ledger.
Credentials
| Field | Required | Notes |
|---|---|---|
| API user | Yes | Sent in the apiuser header from Centipid’s servers only. |
| API key | Yes | Sent in the apikey header from Centipid’s servers only. |
| Webhook secret | No | The secret you set on Fapshi’s dashboard. When set, webhooks without a matching x-wh-secret header are refused. |
Webhook
Fapshi sends its webhook once and never retries it, and the x-wh-secret
header is a shared secret, not a signature. So Centipid never credits from a
webhook: it only makes Centipid ask Fapshi for the payment’s status sooner.
Centipid also checks the status every 12 seconds for about 8 minutes after the
prompt is sent. A payment whose webhook is lost is still credited if Fapshi
confirms it within that window; one confirmed later is not credited
automatically.
Troubleshooting
- “Unable to send the Fapshi payment prompt”: Fapshi refused the request, usually because the API user or key is wrong, or Direct Pay is not enabled on the account. Its exact response is in the application log.
- “Enter a Cameroonian mobile number”: the number is not a
2376…mobile number. - “Fapshi takes payments of XAF 100 or more”: the plan costs less than Fapshi’s minimum.
- “Fapshi bills in XAF here”: the ISP’s prices are in another currency. Contact Centipid support to change it.
- The payer paid but did not connect: Fapshi reported a different amount than the plan costs, which is logged and credits nothing. Check the payment in the Fapshi dashboard.
