Skip to main content

Vipps Recurring Payments for WooCommerce

This plugin is built and maintained by Everyday AS and is hosted on GitHub.

This is the official Vipps Recurring Payments plugin for WooCommerce. It is owned by Vipps AS and maintained by Everyday AS.

Vipps Recurring Payments for WooCommerce is perfect for you if you run a web shop with subscription based services or other products that would benefit from subscriptions.

With Vipps Recurring Payments for WooCommerce you can:

  • Sell recurring products (virtual and physical)
  • Offer subscription services

See How it works for an overview.

Requirements​

  • WooCommerce 3.3.4 or newer
  • WooCommerce Subscriptions
  • PHP 7.0 or higher
  • An SSL certificate must be installed and configured
  • Port 443 must not be blocked for outgoing traffic

Getting started​

  • Sign up to use (Vipps på Nett)
  • Vipps will review the application and perform KYC and AML controls. You may log onto portal.vipps.no to see the status of your application. This is also where you can retrieve the API credentials used to configure the plugin in WooCommerce after your application has been approved.
  • Proceed to Installation.

Installation​

  1. Download and activate the plugin from this GitHub repository or Vipps Recurring Payments for WooCommerce on wordpress.org
  2. Enable the Vipps Recurring Payments ("Vipps faste betalinger") payment method in WooCommerce: Settings > Payments ("Betalinger").
  3. Click Manage on the payment method.
  4. Proceed to Retrieving Vipps API Keys.

Setup

Retrieving Vipps API Keys​

Log-in to portal.vipps.no and get your test API keys, as described in API keys.

Configuration of the plugin​

  1. Fill in the client_id, client_secret and Vipps-Subscription-Key found in the previous step.
  2. That's it! You can now move on to Configuring products.

Settings

Configuring products​

Configuring products for use with the Vipps Recurring Payments plugin is not any different from default WooCommerce, with one exception: The configuration for whether the product is virtual or physical is important to consider.

If a product is virtual the customer will be charged immediately but if the product is physical you will have to capture the payment manually through the order in WooCommerce when you have shipped the product.

In most cases your products should be virtual when using subscriptions, but it is possible to use the plugin with physical products if you need to do so.

See the Vipps API FAQ for more details: What is the difference between "Reserve Capture" and "Direct Capture"?.

Extending the plugin​

WooCommerce and WooCommerce Subscriptions has a lot of default actions that interact with the payment flow, so there should not be any need to extend this plugin directly, but if you need an action or filter added to the plugin don't hesitate to create an issue on GitHub, and we will look into this as soon as possible.

The plugin is currently in a pre-release phase and will have more filters, actions and features further down the road.

Constants​

Constants can be re-defined by using define('CONSTANT_NAME', 'value'); in wp-config.php.

WC_VIPPS_RECURRING_RETRY_DAYS: (integer) default: 4

The amount of days Vipps will retry a charge for before it fails. See Charge retries for more information.

WC_VIPPS_RECURRING_TEST_MODE: (boolean) default: false

Enables someone with access to Vipps developer keys to test the plugin. This is not available to regular users. See #how-can-i-test-that-the-plugin-works-correctly.

Actions​

Available actions:

wc_vipps_recurring_after_payment_complete(WC_Order $order)

Filters​

Available filters:

wc_vipps_recurring_supported_currencies(array $currencies) - Takes an array of supported currencies in ISO 4217 format (like NOK). Vipps only supports NOK at the moment.

wc_vipps_recurring_payment_icons(array $icons) - Takes an array of icons that a WooCommerce payment gateway can have. Currently, it only contains vipps, you can replace the image passed here if you want. It is however not recommended unless it follows Vipps' design specifications.

wc_vipps_recurring_show_capture_button(bool $show_capture_button, WC_Order $order) - Decides whether the direct capture button shall be displayed on an order or not. Prior to version 1.2.1 this filter was called woocommerce_vipps_recurring_show_capture_button. $show_capture_button contains the current value for displaying the capture button or not. $order contains the current WC_Order being viewed.

wc_vipps_recurring_merchant_agreement_url(string $url) - Allows you to modify the merchant agreement URL.

wc_vipps_recurring_merchant_redirect_url(string $url) - Allows you to modify the merchant redirect URL.

wc_vipps_recurring_transaction_id_for_order(string $transaction_id, WC_Order $order) - Determines the return value of WC_Vipps_Recurring_Helper::get_transaction_id_for_order

wc_vipps_recurring_create_agreement_data(array $data) - Allows you to alter the request body sent to the Vipps API when a new agreement is being created.

wc_vipps_recurring_update_agreement_data(array $data) - Allows you to alter the request body sent to the Vipps API when an agreement is being updated.

wc_vipps_recurring_cancel_agreement_data(array $data) - Allows you to alter the request body sent to the Vipps API when an agreement is cancelled.

wc_vipps_recurring_create_charge_data(array $data) - Allows you to alter the request body sent to the Vipps API when a new charge is being created.

wc_vipps_recurring_process_payment_agreement(WC_Vipps_Agreement $agreement, WC_Subscription $subscription, WC_Order $order) - Allows you to modify the Vipps agreement before we send the request to the Vipps API. Includes subscription and order in case you need to make some custom logic.

Frequently Asked Questions​

How can I get help?​

If your question is not answered on this page:

Does this plugin work alongside the Vipps for WooCommerce plugin?​

Yes! You can use this plugin at the same time as Vipps for WooCommerce.

Do I need to have a license for WooCommerce Subscriptions in order to use this plugin?​

Yes, you need a WooCommerce Subscriptions license to use this plugin.

Does this plugin work with the WooCommerce Memberships-plugin?​

WooCommerce Subscriptions and WooCommerce Memberships are able to work together for access to recurring memberships that unlock content.

Please note: WooCommerce Subscriptions is required in order to use Vipps Recurring Payments for WooCommerce, but WooCommerce Memberships is not.

You can read about how WooCommerce Subscriptions and WooCommerce Memberships work together at WooCommerce Memberships Subscriptions Integration.

Where can I use Vipps?​

Vipps is only available in Norway at the moment and only users who have Vipps will be able to pay with Vipps.

How can I test that the plugin works correctly?​

If you have access to the Vipps test environment, you are able to use the test mode by setting the WC_VIPPS_RECURRING_TEST_MODE constant in wp-config.php. See the getting started guide for details about how to get started using the test environment.

Vipps does not offer test accounts for regular users of the plugin, but you can still penny-test the plugin by sending a small amount of money like 1 or 2 NOK using your production keys. You can then refund or cancel the purchase afterwards.

Why do I have to capture payments for physical products manually?​

This is because of the Norwegian law. You are not allowed to charge for a physical product before you ship it, without a valid reason to do so.

See Guidelines for the standard sales conditions for consumer purchases of goods over the internet for more information.

If you have a valid reason to do so you can use the Capture payment instantly option from the Vipps Recurring Payments settings in your product's settings.

When a renewal happens, why is the order on hold?​

This is because when an order is charged in Vipps, it takes 2 days before the payment has been fully captured from the customer's bank account.

After 2 days, it will move to the "Processing" status. You can however change the behavior of this by using the "Default status to give pending renewals" option in the plugin settings.

Alternatively, you could look into using WooCommerce "Early renewals": https://docs.woocommerce.com/document/subscriptions/early-renewal/ if ensuring the status of a charge is fully completed before a specific date is of utmost importance.