{"id":331161,"date":"2026-07-01T14:15:48","date_gmt":"2026-07-01T14:15:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/belemapay-payment-gateway\/"},"modified":"2026-07-01T14:15:35","modified_gmt":"2026-07-01T14:15:35","slug":"belemapay-payment-gateway","status":"publish","type":"plugin","link":"https:\/\/te.wordpress.org\/plugins\/belemapay-payment-gateway\/","author":23515280,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"BelemaPay Payment Gateway","header_author":"Belema Fintech","header_description":"Accept payments on your WooCommerce store via BelemaPay \u2014 cards, bank transfer, and more.","assets_banners_color":"","last_updated":"2026-07-01 14:15:35","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/gateway.belemafintech.com","header_author_uri":"https:\/\/belemafintech.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":55,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"belemapay","date":"2026-07-01 14:15:35"}},"upgrade_notice":{"1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[14240,199550,5492,6593,286],"plugin_category":[45],"plugin_contributors":[269734],"plugin_business_model":[],"class_list":["post-331161","plugin","type-plugin","status-publish","hentry","plugin_tags-cards","plugin_tags-fintech","plugin_tags-nigeria","plugin_tags-payment-gateway","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-belemapay","plugin_committers-belemapay"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/belemapay-payment-gateway.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>BelemaPay is a Nigerian fintech payment gateway that lets your customers pay using:<\/p>\n\n<ul>\n<li>Debit\/Credit cards<\/li>\n<li>Bank transfer<\/li>\n<li>USSD<\/li>\n<li>And more channels supported by BelemaPay<\/li>\n<\/ul>\n\n<p>This plugin integrates BelemaPay directly into WooCommerce, giving your customers a seamless checkout experience.<\/p>\n\n<h4>How it works<\/h4>\n\n<ol>\n<li>Customer places an order and selects BelemaPay at checkout.<\/li>\n<li>They are redirected to the secure BelemaPay payment page.<\/li>\n<li>After payment, they are returned to your site and the order is automatically updated.<\/li>\n<\/ol>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Live and Test mode support<\/li>\n<li>Automatic order status updates<\/li>\n<li>Webhook support for reliable background payment confirmation<\/li>\n<li>Signed webhooks: incoming notifications are verified with an HMAC-SHA256 signature and protected against replay attacks<\/li>\n<li>Secure: secret keys are never exposed to the browser<\/li>\n<li>HPOS (High-Performance Order Storage) compatible<\/li>\n<\/ul>\n\n<h4>External service: BelemaPay<\/h4>\n\n<p>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.<\/p>\n\n<p>When a customer pays, the following data is sent from your site to the BelemaPay API (https:\/\/gateway.belemafintech.com\/api):<\/p>\n\n<ul>\n<li>The order total and currency<\/li>\n<li>The customer's billing email, phone number, and name<\/li>\n<li>A unique transaction reference and your store's callback URL<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<p>By using this plugin you agree to BelemaPay's Terms of Service and Privacy Policy:<\/p>\n\n<ul>\n<li>Terms of Service: https:\/\/gateway.belemafintech.com\/terms <\/li>\n<li>Privacy Policy: https:\/\/gateway.belemafintech.com\/privacypolicy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>belemapay-payment-gateway<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin via <strong>Plugins &gt; Installed Plugins<\/strong>.<\/li>\n<li>Go to <strong>WooCommerce &gt; Settings &gt; Payments &gt; BelemaPay<\/strong>.<\/li>\n<li>Enter your Live Secret Key (found in your BelemaPay merchant dashboard).<\/li>\n<li>Enter your <strong>Merchant Code<\/strong> so the plugin can verify incoming webhooks.<\/li>\n<li>Disable <strong>Test Mode<\/strong> when ready to accept live payments.<\/li>\n<\/ol>\n\n<h4>Webhook Setup<\/h4>\n\n<p>Webhook-based confirmation is strongly recommended. Log into your BelemaPay merchant dashboard and set your webhook URL to:<\/p>\n\n<pre><code>https:\/\/yoursite.com\/?wc-api=belemapay_webhook\n<\/code><\/pre>\n\n<p>This URL is also displayed on the plugin settings page.<\/p>\n\n<p>For the plugin to verify that webhooks genuinely come from BelemaPay (and reject forged ones), you must enter your <strong>Merchant Code<\/strong> 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.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20get%20my%20api%20keys%3F\"><h3>Where do I get my API keys?<\/h3><\/dt>\n<dd><p>Log into your BelemaPay merchant dashboard at https:\/\/gateway.belemafintech.com and navigate to Settings &gt; API Keys.<\/p><\/dd>\n<dt id=\"does%20this%20work%20without%20woocommerce%3F\"><h3>Does this work without WooCommerce?<\/h3><\/dt>\n<dd><p>No. This plugin requires WooCommerce 5.0 or higher.<\/p><\/dd>\n<dt id=\"is%20there%20a%20test%20mode%3F\"><h3>Is there a test mode?<\/h3><\/dt>\n<dd><p>Yes. Enable <strong>Test Mode<\/strong> in the plugin settings and use your test secret key to process sandbox transactions.<\/p><\/dd>\n<dt id=\"why%20are%20my%20webhooks%20being%20rejected%3F\"><h3>Why are my webhooks being rejected?<\/h3><\/dt>\n<dd><p>Make sure you have entered your <strong>Merchant Code<\/strong> in the plugin settings. The plugin verifies the signature BelemaPay sends with each webhook; without the correct merchant code, signed requests cannot be validated. For test card charges, also enter your <strong>Live Public Key<\/strong>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Accept payments on your WooCommerce store via BelemaPay \u2014 cards, bank transfer, USSD, and more.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/331161","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=331161"}],"author":[{"embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/belemapay"}],"wp:attachment":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=331161"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=331161"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=331161"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=331161"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=331161"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=331161"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}