Skip to content

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:

  1. POST /direct-pay sends the PIN prompt.
  2. 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

  1. 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.

  2. Open Settings → Payments → Fapshi in Centipid

    Enter the API user and API key, and the Webhook secret if you set one.

  3. Add the webhook in Fapshi

    Paste the Webhook URL shown on the Centipid page into the service’s webhook setting on the Fapshi dashboard.

  4. 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.