VillageHub Create Account
Finance

PalmPesa Setup

Connect your PalmPesa merchant account to accept automated Tanzanian mobile money push (USSD/wallet push) payments from subscribers.

You need an active PalmPesa merchant account. Go to PalmPesa Dashboard if you do not have one.
1

Retrieve API Credentials

Log in to your PalmPesa Dashboard and navigate to the developer/settings section to obtain your:

  • API Token (Bearer Token)
  • Merchant User ID
  • Vendor Code / Till / Paybill
2

Configure Settings in VillageHub

Go to your Admin PanelSettingsPayments. Select PalmPesa as the payment gateway and paste your API Token, Merchant User ID, and Vendor details.

3

Configure Webhook URL in PalmPesa

Copy your unique callback webhook URL and paste it inside the PalmPesa Webhook settings:

Callback Webhook URL
https://isp.village-hub.net/api/payments/palmpesa/callback/{tenant-subdomain}

You can also configure the root-level fallback webhook https://isp.village-hub.net/webhooks/palmpesa if required.

You are ready!

PalmPesa push payments will now be verified and activated instantly for all your hotspot and broadband subscribers.