00
Quick Start
Five steps to go live. Full feature details are in the sections below.
1
Download the ZIP
Sign in at customer.robustsoftech.com → Downloads and get RobustPay-nmi-gateway-pro.2.0.2.zip (latest).
2
Install in WordPress
Plugins → Add New → Upload Plugin → Install Now → Activate.
3
Activate your licence
Open the RobustPay hub → Settings → Licence. Enter RP-PRO-… or RP-AGY-… and activate.
4
Add NMI keys
WooCommerce → Settings → Payments → RobustPay. Add Security Key (and Collect.js tokenization key for inline fields).
5
Enable & test
Enable the gateway, keep Test Mode on, place a test order, then go live.
01 · Before You Begin
Requirements
Make sure your environment meets all requirements before installing RobustPay - NMI Payment Gateway for WooCommerce.
| WordPress | 6.0 | 6.4 or higher |
| WooCommerce | 9.0 | 9.x or 10.x+ |
| PHP | 7.4 | 8.1 or higher |
| MySQL / MariaDB | 5.6 | 8.0 |
| SSL Certificate | Required on all pages where payments are accepted |
| NMI Merchant Account | An active NMI account with API access (Security Key) |
| Customer Vault | Must be enabled in NMI for saved cards, subscriptions, Apple/Google Pay |
SSL is mandatory. RobustPay - NMI Payment Gateway for WooCommerce will not process live payments on pages served over HTTP. Ensure your site has a valid SSL certificate installed before going live.
Not sure if Customer Vault is enabled? Log into your NMI control panel, go to Settings → Gateway Features and confirm the Vault option is active. If it isn't, contact your ISO or NMI support.
02 · Step-by-Step
Installing RobustPay - NMI Payment Gateway for WooCommerce
Download the plugin ZIP from your customer portal (or your order confirmation email). Follow these steps to install it on your WordPress site.
1
Download the Plugin ZIP
After purchase, open your confirmation email from RobustPay (invoice PDF attached) or sign in at customer.robustsoftech.com. Download RobustPay-nmi-gateway-pro.2.0.2.zip from Downloads. Save the ZIP — do not extract it.
2
Upload to WordPress
Log into your WordPress admin panel. Navigate to:
3
Activate the Plugin
After installation completes, click Activate Plugin. You will see a notice at the top of the Plugins page asking you to activate your license. Click Activate License or proceed to the next step.
4
Verify Plugin is Active
Go to Plugins › Installed Plugins
5
Enable the Payment Gateway in WooCommerce
Navigate to:
Always prefer the Latest build from customer.robustsoftech.com → Downloads so you get license revoke protection and payment locks.
Upgrading from Free? Pro is standalone. If Free is installed, Pro can import your NMI credentials and deactivate Free to avoid conflicts. Keep only one RobustPay build active.
03 · Activation
License Activation
Your license key unlocks all Pro features and enables automatic updates. You must activate it before the gateway will process live payments.
1
Find your License Key
Your license key is in the order confirmation email and in your customer dashboard at customer.robustsoftech.com → Licenses. It looks like: RP-PRO-XXXX-XXXX (Pro Single) or RP-AGY-XXXX-XXXX (Agency)
3
Staging & Live Sites
🔒
Refunds & expiry. If a licence is refunded or expires, RobustPay - NMI Payment Gateway for WooCommerce 2.0.2 disables CC, ACH, and Wallets automatically (instant push when possible, otherwise within about an hour). Re-enabling payments requires a valid active licence.
A Single Site license allows one active domain at a time. You can deactivate it from a staging URL and re-activate it on your live domain at any time — there is no extra charge for this. If you need both staging and live active simultaneously, contact support and we will accommodate that during your migration.
Refunds & expiry. If a licence is refunded or expires, RobustPay - NMI Payment Gateway for WooCommerce 2.0.2 disables CC, ACH, and Wallets automatically (instant push when possible, otherwise within about an hour). Re-enabling payments requires a valid active licence.
Agency license holders can activate on up to 10 domains (including Multisite). Contact support if you need more seats.
04 · Configuration
Basic Gateway Settings
These settings apply to all payment methods. Configure them first before enabling individual features.
| Enable / DisableRequired | Turn the payment gateway on or off at checkout. Enable this to allow customers to pay. |
| TitleOptional | The label shown to customers at checkout. Default: "Credit / Debit Card". You can customise this. |
| DescriptionOptional | Short text shown below the title at checkout. Example: "Pay securely using your card." |
| Security KeyRequired | Your NMI API Security Key. Find it in your NMI control panel under Settings → Security Keys. This is not your login password. |
| Test ModeOptional | When enabled, all transactions go through NMI's test environment. No real money is charged. Disable this before going live. |
| Transaction TypeOptional | Authorize & Capture charges the card immediately. Authorize Only holds the funds and you capture manually from the order screen. Most stores use Authorize & Capture. |
| LoggingOptional | Enable to write detailed debug logs. Useful for troubleshooting. Access logs at WooCommerce › Status › Logs. Disable on production when not needed. |
Never share your Security Key. It provides full API access to your NMI account. Store it only in this settings field — do not put it in code or config files.
05 · Pro Feature
Inline Card Fields
Inline card fields embed the card number, expiry, and CVV directly on your checkout page using NMI's Collect.js library. Card data never touches your server — it's tokenised in the browser — keeping you PCI-compliant with no redirects.
1
Enable Collect.js in NMI
Log into your NMI Control Panel. Go to Settings → Security Keys → Tokenization Keys. Create or copy your Tokenization Key. This is a separate key from your Security Key.
2
Enter Your Tokenization Key
In WordPress, navigate to:
3
Test the Checkout
With Test Mode enabled, go to your checkout page. You should now see embedded card fields (card number, expiry, CVV) directly on the page. Test with NMI's test card: 4111 1111 1111 1111, expiry 12/25, CVV 999.
What success looks like: The card fields appear inline on the checkout page, the order processes without leaving the site, and the transaction shows in your NMI dashboard.
06 · Pro Feature
Apple Pay
Allow customers on Safari (iPhone, iPad, Mac) to pay with one tap using Face ID, Touch ID, or their Apple Watch. No card entry required.
1
Enable Apple Pay in NMI
In your NMI Control Panel go to Settings → Gateway Features → Apple Pay and enable it. Contact your ISO if the option is not visible — they may need to activate it on your account.
2
Verify Your Domain with Apple
Apple requires you to host a verification file on your domain. In the plugin settings under Apple Pay, click Download Verification File. Upload the downloaded file to your web server at this exact path:
3
Enable Apple Pay in Plugin Settings
Go to RobustPay Settings › Apple Pay
4
Test on a Compatible Device
The Apple Pay button is only visible on Safari on Apple devices with Apple Pay set up. Use a real iPhone or Mac with Safari to test. With Test Mode on, the transaction will complete but no real charge is made.
The verification file must be accessible without redirects (no HTTPS → HTTP redirect, no authentication). Test it in an incognito browser window before clicking Verify Domain.
07 · Pro Feature
Google Pay
Let customers pay with any card saved in their Google account — on Android, Chrome, or any Google Pay-enabled browser — with a single tap. No separate registration is needed.
1
Enable Google Pay in NMI
In NMI Control Panel, go to Settings → Gateway Features → Google Pay and enable it. You'll receive a Google Pay Merchant ID from NMI — copy it.
2
Configure in Plugin Settings
Go to RobustPay Settings › Google Pay
3
Test on Chrome / Android
The Google Pay button is only shown when the customer's browser supports it and they have cards saved in their Google account. Test on Chrome on Android or desktop Chrome. In test mode, use a Google Pay test card when prompted.
08 · Pro Feature
ACH / eCheck Payments
Accept US bank account payments (checking or savings) directly on your WooCommerce checkout. ACH transactions typically carry lower processing fees than cards, making them ideal for high-value or B2B orders.
1
Confirm ACH is Enabled on Your NMI Account
ACH processing must be activated on your NMI merchant account by your ISO. In NMI Control Panel, go to Settings → Gateway Features and confirm ACH / eCheck is active. If not, contact your ISO or NMI support.
2
Enable ACH in Plugin Settings
Go to RobustPay Settings › ACH / eCheck
3
Configure Verification Method
Choose how customers verify ownership of their bank account. Routing + Account Number is the standard method — customers enter their details manually. If your NMI account supports it, you can also enable instant micro-deposit verification.
ACH transactions are only available to US customers. The ACH option will only display when the customer's billing address country is United States.
09 · Pro Feature
Customer Vault & Saved Cards
Customers can save their card securely to the NMI Customer Vault and use it for future orders, subscriptions, and payment method changes — without re-entering card details.
1
Enable Customer Vault in NMI
In NMI Control Panel, go to Settings → Gateway Features → Customer Vault and ensure it is enabled. This is a prerequisite for saved cards, subscriptions, and Apple/Google Pay tokenisation.
2
Enable Saved Cards in Plugin Settings
Go to RobustPay Settings › Saved Cards
3
Verify Customer-Facing Behaviour
After saving a card, customers should see it listed at:
$0 authorisation — if you have this enabled, NMI may flag certain bank-issued cards that don't support $0 auth. If customers report errors when saving cards, try disabling $0 auth so cards are only saved on actual purchases.
10 · Pro Feature
3D Secure 2 (3DS2)
3D Secure 2 adds an authentication step during checkout — a one-time code sent to the customer's phone or a biometric check — shifting fraud liability from you to the card issuer. Required for EU merchants (PSD2 / SCA compliance).
1
Enable 3DS on your NMI Account
Contact your ISO or NMI support to have 3DS2 enabled on your merchant account. Once enabled, it will appear under Settings → Gateway Features → 3D Secure in your NMI Control Panel.
2
Configure in Plugin Settings
Go to RobustPay Settings › 3D Secure
EU merchants: PSD2 Strong Customer Authentication (SCA) rules require 3DS for most online card transactions. Set mode to When required at minimum. Failing to do so may result in declined transactions from EU-issued cards.
11 · Pro Feature
Fraud Detection Rules
RobustPay - NMI Payment Gateway for WooCommerce lets you configure AVS, CVV, and velocity rules to automatically block high-risk transactions before they process.
| Rule | What it does | Recommended setting |
| AVS Check | Verifies the billing address and postcode match the card issuer's records | Block on full mismatch; allow partial match |
| CVV Check | Verifies the 3-digit security code on the back of the card | Block if CVV is not provided or doesn't match |
| Velocity Filter | Limits how many transactions can be attempted from the same IP or card in a time window | 5 attempts per 10 minutes is a good starting point |
| IP Blocklist | Block specific IP addresses or ranges from completing checkout | Add IPs only after confirmed fraudulent orders |
| Card Fingerprinting | Identifies when the same physical card is used across multiple different customer accounts | Enable and review flagged orders |
Overly strict AVS rules can decline legitimate orders — especially from international customers where postal code formats differ. Start with moderate settings and adjust based on your order data.
12 · Pro Feature
WooCommerce Subscriptions
RobustPay - NMI Payment Gateway for WooCommerce has full, two-way integration with WooCommerce Subscriptions. All subscription lifecycle events — initial charge, renewals, cancellation, reactivation, pause, payment method change, and amount changes — are handled and synced with NMI automatically.
| Initial purchase | Charges card and stores token in NMI Vault |
| Automatic renewal | Charges stored token on schedule set by WooCommerce Subscriptions |
| Admin "Process renewal" | Manually triggers charge through the plugin immediately |
| Customer cancels | Cancels subscription in WooCommerce; no further renewals are charged |
| Admin cancels | Same as above — billing stops immediately |
| Reactivation | Resumes billing on next renewal date |
| Change payment method | Customer adds a new card; new Vault token is used for future renewals |
| Amount / date change | WooCommerce Subscriptions updates the schedule; Pro uses the updated amount on next renewal |
1
Prerequisites
Ensure the following are in place before setting up subscriptions:
2
How Subscription Renewals Work
WooCommerce Subscriptions controls the billing schedule. When a renewal is due, it triggers a charge through RobustPay - NMI Payment Gateway for WooCommerce, which uses the customer's saved card token (stored in NMI Vault) to process the payment — without requiring the customer to re-enter their card.
3
Lifecycle Events Handled by Pro
EventWhat RobustPay - NMI Payment Gateway for WooCommerce does
Initial purchaseCharges card and stores token in NMI Vault
Automatic renewalCharges stored token on schedule set by WooCommerce Subscriptions
Admin "Process renewal"Manually triggers charge through the plugin immediately
Customer cancelsCancels subscription in WooCommerce; no further renewals are charged
Admin cancelsSame as above — billing stops immediately
ReactivationResumes billing on next renewal date
Change payment methodCustomer adds a new card; new Vault token is used for future renewals
Amount / date changeWooCommerce Subscriptions updates the schedule; Pro uses the updated amount on next renewal
4
Test Subscription Flow
With Test Mode enabled, create a test subscription product with a short trial (e.g. 1 day). Place a test order, then wait for or manually trigger a renewal to confirm the charge processes correctly. Check the subscription notes in WooCommerce › Subscriptions › [Order]
No separate NMI recurring billing plan is created. WooCommerce owns the billing schedule; NMI only handles the actual charge when instructed to by the plugin.
13 · Pro Feature
Smart Retry for Failed Renewals
When a subscription renewal payment fails (e.g. insufficient funds or expired card), Smart Retry automatically retries the charge on a configurable schedule instead of immediately cancelling the subscription.
1
Configure the Retry Schedule
Go to RobustPay Settings › Smart Retry
2
Configure Customer Notifications
WooCommerce Subscriptions handles the email notifications for failed payments and payment method update requests. Customise those emails at:
14 · Pro Feature
Analytics & Transaction Log
RobustPay - NMI Payment Gateway for WooCommerce includes a built-in analytics dashboard and a full transaction audit log — giving you visibility into revenue trends, payment method usage, and every transaction that has passed through your gateway.
1
Access the Analytics Dashboard
Go to:
2
Transaction Log
Every payment attempt — approved, declined, or refunded — is recorded in the transaction log at:
3
Export Transactions
From the transaction log, click Export CSV to download a spreadsheet of transactions filtered by date range, status, or payment method. Useful for reconciliation and accounting.
15 · Pro Feature
WordPress Multisite
RobustPay - NMI Payment Gateway for WooCommerce supports WordPress Multisite networks. The plugin can be network-activated and each sub-site can be configured independently with its own NMI Security Key and settings.
1
Network Activate the Plugin
Log into your WordPress Network Admin. Go to Network Admin › Plugins
2
Configure Each Sub-Site Independently
Each sub-site has its own WooCommerce settings. Visit each sub-site's WooCommerce › Settings › Payments › RobustPay
The Agency license is required for Multisite. A Single Site license can only be activated on one domain and will not support network-activated configurations.
16 · Pro Feature
White-Label Gateway Configuration
If your merchant account is through an NMI white-label partner (such as Clearent, Payrix, Basys, FluidPay, Payroc, and others), RobustPay - NMI Payment Gateway for WooCommerce can be configured to send transactions directly to that gateway's endpoint instead of the standard NMI endpoint.
1
Select Your Gateway
Go to RobustPay Settings › Gateway
2
Enter Your API Credentials
Enter the Security Key provided by your white-label processor. The key format and authentication method are the same as standard NMI — only the endpoint URL changes.
3
Test a Transaction
With Test Mode enabled, place a test order. Confirm the transaction appears in your white-label gateway's control panel (not the standard NMI dashboard) to verify the endpoint is configured correctly.
If you are unsure which endpoint to use, ask your ISO or the partner gateway's support team for their Direct Post API URL. It usually looks like https://secure.yourgateway.com/api/transact.php.
Common issues and how to resolve them.
❌ "There was an error reactivating the subscription with NMI"
This error occurs when the Customer Vault is not enabled on your NMI account, or when the customer's saved card token is missing. Ensure Customer Vault is active in NMI and that Saved Cards is enabled in RobustPay settings. If the token is missing, ask the customer to update their payment method.
❌ "300 – Invalid Amount" on payment method change
This usually happens when $0 authorisation is enabled but the customer's card issuer doesn't support it. Disable $0 auth in RobustPay Settings → Saved Cards. Cards will then be validated only on actual purchases.
❌ No saved payment methods shown in My Account
Saved cards require the Customer Vault to be active on your NMI account and Saved Cards to be enabled in the plugin. Also confirm the customer completed checkout successfully — the card is only saved on a successful first transaction, not on a failed one.
❌ Apple Pay button not showing
Apple Pay only appears in Safari on Apple devices with Apple Pay set up. Also confirm: (1) your domain was verified successfully, (2) the verification file is accessible without redirects, (3) the site is on HTTPS. Test on a real iPhone — simulators do not support Apple Pay.
❌ Card declined in test mode with "Invalid security key"
In test mode, NMI uses a separate test Security Key. Check that you have entered the correct key for the test environment (not your live key) in the plugin settings. Your ISO can provide the test key.
❌ Webhooks / order status not updating
RobustPay - NMI Payment Gateway for WooCommerce processes NMI responses synchronously (not via webhooks), so order status updates happen immediately at checkout. If an order is stuck on "Pending", check WooCommerce logs at WooCommerce → Status → Logs for the transaction error returned by NMI.
ℹ️ How do I enable debug logging?
Go to RobustPay Settings → Advanced and enable Logging. Then reproduce the issue. View logs at WooCommerce → Status → Logs and look for entries prefixed with "robustpay". Include the relevant log entries when contacting support.
18
Support
Priority support responds within 48 hours. Include your WordPress, WooCommerce, and PHP versions plus WooCommerce → Status → Logs when reporting an issue.