Skip to main content

Payment gateway

FimiPay Payment Gateway

Accept mobile money and hosted card or bank payments through FimiPay in supported African markets.

Read the payment gateway setup guide

Supported markets

  • Tanzania
  • Kenya
  • Uganda
  • Nigeria
  • Ghana
  • Cameroon
  • South Africa

Listed payment methods

  • Tanzania mobile money prompt
  • Hosted mobile money checkout
  • Hosted card checkout
  • Hosted bank checkout

Each tenant uses its own FimiPay API key and webhook secret. Plan currency must match the selected FimiPay currency.

Setup guidance

  1. Create and verify a FimiPay merchant account, then create an API key in the developer dashboard.
  2. Choose the currency and payment method that match the plans you sell through this tenant.
  3. Set the webhook URL shown below in FimiPay and copy its signing secret into this tenant settings.
  4. Test the connection with a test key, then use a live key only after the merchant account is approved.
  5. Review current FimiPay collection fees. They are charged on successful collections and may vary by merchant.

Configuration requirements

Enter these values in the matching gateway settings. Obtain credentials from the provider and keep them private.

FimiPay Secret Key Required
Stored for this tenant and sent only from the server.
Webhook Signing Secret Required
HMAC secret configured in your FimiPay webhook settings.
Payment Currency Required
Must match the currency configured on plans paid through this gateway.
Payment Method Required
USD always uses card checkout. TZS mobile uses a phone prompt; other markets use hosted checkout. South Africa supports card or bank, not mobile money.
Webhook URL Optional
Configure this URL in FimiPay. The webhook secret is tenant-specific.