Vipps Recurring Payments for WooCommerce

Beskrivelse

This plugin provides support for Vipps recurring payments for WooCommerce.

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

We encourage you to create an issue here or on the GitHub page if you require assistance or run in to a problem.

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)
  • After 1-2 days you will get an email with login details to Vipps Developer Portal. This is where you can retrieve the API credentials used to configure the plugin in WooCommerce.
  • Proceed to «Installation» below

Skjermskudd

  • Setup and activate the payment gateway in WooCommerce
  • Configure the plugin settings

Installasjon

To use the plugin you need to do the following:

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

Retrieving Vipps API Keys

The documentation for retrieving your Vipps API Keys can be found here.

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»

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 or not 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 Recurring FAQ,
and the
Vipps eCom FAQ
for more details:
What is the difference between «Reserve Capture» and «Direct Capture»?.

FAQ

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 do. Get it
here.

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.

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

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

How can I get help if I have any issues?

For issues with the plugin you can submit an issue on GitHub or ask on the support forum on wordpress.org. For other unrelated issues you should contact Vipps.

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.

You can read about it here.

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 behaviour of this by using the «Default status to give pending renewals» option in the plugin settings.

Alternatively you 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 up-most importance.

Vurderinger

Det er ingen omtaler av denne utvidelsen.

Bidragsytere og utviklere

“Vipps Recurring Payments for WooCommerce” er programvare med åpen kildekode. Følgende personer har bidratt til denne utvidelsen.

Bidragsytere

“Vipps Recurring Payments for WooCommerce” har blitt oversatt til 1 språk. Takk til oversetterne for deres bidrag.

Oversett “Vipps Recurring Payments for WooCommerce” til ditt språk.

Interessert i utvikling?

Bla gjennom koden, sjekk ut SVN-repositoriet, eller abonner på utviklingsloggen med RSS.

Endringslogg

1.5.0

  • Fix: No longer mark an order as «Failed» if a charge’s status is «FAILED» unless an agreement is also «EXPIRED» or «STOPPED» (a user can be prompted to swap card or top-up bank account in-app).
  • Fix: No longer attempt to cancel an already cancelled charge.
  • Fix: We should no longer hit the Vipps API rate-limit as a result of a renewal order.
  • Fix: Properly set the _charge_id meta key when capturing a payment.
  • Fix: Changing of gateways to Vipps Recurring Payments would sometimes cancel the new agreement instead of the old one due to a race condition.
  • Fix: Multiples of the same product in the same subscription will now be charged correctly based on the total order price.
  • Tweak: Updated the WC_VIPPS_RECURRING_RETRY_DAYS constant to 4 days by default.
  • Enhancement: Bolstered compatibility with WC < 3.0. Created a bunch of helper functions and doubled down on our backwards compatibility with fetching IDs and fetching plus updating meta.
  • Enhancement: If you update a subscription’s order item prices this will now be reflected in the app.

1.4.6

  • Fix: Fix a bug when an agreement is created twice on the same order. We didn’t fetch the right charge ID. This is a temporary fix I will have to revisit later on a proper setup.

1.4.5

  • Fix: Changed how we make requests to minimize the amount of times we hit Vipps’ rate limits. If you have gotten a lot of exceptions lately
    that look like this: HTTP Response Error: (recurring/v2/agreements/:id/charges) with request body: Array it’s because of rate limits.
  • Enhancement: Errors caused by HTTP requests now have more debug information attached to them.

1.4.4

  • Enhancement: Added an option to move renewal orders from «processing» to «completed» when the charge completes in Vipps.

1.4.3

  • Fix: Truncate agreement description if it’s longer than 100 characters and truncate productName if it’s longer than 45.

1.4.2

  • Fix: Truncate initialCharge description if it’s longer than 45 characters.

1.4.1

  • Fix: Added a polyfill for the PHP array_key_last function for hosts with PHP < 7.3.0.

1.4.0

  • Enhancement: Added a «Default status to give orders with a reserved charge» option.
  • Enhancement: Improved safety of reserved charges, they should never be put in an unrecoverable state anymore. Un-nested payment logic so we should never run into a similar case again.
  • Fix: Refunding a reversed charge now works, just like pending charges in version 1.3.9.
  • Change: «Default status to give pending renewal orders» default is now «processing» instead of «on hold»
  • Change: Removed «completed» as a possible default status for the «Default status to give pending renewal orders» setting as this status is conventionally used for orders that are completely finished.