Help

Enabling Nets Easy

Connect a Nets Easy account, configure test and live secret keys, verify the hosted checkout flow, and set optional cart limits.

Updated

Connect Nets Easy (Nexi Checkout) under Settings > Payments to accept hosted online payments through your Nets Easy merchant account. Customers who select Nets Easy at checkout are redirected to Nets Easy's hosted payment page to complete 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 Nets Easy settings page.
  • Have an eligible Nets Easy (Nexi Checkout) merchant account. Nets Easy primarily serves merchants in the Nordic countries and Europe; complete Nexi's merchant onboarding and account verification before accepting live payments.
  • Confirm that your store currency is supported by the Nets Easy integration: CHF, CZK, DKK, EUR, GBP, NOK, PLN, SEK or USD. While this guide uses USD examples, a USD store currency does not by itself establish merchant eligibility outside Nets Easy's supported markets.
  • Copy your test and live integration keys from the Nets Easy (Nexi Checkout) portal before starting.

Open the Nets Easy setup

  1. In your Nevuto admin, go to Settings > Payments.
  2. Click Add payment in the upper-right corner, then select Add payment provider.
  3. In the Add payment method modal, enter Nets Easy in Enter payment method. Clear any category tab filter if it hides the result.
  4. Select the Nets Easy card to open its setup form.

If Nets Easy is already configured on your store, click its row on Settings > Payments or open the row's three-dot menu and choose Manage. Opening the setup form does not connect or activate the provider until you submit valid credentials. Select any screenshot to view it at full size.

Match Nets Easy API keys to the Nevuto fields

In your Nets Easy (Nexi Checkout) portal, open Company > Integration to view your Secret key and Checkout key for both the Test and Live environments. See Nexi Checkout's API reference and Nexi Checkout's test environment guide for where to copy your keys.

Match your Nets Easy values to the fields in Nevuto:

  • Public key: Your live Nets Easy Checkout key (optional; required only if you fill it in alongside your live Secret key during initial setup).
  • Secret key: Your live Nets Easy Secret key (required for live payments).
  • Sandbox public key (inside Sandbox mode): Your test Nets Easy Checkout key (optional).
  • Sandbox secret key (inside Sandbox mode): Your test Nets Easy Secret key (required for sandbox testing).

Do not include a Bearer prefix when pasting your Secret key, and do not swap the Checkout key into the Secret key field. Keep secret keys private and out of screenshots, emails and support tickets.

Important Because Nevuto uses only your Secret key (or Sandbox secret key) to create and verify hosted payment sessions, reopening the Nets Easy settings page after saving displays only the saved Secret key and Sandbox secret key while leaving Public key and Sandbox public key blank. If you enter a value in Public key or Sandbox public key during initial setup, you must also enter the matching Secret key or Sandbox secret key in the same save.

Configure sandbox mode

  1. In the Nets Easy setup form under Configure API keys, click Sandbox mode to expand the test fields.
  2. Paste your test Secret key into Sandbox secret key (and optionally your test Checkout key into Sandbox public key). You can leave the live fields blank while setting up only sandbox testing.
  3. Turn on Enable sandbox mode so Nevuto connects to Nets Easy's test environment.
  4. Turn on Enable payment status when you want Nets Easy offered at checkout during your test.
  5. Review Payment Limits if you want to restrict Nets Easy by cart total.
  6. Click Submit in the upper-right corner and wait for the confirmation toast.

When you click Submit, Nevuto validates the active secret key against Nets Easy before saving. On a successful first save, Nevuto returns to Settings > Payments. Reopen Nets Easy to confirm that your secret key and mode were saved.

In the Payments list, Active or Inactive controls whether customers see Nets Easy at checkout, while Sandbox or Live shows which credential environment is active.

This screenshot shows an unsaved example. All four credential fields are intentionally empty and Enable payment status is off. Enter your own Nets Easy test secret key before clicking Submit.

Test the hosted checkout flow

After saving your sandbox settings, test a complete customer checkout and return flow before switching to live keys. Review Nexi Checkout's test environment documentation for official test card numbers, expiration dates, CVV values and test customer data. Never use a real payment card in sandbox mode.

To run your own test checkout after saving sandbox credentials:

  1. Add a product to your storefront cart in a supported currency (such as USD or EUR) and proceed to checkout.
  2. Select Nets Easy as the payment method and continue to Nets Easy's hosted payment page.
  3. Enter one of Nexi Checkout's official test cards and complete any simulated 3D Secure prompt.
  4. Wait for Nets Easy to redirect back to your store and confirm that the order is marked as paid in Nevuto.
  5. Open your Nets Easy (Nexi Checkout) test portal and verify that the test payment appears with matching reference, currency and amount.
  6. Also run a cancelled checkout or declined test card to verify that incomplete payments return the customer to checkout without marking the order as paid.

An Active badge in Settings > Payments only confirms that your secret key passed the save-time check; always verify a full test payment and return path before accepting live orders.

Set payment limits

Use Payment Limits to control which cart totals can use Nets Easy 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.

The $50–$500 USD range shown above is a prepared unsaved example, not a saved store setting or required range. Turn Payment Limits off if you do not want a custom cart-total restriction in Nevuto. Click Submit after editing limits and reopen the form to verify they were stored.

Switch to live payments

After your sandbox tests succeed and your live Nets Easy merchant account is approved:

  1. In your Nets Easy (Nexi Checkout) portal, copy your live Secret key from Company > Integration.
  2. In Nevuto, open Settings > Payments and select Nets Easy.
  3. Paste 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 verify that Settings > Payments lists Nets Easy as Active in Live mode. Reopen Nets Easy to confirm your live secret key is saved.

Your test secret key can remain in Sandbox secret key; turning off Enable sandbox mode switches Nevuto to your live credentials.

Edit or deactivate Nets Easy

Open Nets Easy from Settings > Payments (or choose Manage from the row's three-dot menu ) any time you need to rotate keys, change modes or update cart limits. Submit remains disabled until you edit a field on the form.

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

Troubleshooting

Was this guide helpful?