Vipps Recurring Payments for WooCommerce

Official Vipps Recurring Payments plugin for WooCommerce. 4 million Norwegians use Vipps. Give them a fast and familiar shopping experience.

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

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 (WooCommerce)
• 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” below

End Log

1.12.4

• Fixed: Product names no longer use the default context, meaning it will no longer get overridden by themes or plugins and show HTML in the Vipps app or app-switch screen.

1.12.3

• Fixed: Initial charge description no longer contains ” + ” when no extra products are purchased.
• Fixed: Filling in 0 in the trial field tricking us into adding a campaign to the product, also resulting in an empty initialCharge.description and being unable to check out.

1.12.2

• Fixed: Fixed an issue where initialCharge.description was empty. It cannot be empty under any circumstances.

1.12.1

• Fixed: A bug in Klarna Checkout where it would attempt to use Vipps Recurring Payments instead of Vipps Checkout when you’re only purchasing one time payment products.
• Fixed: Descriptions of products you are not paying for right away is no longer included in initialCharge’s description.
• Fixed: Campaigns are now used correctly when a single product is purchased along with a synced subscription product.
• Fixed: Campaigns are now used correctly when a single product is purchased along with a subscription product with a free trial.

1.12.0

• Added: Support for Klarna Checkout.
• Fixed: No longer attempt to load Vipps Recurring Payments if WooCommerce is disabled/not installed.
• Fixed: If you have a variable subscription product the Vipps settings from the “parent” will now be respected.
• Fixed: This gateway no longer shows up for single purchase products, only if there is at least one subscription product in the cart.

1.11.0

• Added: You can now pay for single payment products in the same shopping cart as a subscription.

1.10.0

• Refactor: Rewrote our admin notification system to allow for dismissible alerts.
• Added: A campaign banner for Login with Vipps. This will last for 10 days, and it is fully dismissible.

1.9.1

• Fix: Renewal orders will no longer transition to completed when the setting for this is turned off.
• Fix: Fixed a problem where our _vipps_recurring_waiting_for_gateway_change was never processed for orders where the subscription was not wc-active. Added wc-on-hold and wc-pending to this list.

1.9.0

• Enhancement: Added a setting for what sort order we should check charges by.
• Enhancement: Added a setting for how many charges we should check at a time.
• Enhancement: Default amount of charges to check per wp-cron run is now 10.
• Change: Removed extra sortable columns from pending charges and failed charges tables. Sorting by meta value does not work in WooCommerce’s wc_get_orders.
• Fix: Order by random now works as expected in our periodic status check for charges.

1.8.4

• Fix: The 1.8.2 migration will no longer throw a fatal error for some installations if a subscription does not exist on an order.

1.8.3

• Fix: Fixed an issue where an invalid “my account” page link would cause checkout to not work.

1.8.2

• Enhancement: Added _vipps_recurring_latest_failed_charge_reason and _vipps_recurring_latest_failed_charge_description to subscriptions.
• Enhancement: Migrate the aforementioned data.
• Enhancement: Update tested up to, now 5.8.

1.8.1

• Fix: Added an exit condition after attempting to redirect to the Cancelled Vipps Purchase page. This should in theory make this redirect work every single time.
• Fix: No longer clean up necessary data like charge id or whether the charge is pending on renewals.
• Fix: Force re-checking of older charges that are affected by the aforementioned fix.
• Change: We now check 8 charges at the same time instead of 5.

1.8.0

• Fix: Cancelled agreements can not be updated, thus we can not say that they have been cancelled in the description. Ensure we run the “maybe_update_subscription_details_in_app” code before we cancel an agreement, and only if the agreement is still “ACTIVE”.
• Fix: Ensure we only ever cancel an agreement once.
• Fix: It’s no longer possible to end up with more than one Vipps agreement by changing gateway twice or more on accident (this bug was introduced in 1.7.0).
• Enhancement: We now cancel DUE charges in Vipps when you change an order’s status to ‘Cancelled’ or ‘Failed’.

1.7.0

• Fix: Add missing Norwegian translation for “No failed charges found.”.
• Fix: Failed charges now appear properly in the “Failed charges” list.
• Fix: Fixed an edge case when changing payment method to Vipps as a customer, when already using Vipps.
• Fix: Support upgrading to a different product variation. Price is now passed along properly and a campaign is applied in order to not confuse the customer.
• Fix: Update agreement in app when downgrading or not prorating a subscription.
• Fix: Do not allow multiple subscriptions in a single Vipps payment when other gateways that support it are enabled.
• Fix: No longer show the “capture” button on an order where the charge has failed previously.
• Fix: Delete meta values from renewal and resubscribe orders to make sure we get fresh charges.
• Fix: WooCommerce’s automatic retry system should now work as expected on renewal orders. We now override the behaviour of wcs_is_scheduled_payment_attempt in our check_charge_status function.
• Enhancement: The subscription description is now prefixed in the Vipps app with “[Pending cancellation]”, “[Cancelled]” and “[On hold]” depending on the subscription’s status.
• Enhancement: Added a setting per product for what source should be used for an agreement’s description. You can now choose between product title, product short description, or custom text.
• Enhancement: Display sign up fees in a better way in the Vipps app. Use a campaign with a price of 0,- until the next payment date.
• Enhancement: Update item name and description in app for delayed in app updates.
• Enhancement: Added a link to explain the various possible failure reasons.
• Enhancement: Ability to change gateway from the admin dashboard, this means setting another Vipps agreement ID manually. This should also allow using the REST API to create a subscription.
• Enhancement: Bring style on notices and in product tabs up to par with the Vipps e-com plugin.

1.6.2

• Fix: Swapping payment gateway to Vipps now works again after the recent WooCommerce and WooCommerce Subscription updates.

1.6.1

• Fix: ‘free’ agreements where the agreement status is ‘STOPPED’ should not be completed.
• Fix: Do not attempt to fetch charge for synchronised renewals at initial order.
• Fix: Add ‘completed’ to ‘woocommerce_valid_order_statuses_for_payment_complete’ conditionally instead of rolling our own logic.
• Fix: Remove visibility modifier from const to fix support for PHP 7.0.

1.6.0

• Enhancement: There’s now an overview of failed charges and their failure reason on the Settings -> Vipps Recurring Payments page.
• Refactor: Use the Helper class for most of our frequently used meta keys.
• Refactor: Renamed the class filenames, class names remain untouched.
• Fix: Redirect to last known agreement confirmation URL if the agreement is pending. This prevents being stuck in checkout.

1.5.5

• Fix: No longer attempt to charge a non existent agreement when a renewal is attempted on a subscription that does not have a Vipps agreement.
• Fix: Multibyte characters like ‘æøå’ in product titles work, these characters caused an internal server error when json encoding.

1.5.4

• Fix: Cancelled or expired “zero amount” payments getting stuck in the checking queue

1.5.3

• Fix: A rare edge case where an order was never captured for a long time and the order would not disappear from the status checker tool.
• Fix: A rare edge case where a new pending renewal order would not fetch the Charge ID properly when hitting the capture payment button.
• Fix: Fixed an issue where 100% off coupons did not automatically complete the initial purchase
• Enhancement: The status checker tool now shows the latest status from the API as a column value
• Enhancement: We now validate Vipps API details when you save your settings

1.5.2

• Fix: Fixed a bug where you were able to checkout the same order more than once while a Vipps agreement is not expired. This fixes problems with multiple charges occurring.

1.5.1

• Fix: We’re no longer trying to cancel an agreement in Vipps when the status is anything other than ACTIVE.
• Fix: No longer throw an error and retry with “latest charge” when we hit a rate limit when checking a single charge.

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.