| 1 |
=== Pay with Vipps and MobilePay for WooCommerce === |
| 2 |
Contributors: wphostingdev, everydayas, iverok, perwilhelmsen, nikolaidev, lassepladsen, marcuz2k2k |
| 3 |
Author: WP Hosting, Everyday AS |
| 4 |
Author URI: https://www.wp-hosting.no/ |
| 5 |
Tags: woocommerce, vipps, mobilepay, recurring payments, subscriptions |
| 6 |
Version: 5.4.2 |
| 7 |
Stable tag: 5.4.2 |
| 8 |
Requires at least: 6.3 |
| 9 |
Tested up to: 7.0.0 |
| 10 |
Requires PHP: 8.0 |
| 11 |
Requires Plugins: woocommerce |
| 12 |
WC requires at least: 8.0.0 |
| 13 |
WC tested up to: 10.8.0 |
| 14 |
License: MIT |
| 15 |
License URI: https://choosealicense.com/licenses/mit/ |
| 16 |
Official Vipps MobilePay payment plugin for WooCommerce. |
| 17 |
|
| 18 |
== Description == |
| 19 |
*Official Vipps MobilePay payment plugin for WooCommerce. Let your Norwegian, Danish, and Finnish customers pay with Vipps and MobilePay for an easy, fast, and familiar shopping experience* |
| 20 |
|
| 21 |
Vipps is used by more than 93 % of Norway's population (4.2 million users). |
| 22 |
|
| 23 |
MobilePay is used by more than 92 % of Denmark's population (4.4 million users), and approximately 59 % of Finland's population (2.8 million users). |
| 24 |
|
| 25 |
Vipps and MobilePay are payment methods offered by Vipps MobilePay. |
| 26 |
|
| 27 |
When you enable this plugin, you will choose between offering either Vipps or MobilePay as a payment method for your customers - hence "Vipps/MobilePay" going forward. |
| 28 |
|
| 29 |
This is the official plugin for Vipps/MobilePay ePayments (*Vipps Nettbetaling*), Vipps MobilePay Express (*Vipps MobilePay Hurtigkasse*) and Vipps/MobilePay recurring payments. Increase your conversion rate by letting your customers choose Vipps/MobilePay directly in the checkout or even do an Express Checkout (Vipps only) from the cart or a product page directly. |
| 30 |
|
| 31 |
You can also do important back office tasks such as capture and refund directly from WooCommerce. Easy for your customer and easy for you. |
| 32 |
|
| 33 |
Read [information from Vipps MobilePay](https://developer.vippsmobilepay.com/docs/plugins/woocommerce/) about the plugin. |
| 34 |
|
| 35 |
=== Vipps/MobilePay ePayment === |
| 36 |
When you enable this plugin, your customers will be able to choose Vipps/MobilePay as a payment method in the checkout. There is no need to go via a third party payment method. If your customer choose Vipps/MobilePay, they fill in their name and address and is then asked to enter their phone number in the Vipps/MobilePay dialogue. They then confirms the payment in the Vipps/MobilePay app. Customer info like name and address is sent to the store from Vipps MobilePay. |
| 37 |
|
| 38 |
== Vipps/MobilePay recurring payments == |
| 39 |
|
| 40 |
Vipps/MobilePay recurring payments is perfect for you if you run a web shop with subscription based services or other products that would benefit from subscriptions. |
| 41 |
|
| 42 |
With Vipps/MobilePay recurring payments you can: |
| 43 |
|
| 44 |
* Sell recurring products (virtual and physical) |
| 45 |
* Offer subscription services |
| 46 |
|
| 47 |
See [How it works](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/how-it-works/) for an overview. |
| 48 |
|
| 49 |
Recurring payments requires [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) and a Vipps MobilePay MSN with recurring payments added. |
| 50 |
|
| 51 |
=== MobilePay Reservations are currently for 14 days === |
| 52 |
When a payment is completed with Vipps MobilePay, the money will be reserved, but only transferred to the merchant when the order is set to "Complete" or the money is captured manually. *For MobilePay, this reservation period is 14 days*, so you will need to ship and fulfill orders before this; or to make an agreement with the customer to capture the money before this period is over. For Vipps, the period is 180 days. For payments made by credit card in Vipps/MobilePay Checkout, the period can again be as short as 7 days. |
| 53 |
For details, please read the [developer FAQ](https://developer.vippsmobilepay.com/docs/knowledge-base/reserve-and-capture/#reserve-and-capture-faq). |
| 54 |
|
| 55 |
If the order only contains virtual and downloadable products, the plugin will capture the order automatically and set the order to "Completed" as is the standard WooCommerce rule. |
| 56 |
|
| 57 |
=== Vipps MobilePay Express === |
| 58 |
When you enable Vipps MobilePay Express, your customers can choose between the regular checkout or to go directly to Vipps or MobilePay. If they choose Vipps or MobilePay, they just submit their phone number, and the rest of the checkout process is done in the Vipps or MobilePay app. |
| 59 |
|
| 60 |
Since Vipps MobilePay knows who the customers are, they don’t have to enter all their personal information. The customer just choose the shipping method and accepts the payment. Vipps MobilePay will send all the necessary info back to the store. Easy, fast and secure. |
| 61 |
|
| 62 |
The express checkout can be done in the following ways: |
| 63 |
|
| 64 |
* From the cart |
| 65 |
* From the category pages |
| 66 |
* From the product page |
| 67 |
* From shareable links distributed by email, banners, etc. |
| 68 |
* From QR codes distributed digitally or in print |
| 69 |
|
| 70 |
Settings for the cart, category and product pages can be found in the WooCommerce settings for the Vipps MobilePay payment gateway. |
| 71 |
|
| 72 |
Shareable links and QR codes can be generated from the Vipps/MobilePay tab on the product page. |
| 73 |
|
| 74 |
=== Vipps MobilePay Checkout === |
| 75 |
|
| 76 |
With Checkout enabled in the plugin, you will get a complete checkout in your web shop, designed and run by Vipps MobilePay. |
| 77 |
Your customers can pay with Vipps, MobilePay, VISA or MasterCard, and they can also provide their shipping address and choose their preferred shipping method in a simple manner. |
| 78 |
|
| 79 |
**Checkout – important update** |
| 80 |
|
| 81 |
Vipps MobilePay has entered into an agreement to sell the Vipps MobilePay Checkout solution to [Kustom](https://www.kustom.co/). |
| 82 |
|
| 83 |
As part of this transition, *Vipps MobilePay Checkout* will become *Kustom Checkout*. This means the Checkout product you ordered will be delivered and developed by Kustom going forward. |
| 84 |
If you have questions, you can check our [FAQ](https://vippsmobilepay.com/vippsmobilepay-kustom). |
| 85 |
|
| 86 |
=== How to get started === |
| 87 |
* Sign up in the [Vipps MobilePay portal](https://portal.vippsmobilepay.com) and choose your product. |
| 88 |
* After 1-2 days you will get an email with login details to Vipps MobilePay Business Portal, where you can get the API credentials |
| 89 |
* Download and install the plugin |
| 90 |
* Configure the plugin |
| 91 |
|
| 92 |
=== How to install the plugin === |
| 93 |
1. Install the plugin using WordPress’ [built-in installer](https://codex.wordpress.org/Managing_Plugins#Installing_Plugins). The plugin can also be installed manually by upload the plugin files to the /wp-content/plugins/ directory. |
| 94 |
2. Activate the plugin through the 'Plugins' screen in WordPress. |
| 95 |
3. Go to the WooCommerce Settings page and choose Payment Gateways (Betalinger) and enable Vipps/MobilePay. |
| 96 |
4. Go the settings page for the Vipps MobilePay plugin and enter your Vipps MobilePay account keys. Your account keys are available in the Vipps Business Portal (detailed info in the section below) |
| 97 |
|
| 98 |
|
| 99 |
== Installation == |
| 100 |
1. Install the plugin using WordPress’ [built-in installer](https://codex.wordpress.org/Managing_Plugins#Installing_Plugins). The plugin can also be installed manually by upload the plugin files to the /wp-content/plugins/ directory. |
| 101 |
2. Activate the plugin through the 'Plugins' screen in WordPress. |
| 102 |
3. Go to the WooCommerce Settings page and choose Payment Gateways (Betalinger) and enable Vipps/MobilePay. |
| 103 |
4. Go the settings page for the Vipps MobilePay plugin and enter your Vipps MobilePay account keys. Your account keys are available in the Vipps MobilePay Business Portal (detailed info in the section below) |
| 104 |
|
| 105 |
=== How to get Vipps MobilePay account keys from Vipps MobilePay Business Portal === |
| 106 |
1. Sign in to the Vipps MobilePay Portal at [https://portal.vippsmobilepay.com/](https://portal.vippsmobilepay.com/) using Bank ID |
| 107 |
2. Select the "Utvikler" ("Developer") tab and choose Production Keys. Here you can find the merchant serial number (6 figures) |
| 108 |
3. Click on "Show keys" under the API keys column to see “Client ID”, “Client Secret” and “Vipps MobilePay Subscription Key” |
| 109 |
|
| 110 |
== Screenshots == |
| 111 |
1. Enable Vipps/MobilePay as a payment method. |
| 112 |
2. Enter your Vipps MobilePay account keys and configure the plugin. |
| 113 |
3. Setup and activate the recurring payment gateway in WooCommerce. |
| 114 |
4. Configure the plugin settings for recurring payments. |
| 115 |
|
| 116 |
== Contributing on Github == |
| 117 |
This project is hosted on Github at: https://github.com/vippsas/vipps-woocommerce |
| 118 |
|
| 119 |
== Upgrade Notice == |
| 120 |
Version 5.4.1 |
| 121 |
Ensure redirect from old settings screen to new works |
| 122 |
Version 5.4.1 |
| 123 |
Fix new orders showing as captured when they were not |
| 124 |
Version 5.4.0 |
| 125 |
Improved handling of refunds. Manual refunds are now only possible when payment has been captured. |
| 126 |
Improved handling of failed but retryable orders |
| 127 |
Version 5.3.4 |
| 128 |
Notice added about the sale of Checkout to Kustom |
| 129 |
Version 5.3.3 |
| 130 |
Fix a crash for woo versions below 9.2.0 |
| 131 |
Version 5.3.2 |
| 132 |
Improve express checkout banner on legacy checkokut screens |
| 133 |
Add new setting for retryable orders so these can be set to "cancel" or "failed" as required |
| 134 |
Version 5.3.1 |
| 135 |
Fix CSS issue with on-site messaging badges on small screens |
| 136 |
Ensure Express orders are always "cancelled", never "failed". |
| 137 |
Version 5.3.0 |
| 138 |
Aborted Vipps MobilePay orders are now "failed" instead of "cancelled" and can be retried as a new Vipps MobilePay session |
| 139 |
Error that occasionally sent the user to the homepage instead of Checkout fixed |
| 140 |
|
| 141 |
== Frequently Asked Questions == |
| 142 |
|
| 143 |
= In which countries can I use Vipps/MobilePay? = |
| 144 |
Vipps is currently only available in Norway (93 % user adoption in 2022) and Sweden. |
| 145 |
MobilePay is currently only available in Denmark and Finland (92 % and 59 % user adoption in 2025, respectively). |
| 146 |
|
| 147 |
= How can I get help if I have any issues? = |
| 148 |
For issues with your WooCommerce installation, use the support forum here on wordpress.org. For other issues you should contact Vipps MobilePay. |
| 149 |
|
| 150 |
= Why are orders put on-hold and not processing or completed? = |
| 151 |
This was the old default of this plugin until version 2.0. The newer default is now 'processing', but this also means that orders that are 'processing' will have their payment reserved, but not transferred to the merchant. You can still choose the status on-hold in the options screen. |
| 152 |
|
| 153 |
If you choose on-hold, orders with this status will have the payment reserved, but not yet transferred to the merchant. The money must be 'captured' before they are actually transferred to the merchant. You are normally only allowed to do this at the same time as the order is shipped. You can 'capture' the money explicitly on the order screen; but the money will be captured automatically when the order is set to "Processing" or "Complete". |
| 154 |
|
| 155 |
If you use the default or choose "processing", the same applies to this status: The order will be reserved, but not captured. You can do the capture manually, or it will automatically happen when the order is set to "Complete". Please note that you should ensure that your workflow is then so that the order is captured just before the package is shipped. |
| 156 |
|
| 157 |
There is an exception for orders where all items are both virtual and downloadable: These are not considered to need processing and will be captured automatically (and go directly to the 'Complete' status). It is possible to customize this property for your needs using the woocommerce_order_item_needs_processing filter. |
| 158 |
|
| 159 |
= Can I refund orders or part of orders using Vipps/MobilePay = |
| 160 |
Yes, you can do refunds, including partial refunds, using the standard WooCommerce mechanism (https://docs.woocommerce.com/document/woocommerce-refunds/). Additionally, if you cancel an order that was already captured, the money will be refunded for the whole order if the order is not too old. For older orders, you must use the refund mechanism explicitly. This is a safety feature. |
| 161 |
If automatic refund through the Vipps MobilePay API should fail, you will need to refund manually; in this case an error message to this effect will be displayed and the order annotated. |
| 162 |
|
| 163 |
= What is 'compatibility mode' in the settings? = |
| 164 |
Some plugins add new features to products or entirely new product types to WooCommerce; which the 'Express Checkout' function may not be able to handle. It can be possible to fix this using hooks and filters, but if you choose this feature, express checkout will be done in a different manner which is very much more likely to work for a given plugin. The cost is that the process will be _slightly_ less smooth. |
| 165 |
|
| 166 |
= Why is my shipping wrong when using express checkout? = |
| 167 |
It may be that the shipping method you are using some how does not work when calculated from the Vipps/MobilePay app, where the customer is somewhat anonymous. However, since version 1.4.0 this problem ought to be greatly reduced, so if you still have this problem, report this on the forum and we'll try to fix it. |
| 168 |
|
| 169 |
If you have shipping methods that add additional information on the 'normal' checkout page they will not be able to provide that information to Express Checkout plugin, since that page is bypassed. You may be able to add those options on a different page; but you may want to remove those options when using Express Checkout. |
| 170 |
|
| 171 |
Formerly, there was a filter used to work around this, namely 'woo_vipps_shipping_methods'. This still works, but if you use it, it will disable the 'new' shipping method calculation. You may still customize the Express Checkout shipping; the new filter is called 'woo_vipps_shipping_rates'. |
| 172 |
|
| 173 |
To be sure, you should test your shipping methods in Express Checkout before going live. |
| 174 |
|
| 175 |
= I'd like to use sequential order numbers at Vipps MobilePay instead of the WooCommerce order-ids using a sequential order number plugin. Does this plugins support that? |
| 176 |
Yes, though you need to ensure that the order-id's you produce like this are unique for your Vipps MobilePay account, and you currently have to use a filter in your themes' functions.php file. We recommend using a prefix for your order ids, so a filter that will work with sequential order numbers would look like |
| 177 |
|
| 178 |
`add_filter('woo_vipps_orderid', function ($default, $prefix, $order) { |
| 179 |
return $prefix . $order->get_order_number(); |
| 180 |
}, 10, 3);` |
| 181 |
|
| 182 |
= Do I need to have a license for WooCommerce Subscriptions in order to use recurring payments? = |
| 183 |
|
| 184 |
Yes, you do. Get it |
| 185 |
[here](https://woocommerce.com/products/woocommerce-subscriptions/). |
| 186 |
|
| 187 |
= Does the recurring payment part of the plugin work with the WooCommerce Memberships-plugin? = |
| 188 |
|
| 189 |
[WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) |
| 190 |
and |
| 191 |
[WooCommerce Memberships](https://woocommerce.com/products/woocommerce-memberships/) |
| 192 |
are able to work together for access to recurring memberships that unlock content. |
| 193 |
|
| 194 |
**WooCommerce Subscriptions is required in order to use Vipps/MobilePay recurring payments, but Memberships is not.** |
| 195 |
|
| 196 |
You can read about how WooCommerce Subscriptions and WooCommerce Memberships work together [here](https://docs.woocommerce.com/document/woocommerce-memberships-subscriptions-integration/). |
| 197 |
|
| 198 |
|
| 199 |
= When I use recurring payments, why do I have to capture payments for physical products manually? = |
| 200 |
|
| 201 |
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. |
| 202 |
|
| 203 |
You can read about it [here](https://www.forbrukertilsynet.no/english/guidelines/guidelines-the-standard-sales-conditions-consumer-purchases-of-goods-the-internet#chapter-7). |
| 204 |
|
| 205 |
If you have a valid reason to do so you can use the "Capture payment instantly" option from the "Vipps/MobilePay recurring payments" settings in your product's settings. |
| 206 |
|
| 207 |
= When I use recurring payments and a renewal happens, why is the order on hold? = |
| 208 |
|
| 209 |
This is because when an order is charged in Vipps MobilePay it takes 2 days before the payment has been fully captured from the customer's bank account. |
| 210 |
|
| 211 |
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. |
| 212 |
|
| 213 |
Alternatively you could look into using WooCommerce "Early renewals": [https://docs.woocommerce.com/document/subscriptions/early-renewal/](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. |
| 214 |
|
| 215 |
= Firewall ports = |
| 216 |
Ensure *outgoing* traffic to port 443 is open. This is used to communicate with Vipps MobilePay servers. |
| 217 |
|
| 218 |
= Does Vipps MobilePay offer a test environment for Vipps MobilePay for WooCommerce? = |
| 219 |
|
| 220 |
Yes, but you will need a separate account, and you will need to install a special test version of the Vipps/MobilePay app, available trough Testflight. For your test account, the keys will be at https://portal-test.vipps.no; you will configure these in the developer mode settings. |
| 221 |
|
| 222 |
Contact Vipps MobilePay for access to the test app. This app must be installed on a device that does not have the normal Vipps/MobilePay app installed, or there will be conflicts. |
| 223 |
|
| 224 |
To use test mode, switch "Developer mode" on. There you can input the test keys from portal-test.vipps.no and turn test mode on and off. |
| 225 |
|
| 226 |
If this isn't practical for your usage, we recommend that you "test in production" with a small amount, like 2 NOK. Just refund or cancel the purchase as needed. |
| 227 |
|
| 228 |
|
| 229 |
= What are the requirements? = |
| 230 |
* WooCommerce 3.3.4 or newer is required |
| 231 |
* PHP 7.4 or higher is required. |
| 232 |
* An SSL Certificate is required. |
| 233 |
|
| 234 |
= Filters and Hooks for customization = |
| 235 |
There are several filters and hooks you can use to customize the behaviour of this plugin: |
| 236 |
* Filter: 'woo_vipps_is_available': Takes a boolean availability argument and the gateway and must return true or false |
| 237 |
* Filter: 'woo_vipps_express_checkout_available': Takes a boolean availability argument and the gateway and must return true or false. |
| 238 |
* Filter: 'woo_vipps_cart_express_checkout_button': Receives a complete button text and the URL needed to proceed to the express checkout page. |
| 239 |
* Filter: 'woo_vipps_express_checkout_banner': Receives a message with an express checkout button and an URL for the same, should return a message for the express checkout banner normally shown on the checkout page |
| 240 |
* Filter: 'woo_vipps_buy_now_button': Takes HTML for the button, and optionally product id, variation id, sku and if the button is to be shown as disabled by default |
| 241 |
* Filter: 'woo_vipps_show_express_checkout' - Takes a boolean, returns whether or not to show the express checkout button |
| 242 |
* Filter: 'woo_vipps_show_single_product_buy_now' - Takes a boolean and a product, returns true if the product should show a 'buy now with vipps' button |
| 243 |
* Filter: 'woo_vipps_show_single_product_buy_now_in_loop' - Like above, but especially for products shown in the loop - catalog pages, archives and so forth |
| 244 |
* Filter: 'woo_vipps_spinner': takes one argument which is a 'wait' spinner for certain pages |
| 245 |
* Filter 'woo_vipps_express_checkout_shipping_rates' which replaces the 'woo_vipps_shipping_methods'. It takes a list of shipping methods, and order, and a cart. The format of the shipping methods is an array of 'rate' which is a WC_Shipping_Rate object, 'priority' which is an integer and the sort-order Vipps MobilePay will use to display the alternatives, and 'default', which is a boolean: This will be the default choice |
| 246 |
* Filter: 'woo_vipps_default_shipping_method' taking the default shipping method ID, a list of the shipping methods available (as a table from method id to WC_Shipping_Rate object) and the order. Return a shipping rate id, like 'local_pickup:5' |
| 247 |
* Filter: 'woo_vipps_vipps_formatted_shipping_methods'. This will take an array of the methods to be sent to Vipps MobilePay, formatted as required by Vipps MobilePay. This is mostly for debugging. |
| 248 |
* Filter: 'woo_vipps_shipping_callback_packages': Takes the 'packages' from the cart used to calculate shipping in the shipping details callback |
| 249 |
* Filter 'woo_vipps_express_checkout_final_shipping_rate': Takes an WC_Shipping_Rate object, the order, and the shipping info from Vipps MobilePay. Must return a WC_Shipping_Rate object which will be added to the order. |
| 250 |
* Filter: 'woo_vipps_country_to_code': Takes a country code and a country name. Should return a two-letter ISO-3166 country code from a given country name |
| 251 |
* Filter: 'woo_vipps_show_capture_button': Takes a boolean and an order and returns whether or not to show the capture button in the backend |
| 252 |
* Filter: 'woo_vipps_captured_statuses': Returns a list of the statuses for which Vipps MobilePay should try a capture when transitioning to them. |
| 253 |
* Filter: 'woo_vipps_transaction_text': Takes a transaction text and an order object, must return a text to be passed to Vipps MobilePay and displayed to the user along the lines of "Please confirm your order" |
| 254 |
* Filter: 'woo_vipps_special_page_template': Takes a (complete) template path as returned by locate_template and the ID of the Vipps MobilePay special page, should return a new template path (using locate_template or similar). |
| 255 |
* Filter: 'woo_vipps_order_failed_redirect': Takes an empty string or an url and an order id. If URL is returned, go there on cancelled or failed orders. |
| 256 |
* Filter: 'woo_vipps_product_supports_express_checkout': Takes a boolean and a product, returns true if the product can be bought with express checkout |
| 257 |
* Filter: 'woo_vipps_cart_supports_express_checkout': Takes a boolean and a cart, returns true if the cart can be bought with express checkout |
| 258 |
* Filter: 'woo_vipps_express_checkout_supported_product_types': Returns a list of product types (as strings) that can be bought with express checkout |
| 259 |
* Filter: 'woo_vipps_orderid': Takes default Vipps MobilePay orderid, the order prefix, and an order object. Must return an unique (at Vipps MobilePay) order ID with 30 chars or less. Default is the prefix + orderid, e.g. 'Woo364'. |
| 260 |
* Action: 'woo_vipps_shipping_details_callback_order': Takes an order-id and the corresponding vipps order id. Run at the start of the shipping methods callback. |
| 261 |
* Action: 'woo_vipps_restoring_cart': Takes an order and a saved cart contents array, ran after the order has failed or is aborted |
| 262 |
* Action: 'woo_vipps_cart_restored': Runs after the cart has been restored after the order has been aborted of failed |
| 263 |
' Action: 'woo_vipps_cart_saved': When redirecting to Vipps MobilePay, the cart is saved so it can be restored in case the order isn't completed. This action is ran after this has happened. |
| 264 |
* Action: 'woo_vipps_before_redirect_to_vipps': Takes an order-id, called at the end of process_payment right before the redirect to Vipps MobilePay |
| 265 |
* Action: 'woo_vipps_before_create_express_checkout_order': Takes the cart to do express checkout for, run before the order is created |
| 266 |
* Filter : 'woo_vipps_create_express_checkout_cart_contents': Takes a cart contents array from which an express checkout order will be created . Should return a like array. |
| 267 |
* Action: 'woo_vipps_express_checkout_order_created': Takes an order ID, run right after an express checkout order has been created, but before it is processed' |
| 268 |
* Action: 'woo_vipps_before_process_payment': Takes an order-id, called at the start of process_payment |
| 269 |
* Action: 'woo_vipps_wait_for_payment_page': Run on the page shown on return from Vipps MobilePay |
| 270 |
* Action: 'woo_vipps_express_checkout_page': Run on the express checkout page, before redirect to Vipps MobilePay |
| 271 |
* Action: 'woo_vipps_set_order_shipping_details': Takes an order object, shipping details from Vipps MobilePay and user details from Vipps MobilePay. Runs after shipping details have been added to the order on return from express checkout. |
| 272 |
* Action: 'woo_vipps_callback': Runs when Vipps MobilePay does the callback on a successful payment, takes Vipps MobilePay data as input. Useful for logging/debugging the callback. |
| 273 |
* Action: 'woo_vipps_express_checkout_get_order_status': Takes the order status returned by Vipps MobilePay - called when the Vipps MobilePay callback hasn't happened and we need the order status. Useful for logging. |
| 274 |
* Action: 'woo_vipps_vipps_callback': Is ran when the Vipps MobilePay callback happen, with the decoded and raw POST from Vipps MobilePay. Useful for logging. |
| 275 |
* Action: 'woo_vipps_shipping_details_callback': Is ran when Vipps MobilePay does the shipping details callback on express checkout. Takes decoded and raw POST from Vipps MobilePay, and the callback args. For debugging. |
| 276 |
* Action: 'woo_vipps_shipping_details_before_cart_creation': Run after order is updated but before a cart is created to do shipping calculations. Takes an order, The order-id at Vipps MobilePay and the callback arguments from Vipps MobilePay |
| 277 |
* Filter: 'woo_vipps_transaction_text_shop_id': This is used to identify your shop in the transaction texts sent to Vipps MobilePay (and shown to the user). Default is home_url(), but there is a length limit, so this filter allows you to keep it short. |
| 278 |
|
| 279 |
= Shortcodes = |
| 280 |
* [woo_vipps_express_checkout_button] will print the express checkout button if valid |
| 281 |
* [woo_vipps_express_checkout_banner] will print the express checkout banner normally shown on the checkout page for non-logged-in users |
| 282 |
* [woo_vipps_buy_now sku=<SKU> id=<productid> variant=<variant id>] prints a "buy now" button given a SKU or an (product or variant) id. Just the SKU is sufficient. |
| 283 |
|
| 284 |
== Extending the Order Management API integration == |
| 285 |
From version 1.10.0, this plugin implements the Vipps MobilePay Order Management API, sending a receipt to the customers' app, and sending the order confirmation link as the Order Confirmation link category. You can, using this api, send over an image and a link for the categories receipt (RECEIPT), ticket (TICKET), shipping (DELIVERY), booking (BOOKING) and a general category (GENERAL). |
| 286 |
|
| 287 |
For instance, if you have a page or url for tracking shipping, you can add this to the customers' app by extending the 'woo_vipps_add_order_categories' filter like so: |
| 288 |
|
| 289 |
`add_filter('woo_vipps_add_order_categories', function ($categories, $order, $gateway) { |
| 290 |
$shippingpagedata = array( |
| 291 |
'link' => <your shipping URL here>, |
| 292 |
'image' => <filename or attachment ID of your illustration for shipping here, if required>, |
| 293 |
'imagesize' => <for attachments, the image size to use>); |
| 294 |
$categories['DELIVERY'] = $shippingpagedata; |
| 295 |
return $categories; |
| 296 |
}, 10, 3);` |
| 297 |
|
| 298 |
You can similarily send ticket information (with e.g. a QR code) for the TICKET or BOOKING category and so forth. |
| 299 |
|
| 300 |
= Javascript filters and actions = |
| 301 |
From version 1.1.13 you can also modify the javascript using the new WP hooks library for javascript: |
| 302 |
* 'vippsBuySingleProduct' - action which is run whenever a customer tries to buy a single product using express checkout |
| 303 |
* 'vippsBuySingleProductCompatMode' - filter which should return true or false, if true, the compatibility mode action will be run instead of the standard ajax. |
| 304 |
* 'vippsBuySingleProductCompatModeAction' - filter which should return a javascript function to run when buying a product and compatibility mode is on. Will normally press the "Buy" button for you. |
| 305 |
* 'vippsRemoveErrorMessages' - runs when Vipps MobilePay error messages are to be removed. |
| 306 |
* 'vippsErrorMessage' - runs for every Vipps MobilePay error message added with Javascript. Takes the message as an argument |
| 307 |
* 'vippsAddErrorMessage' - runs when an error message is about to be added. Takes the message as an argument |
| 308 |
* 'vippsInit' - runs when a page with a Vipps MobilePay button is initialzed |
| 309 |
* 'vippsStatusCheckErrorHandler' - A filter that should return function taking a statustext and an error object. It receives the default error handler, and is called when checking the order status with ajax for some reason ends up in an error. |
| 310 |
|
| 311 |
== Changelog == |
| 312 |
= 2026-05-27 version 5.4.2 = |
| 313 |
Fix redirect to custom settings screen |
| 314 |
|
| 315 |
= 2026-05-20 version 5.4.1 = |
| 316 |
Fix new orders showing as captured when they were not |
| 317 |
|
| 318 |
= 2026-05-11 Version 5.4.0 = |
| 319 |
Improved handling of refunds. Manual refunds are now only possible when payment has been captured. |
| 320 |
Improved handling of failed but retryable orders |
| 321 |
|
| 322 |
= 2026-05-06 Version 5.3.4 = |
| 323 |
Notice added about the sale of Checkout to Kustom |
| 324 |
|
| 325 |
= 2026-05-04 Version 5.3.3 = |
| 326 |
Fix express heckout for woo versions less than 9.2.0 |
| 327 |
Vipps Checkout now in legacy mode and available only for existing installs |
| 328 |
|
| 329 |
= 2026-03-26 Version 5.3.2 = |
| 330 |
Improve express checkout banner on legacy checkokut screens |
| 331 |
Add new setting for retryable orders |
| 332 |
|
| 333 |
= 2026-03-23 Version 5.3.1 = |
| 334 |
Fix CSS issue with on-site messaging badges on small screens |
| 335 |
Ensure Express orders are always "cancelled", never "failed". |
| 336 |
|
| 337 |
= 2026-03-23 Version 5.3.0 = |
| 338 |
Aborted Vipps MobilePay orders are now "failed" instead of "cancelled" and can be retried as a new Vipps MobilePay session |
| 339 |
Error that occasionally sent the user to the homepage instead of Checkout fixed |
| 340 |
|
| 341 |
= 2026-03-11 Version 5.2.2 = |
| 342 |
Fix CSS issues in the standard Checkout |
| 343 |
|
| 344 |
= 2026-03-09 Version 5.2.1 = |
| 345 |
Fix: Only show the recurring Checkout when there's a recurring product in your shopping cart. |
| 346 |
|
| 347 |
= 2026-03-02 Version 5.2.0 = |
| 348 |
Bump required versions of php, WP and Woo to reasonably modern versions |
| 349 |
Fixed all blocks to be compatible with the new iframe based block editor |
| 350 |
Ensure Pickup Locations are editable if any are defined since these are available in Express and Checkout |
| 351 |
Make the new interactivity based minicart work correctly with Checkout |
| 352 |
|
| 353 |
= 2026-02-23 version 5.1.6 = |
| 354 |
Fix customer prefill in Checkout |
| 355 |
Add block to support new interactivity-API based minicart for Express Checkout |
| 356 |
Handle swedish and finnish phone numbers correctly when canonicalizing |
| 357 |
Support Tutor LMS in Express and Checkout |
| 358 |
All blocks updated to version 3 |
| 359 |
Show Express Checkout button in cart if the settings say so, even with Vipps Checkout active |
| 360 |
Suppress permission warnings |
| 361 |
|
| 362 |
= 2026-02-11 version 5.1.5 = |
| 363 |
Suppress REST warning about permission callback |
| 364 |
|
| 365 |
= 2026-02-04 version 5.1.4 = |
| 366 |
Fix translations |
| 367 |
Fix customer prefill in checkout when customer is known |
| 368 |
|
| 369 |
= 2026-02-04 version 5.1.3 = |
| 370 |
Fix: javascript crash in backend |
| 371 |
|
| 372 |
= 2026-02-03 version 5.1.2 = |
| 373 |
Allow the Buy Now block to be inserted in all contexts, providing a button to buy an arbitrary product via Express on any page |
| 374 |
Minor improvements for compatibility for translation plugins |
| 375 |
Improve error-handling when a shipping method has been paid for in Vipps MobilePay Express, but cannot be added to the Woo order |
| 376 |
|
| 377 |
= 2026-01-19 version 5.1.1 = |
| 378 |
Fix link to the settings-page for the login app |
| 379 |
Fix rendering of Buy-Now block in Product Collections block |
| 380 |
Improve user interface of Buy-Now block |
| 381 |
Style improvements for the express checkout block |
| 382 |
Improve logging for shipping for express checkout |
| 383 |
|
| 384 |
= 2026-01-06 version 5.1.0 = |
| 385 |
Fix errors preventing order completion in certain situations using Checkout and Klarna Payments |
| 386 |
New option in settings/advanced to modify phone numbers in Express or Checkout so that they either get an added "+" or the country prefix is removed |
| 387 |
New, more space-efficient buttons and a new button configurator interface |
| 388 |
|
| 389 |
= 2025-12-16 version 5.0.14 = |
| 390 |
Fixed fatal typo in express checkout |
| 391 |
= 2025-12-16 version 5.0.13 = |
| 392 |
Fix: language in Checkout when using multilang plugins. |
| 393 |
Fix: encoding issue in Express checkout. |
| 394 |
Fix: manual Woo refund triggering Vipps MobilePay refund when the entire remaining amount is refunded |
| 395 |
|
| 396 |
= 2025-11-24 version 5.0.12 = |
| 397 |
Added new filter for adding options to Express Checkout, 'woo_vipps_modify_express_checkout_rate'. This for adding options like delivery times etc to your custom shipping methods and rates |
| 398 |
|
| 399 |
= 2025-11-17 version 5.0.11 = |
| 400 |
Added filters for selecting "user language" when necesssary |
| 401 |
Improved handling of chosen shipping method for Checkout |
| 402 |
Improving Mailchimp integration when using Express Checkout |
| 403 |
|
| 404 |
= 2025-11-10 version 5.0.10 = |
| 405 |
Fixed expiry of checkout sessions when WooCommerce times out an order |
| 406 |
Added support for TranslatePress to "get customer language" |
| 407 |
Changed headers for Express Checkout orders in the API to allow for better logging |
| 408 |
|
| 409 |
= 2025-10-27 version 5.0.9 = |
| 410 |
Fixed incompatibility notice in the checkout block |
| 411 |
|
| 412 |
= 2025-10-20 version 5.0.8 = |
| 413 |
Fix for Checkout Posti shipping method crash. |
| 414 |
Fix a bug where a log line did not show order id correctly. |
| 415 |
|
| 416 |
= 2025-10-13 version 5.0.7 = |
| 417 |
New feature for deleting all settings when deactivating plugin (under settings/advanced). |
| 418 |
Changed loading of certain web component scripts to async. |
| 419 |
Fix more logging print bugs |
| 420 |
|
| 421 |
= 2025-10-10 version 5.0.6 = |
| 422 |
Fix a bug in a rare logging print |
| 423 |
|
| 424 |
= 2025-09-30 version 5.0.5 = |
| 425 |
Handle edge-case for rounding of shipping prices in checkout and express |
| 426 |
|
| 427 |
= 2025-09-30 version 5.0.4 = |
| 428 |
Make express checkout provide addresses for virtual orders again (if requested) |
| 429 |
|
| 430 |
= 2025-09-22 version 5.0.3 = |
| 431 |
Properly handle shipping when coupons are added |
| 432 |
Fix spurious error logs when express checkout orders are cancelled. |
| 433 |
|
| 434 |
= 2025-09-15 version 5.0.2 = |
| 435 |
Fix Checkout widgets on mobile |
| 436 |
Fix phone numbers being stripped when using external payment methods |
| 437 |
|
| 438 |
= 2025-09-01 version 5.0.1 = |
| 439 |
Fix buttons for Express for finland |
| 440 |
|
| 441 |
= 2025-09-01 version 5.0.0 = |
| 442 |
Fix for session handling for shipping in Express checkout |
| 443 |
Now supports New Express Checkout, including support for pickup locations |
| 444 |
|
| 445 |
= 2018.06 version 1.0 = |
| 446 |
Changelog trunated -- see payment/changelog.txt for the full log |
| 447 |
|
| 448 |
|
