Subscription support

  1. Home
  2. /
  3. Nexi Checkout
  4. /
  5. Get started
  6. /
  7. Subscription support

Subscription support


Nexi Checkout is compatible with the WooCommerce Subscriptions extension for handling of recurring payments.


To get started with recurring payments via Nexi Checkout in your WooCommerce store, you will need the extension WooCommerce Subscriptions installed and configured.

Get started with subscriptions

  1. Create a simple subscription product. Set it to a daily renewal so that we can test the renewal process as well.
  2. Make a test purchase (either with a real account or a test account).
  3. Make sure that:
    – The subscription order is created in both Nexi and WooCommerce.
    – A Nexi transaction number is added to the order notes in WooCommerce.
    – The subscription status is set to Active in WooCommerce.
  4. Wait 24 hours and check that the renewal order is created, a new reservation number from Nexi is added to the order notes in the renewal order and the subscription is set to Active again.
  5. You can speed up the renewal if you don’t want to wait 24 hours. Make sure that the order is set to Active and that the recurring token is in place. Then in the Subscription actions selectbox you can choose Process renewal and click Update.

Custom button text for subscription payments

If the cart in WooCommerce contain a subscription product, you have the possibility to change the text displayed on the Complete payment button. The setting can be found in the Nexi Checkout plugin settings under: ” Complete payment button text“. The default value for this setting is “Subscribe”.

Translations for the “Complete payment button text” setting selections:


Update payment method from My account page

If the customer wants to change the card used for the subscription, they can login to  My account and then navigate to the subscription. From this view they can click the Change payment button.

  • This will send the customer to the checkout page whereNexi Checkout is selected again as the payment method.
  • By clicking on the Change payment method button the customer is redirected to the hosted payment window. However, the amount of this order is set to 0.
  • Finally the customer is redirected back to the subscription page and can se a notice about the subscription payment method being updated.

The NExi subscription ID is now updated in the WooCommerce subscription and the new card/payment method will be used for future subscription renewals.


Why are no renewals being triggered at all?

This is usually because you are working in a staging/test environment. WooCommerce Subscriptions have a built-in feature that determine if your installation is a production site or a staging site. From the staging site no renewals are being triggered.

Read more about how WooCommerce Subscriptions handle staging sites and migrations here.

Why does the customer get redirected back to the checkout with an error when I offer a free trial?

If you offer Free trial with subscriptions the customer will keep getting redirected back to the checkout with the error Something went wrong with completing the order. Please try again or contact the store.

You will also find the following in the log REDIRECT ERROR [order_id]: Could not get an order_id from the merchant reference "your-reference.

The reason for this is that you have enabled $0 Initial Checkout in the Subscription settings.

When this setting is enabled, the payment gateway’s process_payment will not be called, which is what we use to store the merchant reference to the Woo order.

Solution: Go to: WooCommerce → Settings → Subscriptions and uncheck $0 Initial Checkout to disable it.