Nomba Payment Gateway for WooCommerce
| 开发者 |
nombacheckout
tubiz |
|---|---|
| 更新时间 | 2026年9月15日 17:57 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Nomba simplifies the process for Nigerian businesses to securely accept payments from various channels, both locally and internationally. By integrating Nomba into your WooCommerce store website, you empower your customers to pay conveniently using a range of methods:
- Credit/Debit Cards: Visa, Mastercard, Verve, American Express
- Bank transfer
- QR code
- USSD
- And more options on the horizon including Apple and Google Pay!
- Swift Setup: Begin receiving payments in as little as 10 minutes after signing up. Simply create an account and obtain your API keys
- Transparent Pricing: Enjoy straightforward rates of 1.4%, capped at N1,800 for local transactions, and 3.9% for international card payments.
- Hassle-Free Dispute Management: Access our Automated Dispute Manager at no additional cost.
- Comprehensive Analytics: Gain valuable insights through our intuitive dashboard.
- Responsive Support: Our empathetic customer service team is available 24/7 to assist you.
- Ongoing Enhancements: Benefit from free updates as we roll out new features and payment options.
- Robust APIs: Access clearly documented APIs to tailor your payment experiences to your specific needs.
- Volume Discount: Volume discounts available for merchants with 50m+ in monthly volumes
- Accept payment via Visa, Mastercard, Verve, American Express, Bank transfer, QR code & USSD
- Recurring payment using WooCommerce Subscriptions plugin
- Refund payments directly from the order details page
- If a customer pays for a subscription using a Mastercard, Visa, Verve card, their subscription will renew automatically throughout the duration of the subscription. If an automatic renewal fail their subscription will be put on-hold, and they will have to log in to their account to renew the subscription.
- For customers paying with USSD, Bank Transfer, QR code, their subscription can't be renewed automatically, once a payment is due their subscription will be on-hold. The customer will have to log in to their account to manually renew their subscription.
- If a subscription has a free trial and no signup-fee, automatic renewal is not possible for the first payment because the initial order total will be 0, after the free trial the subscription will be put on-hold. The customer will have to log in to their account to renew their subscription. If a Mastercard, Visa, Verve is used to renew the subscription subsequent renewals will be automatic throughout the duration of the subscription.
安装:
- Go to WordPress Admin > Plugins > Add New from the left-hand menu
- In the search box type Nomba WooCommerce Payment Gateway
- Click on Install now when you see Nomba WooCommerce Payment Gateway to install the plugin
- After installation, activate the plugin.
- Go to WooCommerce > Settings and click on the Payments tab
- You'll see Nomba listed along with your other payment methods. Click to view the plugin settings page
- On the next screen, configure the plugin. There is a selection of options on the screen. Read what each one does below.
- Enable/Disable - Check this checkbox to Enable Nomba on your store's checkout
- Title - This will represent Nomba on your list of Payment options during checkout. It guides users to know which option to select to pay with Nomba. Title is set to "Accept Secure Payment via Nomba" by default, but you can change it to suit your needs.
- Description - This controls the message that appears under the payment fields on the checkout page. Use this space to give more details to customers about what Nomba is and what payment methods they can use with it.
- Test Mode - Check this to enable test mode. When selected, the fields in step five will say "Test" instead of "Live." Test mode enables you to test payments before going live. The orders process with test payment methods, no money is involved so there is no risk. You can uncheck this when your store is ready to accept real payments.
- API Keys - The next six text boxes are for your Nomba API keys, which you can get from your Nomba merchant Dashboard.
- Click on Save Changes to update the settings.
- You've checked the "Enable/Disable" checkbox
- You've entered your API Keys in the appropriate field
- Your store currency is set to NGN
- You've clicked on Save Changes during setup
屏幕截图:
常见问题:
What Do I Need To Use The Plugin
- A Nomba merchant account—use an existing account or create an account here
- WooCommerce plugin installed and activated on your WordPress site.
- A valid SSL Certificate
WooCommerce Subscriptions Integration
- If a customer pays for a subscription using a Mastercard, Visa, Verve card, their subscription will renew automatically throughout the duration of the subscription. If an automatic renewal fail their subscription will be put on-hold, and they will have to log in to their account to renew the subscription.
- For customers paying with USSD, Bank Transfer, QR code, their subscription can't be renewed automatically, once a payment is due their subscription will be on-hold. The customer will have to log in to their account to manually renew their subscription.
- If a subscription has a free trial and no signup-fee, automatic renewal is not possible for the first payment because the initial order total will be 0, after the free trial the subscription will be put on-hold. The customer will have to log in to their account to renew their subscription. If a Mastercard, Visa, Verve is used to renew the subscription subsequent renewals will be automatic throughout the duration of the subscription.
Nomba's Terms of Service and Privacy Policy
What data the plugin sends to Nomba
The plugin communicates with Nomba to process payments. Beyond the payment requests themselves, when SwitchFast is in use it sends a small amount of operational metadata to Nomba so we can support your migration and detect service issues. This data contains no customer or shopper information — only your Nomba account identifiers and aggregate operational figures:
- On checkout (when SwitchFast is active): the plugin version and current SwitchFast state travel in the order metadata of the create-order request that is already sent to Nomba. No extra request is made.
- On key events: a small, rate-limited notification is sent to Nomba when the safety net trips (breaker open, dual outage, fallback used) or when you complete or roll back a migration, so we can spot issues affecting your checkout.
- Daily operational heartbeat (opt-in only): if you enable the "Account officer updates" toggle on the SwitchFast dashboard, the plugin sends a once-daily summary — your readiness score and per-gateway transaction counts and success rates — to your Nomba account officer. This is off by default, contains no customer data, and can be turned off at any time.
更新日志:
1.2.0
- Added passive SwitchFast telemetry so Nomba gains operational visibility without merchants forwarding logs. The plugin version rides along in the create-order request's order metadata for fleet-wide version visibility, and the current SwitchFast state is added when SwitchFast is actively bucketing checkout (no new request, no shopper data).
- Added an optional daily operational heartbeat to your Nomba account officer (readiness score and per-gateway success rates), controlled by the new "Account officer updates" toggle on the SwitchFast dashboard. Off by default; no customer data is shared; you can turn it off at any time.
- Added non-blocking, rate-limited event pings for high-value moments — breaker tripped, dual outage, fallback used, and migration completed/rolled back. Pings are fire-and-forget, so a slow or unreachable telemetry endpoint never affects checkout latency.
- The account-manager notification on Complete Migration is now delivered via the same non-blocking path, so completing migration no longer blocks the admin request on a network round-trip.
- Fix redirect callback marking a paid order as failed when it raced the payment_success webhook.
- Introducing SwitchFast: an optional migration toolkit that activates only when another supported payment gateway is installed alongside Nomba. Fully backward compatible — nothing changes for stores without a second gateway.
- Added comparison mode: an admin dashboard at WooCommerce > SwitchFast buckets customers between the two gateways and compares transaction counts and success rates.
- Added a circuit-breaker that temporarily routes checkout through the merchant's other configured gateway if Nomba hits a burst of infrastructure failures, and restores routing automatically when the next call succeeds.
- Added a synchronous Health Check button that verifies Nomba credentials and connectivity without moving any money.
- Added an email anomaly alert (rate-limited 1/24h) and an urgent dual-outage alert when no gateway is reachable.
- Added a Readiness Score (0–100) on the SwitchFast dashboard that summarises whether your store is ready to complete migration.
- Added the Complete Migration button. When you are ready to make Nomba your only checkout gateway, you can switch over in one click with a 7-day rollback window.
- Added a weekly operational digest email (Monday 09:00 site time) summarising per-gateway transaction counts and success rates from the previous 14 days.
- Added a one-shot readiness alert email when your store's score first crosses 90/100.
- Added an optional notification to your Nomba account manager when you complete migration; the consent toggle is on the Complete Migration confirmation dialog.
- Added a cron heartbeat indicator on the dashboard so you can spot lagging WP cron.
- Added a renewal flag (
_nomba_migration_is_renewal) for subscription renewal orders so they are excluded from comparison stats. - Fairer success rates: failures Nomba classifies as customer input errors (wrong PIN, expired card) are excluded from Nomba's comparison figures, as explained on the comparison panel. Your other gateway does not report this distinction, so its rate includes all failures.
- Add a background reconciliation sweep that settles Nomba orders left in "pending" when the customer failed a payment then abandoned the hosted checkout (so the browser never returned and no webhook arrived). The sweep verifies each stale pending order against Nomba and marks it paid or failed, using the same order-processing lock as the live callback so it stays idempotent, and confirms the fetched transaction belongs to the order before settling it.
- Fix fatal error in the redirect callback when a payment fails with a malformed order reference: the failure path now guards against a missing order before updating status, matching the success path
- Fix refunds silently failing with no message: the refund handler now null-checks the Nomba response and returns an explicit error when the gateway does not confirm the refund
- Fix empty "Nomba" heading on the gateway settings screen (translation string was not echoed)
- Fix free-trial subscription detection passing an order object where an order ID is expected
- Fix a possible fatal error when a saved card token is malformed: token parsing now validates its structure before use, in both one-off and subscription-renewal payments
- Fix order wedging on crashed mid-update: callback now acquires the processing lock before checking order status, and uses the transaction ID as the completion signal so a subsequent request can complete an order whose prior request died after flipping status to "processing"
- Fix webhook giving up on HTTP 404 when fetching transaction details: the transaction fetch now retries on 404, treating it as a transient backend read-after-write lag rather than a permanent failure
- Add a short delay before the webhook fetches the transaction to reduce read-after-write races with the Nomba backend
- Add comprehensive logging for webhook and redirect callback payment flows
- Add order notes indicating whether payment was confirmed via webhook or redirect callback
- Add retry logic with configurable attempts for transaction verification API calls
- Add atomic order processing lock to prevent race conditions from concurrent requests
- Add stale lock detection with 60-second TTL for automatic recovery
- Fix transaction lookup using proper query parameters instead of request body on GET requests
- Fix token cache expiration bug that could cache expired tokens indefinitely
- Fix wc_add_notice() call in webhook context where no customer session exists
- Fix WC()->cart->empty_cart() call in webhook context where no cart session exists
- Improve error handling with categorised HTTP status responses (retryable vs permanent failures)
- Improve webhook reliability by returning 400 on transient failures to trigger redelivery
- Reduce API timeout from 60s to 30s to prevent PHP execution timeouts
- Add 401 token refresh handling without consuming retry attempts
- WordPress 6.9 compatibility
- WooCommerce 10.7 compatibility
- Add support for GBP & EUR payment
- Add options to pass order details to Nomba
- WooCommerce 10.3 compatibility
- Update Nomba payment method image displayed on the checkout page
- Add support for partial refund from the order details page
- WooCommerce 10.2 compatibility
- Refund order payments directly from the order details page
- Add option to autocomplete order after successful payment
- Add support for USD payment
- Pass X-Nomba-Integration header when creating a Nomba checkout order
- First release