BelemaPay is a Nigerian fintech payment gateway that lets your customers pay using:
- Debit/Credit cards
- Bank transfer
- USSD
- And more channels supported by BelemaPay
This plugin integrates BelemaPay directly into WooCommerce, giving your customers a seamless checkout experience.
How it works
- Customer places an order and selects BelemaPay at checkout.
- They are redirected to the secure BelemaPay payment page.
- After payment, they are returned to your site and the order is automatically updated.
Features
- Live and Test mode support
- Automatic order status updates
- Webhook support for reliable background payment confirmation
- Signed webhooks: incoming notifications are verified with an HMAC-SHA256 signature and protected against replay attacks
- Secure: secret keys are never exposed to the browser
- HPOS (High-Performance Order Storage) compatible
External service: BelemaPay
This plugin connects your WooCommerce store to BelemaPay, a third-party payment service operated by Belema Fintech, in order to process payments. It is required for the plugin to function.
When a customer pays, the following data is sent from your site to the BelemaPay API (
https://gateway.belemafintech.com/api):
- The order total and currency
- The customer's billing email, phone number, and name
- A unique transaction reference and your store's callback URL
BelemaPay also sends payment notifications back to your site via a webhook. No data is sent to BelemaPay unless a customer initiates a payment through this gateway.
By using this plugin you agree to BelemaPay's Terms of Service and Privacy Policy:
- Upload the
belemapay-payment-gateway folder to /wp-content/plugins/.
- Activate the plugin via Plugins > Installed Plugins.
- Go to WooCommerce > Settings > Payments > BelemaPay.
- Enter your Live Secret Key (found in your BelemaPay merchant dashboard).
- Enter your Merchant Code so the plugin can verify incoming webhooks.
- Disable Test Mode when ready to accept live payments.
Webhook Setup
Webhook-based confirmation is strongly recommended. Log into your BelemaPay merchant dashboard and set your webhook URL to:
https://yoursite.com/?wc-api=belemapay_webhook
This URL is also displayed on the plugin settings page.
For the plugin to verify that webhooks genuinely come from BelemaPay (and reject forged ones), you must enter your
Merchant Code in the settings. Webhooks are authenticated using an HMAC-SHA256 signature over the request timestamp and your merchant code, keyed with your secret key, and requests older than 10 minutes are rejected to prevent replay attacks.