Enabling Stripe

Connect your Stripe account under Settings > Payments to accept payments through Stripe. Customers choosing this option continue to Stripe's hosted checkout to complete their card payment, then return to your store.

Before you start

• Use the store owner account or a staff account with permission to manage Payments. Staff without that permission cannot access the Stripe settings form.
• Have access to the correct Stripe account and its API keys. Before accepting real payments, complete any account activation requirements shown in your Stripe Dashboard.
• Check that Stripe is available for your store currency in the payment-provider picker. The examples in this guide use USD.
• Start with a Stripe sandbox and its test credentials. Keep test and live credentials separate.

This guide covers the Stripe payment provider in Settings > Payments. Its setup uses an API key from your Stripe account.

Open the Stripe setup

1. Open Settings > Payments.
2. Click Add payment, then choose Add payment provider.
3. In the provider picker, search for Stripe using Enter payment method. Clear any category filter if it hides the result.
4. Select Stripe to open its setup form.

If Stripe is already configured, open its row on the Payments page, or open the row's three-dot menu and choose Manage.

Selecting a provider opens its form; it does not finish connecting the account. The setup must be submitted successfully before it appears as a configured payment method.

Select any screenshot to view it at full size.

Choose the correct Stripe key

Open the API keys page in your Stripe Dashboard for the account or sandbox you intend to connect. Stripe uses separate credentials for sandbox and live environments. See Stripe's API key guide.

Match the key to the Nevuto field:

• Secret key: Your live account's secret API key, normally beginning with sk_live_, for accepting real payments.
• Sandbox secret key: The secret API key for your Stripe test environment, normally beginning with sk_test_, for testing.

A publishable key beginning with pk_ or a webhook signing secret beginning with whsec_ is not the secret API key requested by this form. Keep secret keys out of screenshots, support messages and shared documents. Stripe also offers restricted keys; this guide does not provide a verified restricted-key permission configuration for Nevuto.

Configure sandbox mode

1. In the Stripe form, find Configure API keys.
2. Expand Sandbox mode.
3. Paste your test secret API key into Sandbox secret key. You can leave Secret key empty when setting up only the test environment.
4. Turn on Enable sandbox mode so Nevuto uses the test credentials.
5. Turn on Enable payment status if you want Stripe offered at checkout during your test.
6. Review Payment Limits and any additional options before submitting.
7. Click Submit in the upper-right corner. Wait for the result and resolve any reported error.

On a successful first setup, Nevuto returns to Payments. Reopen Stripe and confirm that your settings were stored. The Payments table shows the provider's Active or Inactive status and its Sandbox or Live mode separately.

Payment status and sandbox mode are separate settings. An active provider can still be using test credentials. Sandbox mode does not by itself enable the payment method.

This screenshot shows an unsaved example. Both credential fields are intentionally empty, and payment status is still off. Enter your own test secret key and review payment status before submitting your setup.

Test the customer experience

After saving the sandbox configuration:

1. Create a test cart in your storefront and continue to checkout.
2. Check that Stripe appears for the cart and select it.
3. Continue to Stripe's hosted checkout. Use Stripe's official test card details, not a real card.
4. Return to Nevuto and review both the order's payment state and the payment in the same Stripe test environment.
5. Also check a cancelled or declined test payment so you understand the customer's return path.

For an interactive successful-card test, Stripe documents Visa 4242 4242 4242 4242, a future expiration date and any three-digit CVC. Use it only with test API keys in the test environment. Other scenarios and current test values are listed in Stripe's testing guide.

Set payment limits and optional authorization

Payment Limits controls when this payment method is offered based on cart amount. Turn it on to enter Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum must not exceed the maximum. Turn it off when you do not want a custom cart-amount range for Stripe; provider requirements still apply.

Hold payment until fulfilment, when shown, changes collection to an authorization followed by capture when the order ships. A hold reserves the amount on the customer's card instead of collecting it immediately. Leave this off for a standard immediate-payment setup unless your fulfillment process needs authorization and later capture. Test that complete order workflow before relying on it.

Switch to live payments

Once you have verified your test flow and your Stripe account is ready:

1. Open Settings > Payments and open Stripe.
2. Enter the live account's secret API key in Secret key.
3. Expand Sandbox mode and turn off Enable sandbox mode.
4. Check Enable payment status, payment limits and any authorization option.
5. Click Submit and wait for a successful result.
6. Confirm that Payments shows Stripe as Active with Live mode.

The test key stays in its separate field; replacing it is not how you switch to live mode. The sandbox toggle decides which credential Nevuto uses. Stripe's API key guide explains the separation between test and live environments.

Edit or deactivate Stripe

To update credentials or settings, open Stripe from Payments, change the relevant fields and click Submit. The button is disabled until the form has changes.

To stop offering Stripe, turn off Enable payment status and submit. The configured row's three-dot menu also offers Deactivate for an active method and Activate for an inactive one. These actions change the saved payment status; review the checkout options afterward.

Deactivating a method stops offering it for new checkout payments. It does not cancel an existing order or issue a refund.

Troubleshooting