Snippe
Collect payments with Snippe
SNIPPE 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 Tanzania (TZ), in Tanzanian shillings, for payments of TZS 500 or more. An ISP that prices in another currency is refused at checkout, so a USD 10 plan is never charged as TZS 10.
Centipid Billing uses two calls from Snippe’s API:
POST /v1/paymentssends the PIN prompt to the payer’s number.GET /v1/payments/{reference}reports whether it was paid.
Nothing is credited until the status reads completed.
Configure the gateway
Create an API key in Snippe
Sign in at snippe.sh and open Settings → API Keys. Create a key with the
collection:readandcollection:createscopes. Snippe shows it only once.Copy the webhook secret
In Snippe, open Settings → Webhook Secret and copy it.
Open Settings → Payments → Snippe in Centipid
Enter the API key and the Webhook secret. There is no URL to paste into Snippe: Centipid sends its webhook URL with each payment.
Run a controlled test payment
Snippe has no sandbox. Pay TZS 500 from the captive portal, approve the prompt on the phone, and confirm the payment reaches the ledger.
Credentials
| Field | Required | Notes |
|---|---|---|
| API key | Yes | Starts with snp_. Sent as a Bearer token from Centipid’s servers only. Needs the collection:read and collection:create scopes. |
| Webhook secret | Yes | Checks the X-Webhook-Signature on Snippe’s webhook. Without it every webhook is refused. |
Webhook
Each payment carries /api/snippe/callback on the ISP’s domain as its webhook
URL, so a domain change needs nothing in Snippe. The webhook only tells Centipid
to look sooner: Centipid checks the payment’s status every 5 seconds for about
3 minutes after the prompt is sent, and only that check credits a payment.
A payer who approves the prompt after those 3 minutes is credited only through the webhook, so the webhook secret has to be set. If you regenerate it in Snippe, paste the new one into Centipid straight away: Snippe drops the old one immediately.
Fees
Snippe publishes 2.5% per mobile money collection, with no monthly fee, settled instantly to your Snippe balance. Payouts from that balance cost TZS 1,500 each. Check Snippe’s pricing for your account’s rate.
Troubleshooting
- “Unable to send the Snippe payment prompt”: Snippe refused the request,
usually because the key is wrong, revoked or missing the
collection:createscope. Its exact response is in the application log. - “Enter a Tanzanian mobile number”: the number is not a
255…mobile number. - “Snippe takes payments of TZS 500 or more”: the plan costs less than Snippe’s minimum.
- “Snippe bills in TZS here”: the ISP’s prices are in another currency. Contact Centipid support to change it.
- “Use the API key from Snippe’s Settings → API Keys”: the value pasted as
the API key does not start with
snp_, often the webhook secret pasted into the wrong field. - Paid, but connected only after several minutes, or not at all: check the webhook secret in Centipid matches Settings → Webhook Secret in Snippe.
