# Snippe

> Collect Tanzanian mobile money with Snippe wallet push: the payer approves a PIN prompt on M-Pesa, Airtel, Mixx by Yas or Halotel. Covers key and webhook.

Source: https://docs.centipidbilling.com/billing/payment-gateways/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](https://docs.snippe.sh/docs/2026-01-25):

1. `POST /v1/payments` sends the PIN prompt to the payer's number.
2. `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](https://snippe.sh) and open **Settings → API Keys**.
Create a key with the `collection:read` and `collection:create` scopes.
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](https://snippe.sh/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:create`
  scope. 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.
