Enabling Flutterwave

Connect Flutterwave under Settings > Payments to offer it at checkout. Customers who select Flutterwave are redirected to Flutterwave's hosted payment page to complete their payment and then return to your store.

Before you start

• Sign in as the store owner or with a staff account that has permission to manage Payments. Staff accounts without Payments permission cannot open the Flutterwave settings page.
• Have an eligible Flutterwave merchant account for a market where Flutterwave operates (across supported African countries, the UK, the US and Europe). Before accepting real payments, complete business verification and compliance requirements in your Flutterwave Dashboard.
• Confirm that your store currency is supported by the Flutterwave integration. Nevuto supports GBP, CAD, XAF, CLP, COP, EGP, EUR, GHS, GNF, KES, MWK, MAD, NGN, RWF, SLL, STD, ZAR, TZS, UGX, USD, XOF and ZMW for Flutterwave. The examples in this guide use USD, which does not by itself establish merchant eligibility in every region.
• Start in Flutterwave Test Mode with your test API keys before switching to live credentials.

Open the Flutterwave setup

1. Open Settings > Payments in your Nevuto admin.
2. Click Add payment, then select Add payment provider.
3. In the Add payment method modal, type Flutterwave into Enter payment method. Clear any category tab filter if it hides the result.
4. Select the Flutterwave card to open its setup form.

If Flutterwave is already configured on your store, click its row on the Payments page or open its three-dot menu and choose Manage. Opening the setup form does not connect the provider until you submit valid settings. Select any screenshot to view it at full size.

Match Flutterwave API keys to the Nevuto fields

In your Flutterwave Dashboard, open Settings > API Keys and check whether the dashboard environment switch is set to Test or Live. See Flutterwave's authentication and API keys guide for where to copy your keys.

Match the Flutterwave values to the fields in Nevuto:

• Public key: Your live Flutterwave Public Key (typically prefixed with FLWPUBK-).
• Secret key: Your live Flutterwave Secret Key (typically prefixed with FLWSECK-).
• Sandbox public key (inside Sandbox mode): Your test-mode Flutterwave Public Key (typically prefixed with FLWPUBK_TEST-).
• Sandbox secret key (inside Sandbox mode): Your test-mode Flutterwave Secret Key (typically prefixed with FLWSECK_TEST-).

Configure sandbox mode

1. In the Flutterwave setup form, locate Configure API keys and expand Sandbox mode.
2. Paste your test Public Key into Sandbox public key.
3. Paste your test Secret Key into Sandbox secret key. During initial test-only setup, you can leave the live Public key and Secret key fields empty.
4. Turn on Enable sandbox mode so Nevuto uses your test credentials.
5. Turn on Enable payment status when you are ready for Flutterwave to appear at checkout during testing.
6. Review Payment Limits if you want to restrict Flutterwave by cart amount.
7. Click Submit in the upper-right corner and wait for the confirmation toast.

When you click Submit, Nevuto checks the selected environment's secret key with Flutterwave before saving. On a successful first save, Nevuto returns to Settings > Payments. Reopen Flutterwave to verify that your values were stored.

In the Payments list, Active or Inactive indicates whether customers can see the payment method at checkout, while Sandbox or Live shows which credential set is active.

This screenshot shows an unsaved example. All four credential fields are intentionally empty and Enable payment status is off. Enter your own Flutterwave test keys and review payment status before clicking Submit.

Test the customer payment flow

After saving your sandbox settings, test the complete checkout redirect and return path before accepting live orders. Review Flutterwave's testing guide for current v3 test card numbers, PINs, OTP values and simulated failure scenarios.

To run your own merchant test after saving sandbox credentials:

1. Add a product to your storefront cart and proceed to checkout using a supported currency such as USD.
2. Select Flutterwave as the payment method and continue to Flutterwave's hosted checkout page.
3. Enter one of Flutterwave's official test cards (never use a real card in sandbox mode) and complete the test PIN or 3D Secure verification step.
4. Wait for Flutterwave to redirect back to your store and check how the order and payment status appear in Nevuto.
5. Verify that the test transaction is recorded in your Flutterwave Dashboard under Test Mode.
6. Run a cancelled or declined test payment as well to confirm that incomplete payments are not marked as paid.

A saved configuration or Active badge only confirms that the gateway passed the initial API check; always verify the full return flow in your store before going live.

Set payment limits

Use Payment Limits to control the cart totals for which Flutterwave is shown at checkout. Turn on the Payment Limits switch and enter a Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum amount cannot be greater than the maximum amount.

Switch to live payments

After verifying your test checkout flow and confirming that your Flutterwave account is approved for live transactions:

1. In your Flutterwave Dashboard, switch from Test to Live mode and open Settings > API Keys to copy your live Public Key and Secret Key.
2. In Nevuto, open Settings > Payments and select Flutterwave.
3. Paste your live Public Key into Public key and your live Secret Key into Secret key.
4. Expand Sandbox mode and turn off Enable sandbox mode.
5. Confirm Enable payment status and Payment Limits are set as intended.
6. Click Submit and confirm that Settings > Payments lists Flutterwave as Active in Live mode.

Your test keys can remain in the sandbox fields; turning off Enable sandbox mode switches Nevuto to your live credentials.

Edit or deactivate Flutterwave

Open Flutterwave from Settings > Payments any time you need to rotate API keys, adjust cart limits or switch environments. Submit stays disabled until you change a field on the form.

To stop offering Flutterwave at checkout without deleting your keys, turn off Enable payment status and click Submit, or open the three-dot menu on the Flutterwave row in Settings > Payments and choose Deactivate. Choosing Delete from the three-dot menu removes the saved Flutterwave configuration from your store. Deactivating or deleting Flutterwave only affects new checkouts and does not refund or cancel past orders. Because Nevuto does not process Flutterwave refunds from the order screen, issue any refunds from your Flutterwave Dashboard.

Troubleshooting