VillageHub Create Account
Finance

Afriqore Pay Setup

Connect your Afriqore Pay merchant account to accept automated Tanzanian mobile money push payments (USSD prompt) from subscribers on M-Pesa, Mixx by Yas (Tigo Pesa), Airtel Money, and HaloPesa.

You need an approved Afriqore Pay merchant account. Open the Afriqore Pay merchant dashboard to sign up or sign in.
1

Copy Your API Keys

Log in to your Afriqore Pay dashboard and open the API Keys section. Copy:

  • App ID — identifies your merchant account
  • Passkey — authenticates every request

Keep the Passkey private — treat it like a password. Anyone holding it can initiate charges on your account.

2

Configure Settings in VillageHub

Go to your Admin Panel → Settings → Payments. Select Afriqore Pay (Tanzania) as the payment gateway and paste your App ID and Passkey. If Afriqore Pay gave you a webhook signing secret, paste it into Webhook Secret; otherwise leave it blank.

Running multiple sites? You can also point an individual router at Afriqore Pay (or its own credentials) from the router's payment override on the router detail page.

3

Payment Confirmations Are Automatic

There is no webhook to configure in the Afriqore Pay dashboard — VillageHub sends its callback URL with every payment request, and Afriqore Pay posts a confirmation there as soon as your customer approves or declines the prompt. Every confirmation is checked against the Afriqore Pay API before internet access is granted. For reference, the callback endpoint is:

Callback URL (set automatically)
https://isp.village-hub.net/api/payments/afriqorepay/callback/{tenant-subdomain}

Good to know: Afriqore Pay detects the customer's network from their phone number. Customers paying with Mixx by Yas or Airtel Money pay no fees. Collections are in TZS only, minimum TZS 100 per payment. The USSD approval prompt works on both feature phones and smartphones.

You are ready!

Subscribers now get a payment prompt on their phone at checkout, and their hotspot or broadband service activates instantly once they approve it.