PluginProbe
Pay with Vipps and MobilePay for WooCommerce / 6.0.4
Pay with Vipps and MobilePay for WooCommerce v6.0.4
6.2.1 6.2.0 6.1.10 6.1.9 6.1.8 6.1.7 6.1.6 6.1.5 6.1.4 6.1.3 6.1.2 6.1.1 6.1.0 6.0.5 6.0.4 6.0.3 6.0.2 6.0.1 6.0.0 5.4.3 5.4.2 5.4.1 5.4.0 5.3.4 trunk All 183 releases
woo-vipps / payment / WC_Gateway_Vipps.class.php

WC_Gateway_Vipps.class.php in Pay with Vipps and MobilePay for WooCommerce 6.0.4, at payment/WC_Gateway_Vipps.class.php

4,288 lines 235.1 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 /*
3 Delegate class for talking to Vipps MobilePay, encapsulating all the low-level behaviour and mapping error codes to exceptions
4
5 This file is part of the plugin Pay with Vipps and MobilePay for WooCommerce
6 Copyright (c) 2019 WP-Hosting AS
7
8 MIT License
9
10 Copyright (c) 2019 WP-Hosting AS
11
12 Permission is hereby granted, free of charge, to any person obtaining a copy
13 of this software and associated documentation files (the "Software"), to deal
14 in the Software without restriction, including without limitation the rights
15 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
16 copies of the Software, and to permit persons to whom the Software is
17 furnished to do so, subject to the following conditions:
18
19 The above copyright notice and this permission notice shall be included in all
20 copies or substantial portions of the Software.
21
22 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
23 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
25 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
26 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
27 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
28 SOFTWARE.
29
30 */
31 if ( ! defined('ABSPATH') ) {
32 exit; // Exit if accessed directly
33 }
34 require_once(dirname(__FILE__) . "/VippsApi.class.php");
35
36 class WC_Gateway_Vipps extends WC_Payment_Gateway {
37 public $form_fields = null;
38 public $dev_form_fields = null;
39 public $id = 'vipps';
40 public $icon = '';
41 public $has_fields = true;
42 public $method_title = 'Vipps MobilePay';
43 public $title = 'Vipps MobilePay';
44 public $method_description = "";
45 public $apiurl = null;
46 public $testapiurl = null;
47 public $api = null;
48 public $supports = null;
49 public $express_checkout_supported_product_types;
50
51 public $captured_statuses;
52
53 private static $instance = null; // This class uses the singleton pattern to make actions easier to handle
54
55 protected $keyset = null; // This will contain all api keys etc for the gateway, keyed on the merchant serial number.
56
57 // Just to avoid calculating these alot
58 private $page_templates = null;
59 private $page_list = null;
60
61
62
63 // This returns the singleton instance of this class
64 public static function instance() {
65 if (null === self::$instance) {
66 self::$instance = new self();
67 }
68 return self::$instance;
69 }
70
71 public function add_image_upload_setting_widget () {
72 add_action('admin_enqueue_scripts', function ($suff) {
73 if ($suff == 'woocommerce_page_wc-settings' && (($_REQUEST['section'] ?? false) == 'vipps')) {
74 if (!did_action('wp_enqueue_media')) {
75 wp_enqueue_media();
76 }
77 }
78 });
79 }
80
81
82 // Generates html for the woo_vipps_image settings widget type
83 public function generate_woo_vipps_image_html ($key, $field) {
84 $field_key = $this->get_field_key( $key );
85 $defaults = array(
86 'title' => '',
87 'disabled' => false,
88 'class' => '',
89 'css' => '',
90 'placeholder' => '',
91 'type' => 'woo_vipps_image',
92 'desc_tip' => false,
93 'description' => '',
94 'custom_attributes' => array(),
95 );
96 $data = wp_parse_args( $field, $defaults );
97
98 $imgid = intval($this->get_option($key));
99 $image = $imgid ? wp_get_attachment_image_src($imgid) : "";
100
101 ob_start();
102 ?>
103 <tr valign="top">
104 <th scope="row" class="titledesc">
105 <label for="<?php echo esc_attr( $field_key ); ?>"><?php echo wp_kses_post( $data['title'] ); ?> <?php echo $this->get_tooltip_html( $data ); // WPCS: XSS ok. ?></label>
106 </th>
107 <td class="forminp">
108 <fieldset>
109 <legend class="screen-reader-text"><span><?php echo wp_kses_post( $data['title'] ); ?></span></legend>
110 <?php if ($image): ?>
111 <a href="#" class="woo-vipps-image-upload"><img style="max-width: 360px; max-height: 360px" src="<?php echo $image[0]; ?>" /><span style="display:none" class='uploadtext'><?php _e('Upload image', 'woo-vipps'); ?></span></a>
112 <a href="#" class="woo-vipps-image-remove"><?php _e('Remove image', 'woo-vipps');?></a>
113 <?php else: ?>
114 <a href="#" class="woo-vipps-image-upload"><img style="display:none; max-width:360px; max-height: 360px"/><span class='uploadtext'><?php _e('Upload image', 'woo-vipps'); ?></span></a>
115 <a href="#" class="woo-vipps-image-remove" style="display:none;"><?php _e('Remove image', 'woo-vipps');?></a>
116 <?php endif; ?>
117 <input type="hidden" class="woo-vipps-image-input <?php echo esc_attr( $data['class'] ); ?>" name="<?php echo esc_attr( $field_key ); ?>" id="<?php echo esc_attr( $field_key ); ?>" value="<?php echo esc_attr($imgid); ?>" <?php echo $this->get_custom_attribute_html( $data ); // WPCS: XSS ok. ?> />
118 <?php echo $this->get_description_html( $data ); // WPCS: XSS ok. ?>
119 </fieldset>
120 </td>
121 </tr>
122 <?php
123
124 return ob_get_clean();
125 }
126
127 // Attempts to detect the current country based on the store's currency NT-2024-10-15
128 private function detect_country_from_currency() {
129 $currency = get_woocommerce_currency();
130 switch ($currency) {
131 case 'DKK':
132 return 'DK';
133 case 'NOK':
134 return 'NO';
135 case 'SEK':
136 return 'SE';
137 case 'EUR':
138 return 'FI';
139 default:
140 return null;
141 }
142 }
143 // Migrates the keysets to include the country setting if it's missing
144 // This is an initial migration step to ensure the country setting is explicitly set.
145 // We do this because we no longer want to automatically guess payment method name. NT-2024-10-15
146 private function migrate_keyset_with_country_detection() {
147 $settings = get_option('woocommerce_vipps_settings', array());
148 if ($settings['country'] ?? false) return; // Already set, do nothing IOK 2024-10-17
149
150 // Now we are only wanting to do this with people who have already configured the plugin. These will have at least this value set:
151 if ($settings['payment_method_name'] ?? false) {
152 // This assumes that EUR == FI which will be correct for all users reaching this branch IOK 2024-10-17
153 $detected_country = $this->detect_country_from_currency();
154 // If we can't detect the country, there's nothing to migrate. "this cannot happen" etc.
155 if (!$detected_country) return;
156
157 $settings['country'] = $detected_country;
158 update_option('woocommerce_vipps_settings', $settings);
159 delete_transient('_vipps_keyset');
160 return;
161 }
162 }
163
164 public function __construct() {
165 $this->testapiurl = 'https://apitest.vipps.no';
166 $this->apiurl = 'https://api.vipps.no';
167
168 $this->method_description = __('Offer Vipps or MobilePay as a payment method', 'woo-vipps');
169 $this->method_title = __('Vipps MobilePay','woo-vipps');
170 $this->title = __('Vipps MobilePay','woo-vipps');
171
172 $this->icon = plugins_url('img/vmp-logo.png',__FILE__);
173 $this->migrate_keyset_with_country_detection();
174 $this->init_form_fields();
175 $this->init_settings();
176
177
178 $this->api = new VippsApi($this);
179
180 $this->supports = array('products','refunds');
181
182 // we need to disallow certain types of refunds; mostly manual refunds done before capture. IOK 2026-02-24
183 add_action( 'woocommerce_create_refund', array($this, 'woocommerce_create_refund'), 10, 2);
184
185 // We can't guarantee any particular product type being supported, so we must enumerate those we are certain about
186 // IOK 2020-04-21 Add support for WooCommerce Product Bundles
187 $supported_types= array('simple','variable','variation','bundle', 'yith_bundle', 'gift-card');
188 $this->express_checkout_supported_product_types = apply_filters('woo_vipps_express_checkout_supported_product_types', $supported_types);
189
190 add_action('woocommerce_update_options_payment_gateways_' . $this->id, array( $this, 'process_admin_options') );
191 add_action('admin_init', array($this, 'add_image_upload_setting_widget'));
192
193 // Capturing, refunding and cancelling the order when transitioning states:
194 // This are the statuses for which the Vipps MobilePay plugin should try to ensure capture has been made.
195 // Normally, this is 'processing' and 'completed', but plugins may define other statuses. IOK 2018-10-05
196 // It is also possible to remove 'processing' from this list. If you do, you may use it as the end-state of the
197 // Vipps MobilePay transaction (see below in after_vipps_order_status) IOK 2018-12-05
198 $resultstatus = $this->get_option('result_status');
199 $captured_statuses = apply_filters('woo_vipps_captured_statuses', array('processing', 'completed'));
200 $captured_statuses = array_diff($captured_statuses, array($resultstatus));
201
202 $this->captured_statuses = $captured_statuses;
203
204 $non_completed_captured_statuses = array_diff($captured_statuses, array('completed'));
205
206 // This ensures that funds are captured when transitioning from 'on hold' to a status where the money
207 // should be captured, and refunded when moved from this status to cancelled or refunded
208 foreach($captured_statuses as $capstatus) {
209 add_action('woocommerce_order_status_' . $capstatus, array($this, 'maybe_capture_payment'));
210 }
211 // We will refund money on cancelled orders, but only if they are *relatively new*. This is to
212 // avoid accidents and issues where old orders are *somehow* cancelled even though they are complete. IOK 2024-08-12
213 add_action('woocommerce_order_status_cancelled', array($this, 'maybe_cancel_order'));
214 // Add a full refund if neccessary *before* woocommerce does, on priority 10 IOK 2026-01-28
215 add_action('woocommerce_order_status_refunded', array($this, 'maybe_refund_order'), 9, 1);
216
217 // Possibly delete orders that never went anywhere
218 add_action('woocommerce_order_status_pending_to_cancelled', array($this, 'maybe_delete_order'), 99999, 1);
219 // Handle orders when authorized
220 add_action('woocommerce_payment_complete', array($this, 'order_payment_complete'), 10, 1);
221
222 // when an order is complete, we need to check if there is reserved amount that is not captured
223 // if so, we need to cancel this amount PMB 2024-11-21
224 // nb: note very late priority - we must have captured before, please
225 // Also for orders that have been partially or completely refunded, or need to be set to cancelled IOK 2026-01-26
226 add_action('woocommerce_order_status_completed', array($this, 'maybe_cancel_reserved_amount'), 99);
227 add_action('woocommerce_order_status_refunded', array($this, 'maybe_cancel_reserved_amount'), 99, 1);
228 add_action('woocommerce_order_status_cancelled', array($this, 'maybe_cancel_reserved_amount'), 99, 1);
229 }
230
231 // this function is called after an order is changed to complete/refunded/cancelled. It checks if there is reserved money that is not captured
232 // if there still is money reserved, then this amount is cancelled PMB 2024-11-21
233 // Ensure we've updated the vipps status before calling this. IOK 2026-01-28
234 public function maybe_cancel_reserved_amount ($orderid) {
235 $order = wc_get_order($orderid);
236 if (!$order) return;
237 if (! Vipps::is_vipps_order($order)) return false;
238 // Cannot partially cancel legacy ecom orders
239 if ('epayment' != $order->get_meta('_vipps_api')) return false;
240
241 // Check that the normal maybe_capture_order hook has actually ran *and* done something,
242 // it's only after this we know we have captured 'everything' so if there is anything left,
243 // it should be cancelled. IOK 2025-05-04
244 // Also set in maybe_cancel and maybe_refund now - in all "final status" hooks. IOK 2026-01-28
245 if (! $order->get_meta('_vipps_capture_complete')) {
246 return false;
247 }
248
249 $order_status = $order->get_status();
250
251 if ('completed' == $order_status) {
252 // For safety, on completed orders also only want to do this for orders that have had *something* captured. IOK 2025-02-04
253 $captured = intval($order->get_meta('_vipps_captured'));
254 if ($captured < 1) {
255 return false;
256 }
257 }
258 if ('cancelled' != $order_status) {
259 // If not in the 'cancelled' state, allow merchants that do not reserve large amounts to opt out for safety IOK 2025-02-04
260 if (apply_filters('woo_vipps_never_cancel_uncaptured_money', false, $order)) {
261 return false;
262 }
263 }
264
265 $ok = true;
266
267 $remaining = intval($order->get_meta('_vipps_capture_remaining'));
268
269 if ($remaining > 0) {
270 $this->log(sprintf(__("maybe_cancel_reserved_amount we have remaining reserved after capture of total %1\$s ",'woo-vipps'), $remaining),'debug');
271 } else {
272 // IOK 2026-06-15 Nothing left to cancel, just return
273 return false;
274 }
275
276 $currency = $order->get_currency();
277 try {
278 $ok = $this->cancel_payment($order);
279 if ($ok && $remaining && 'completed' == $order_status) {
280 $amount = number_format($remaining/100, 2) . " " . $currency;
281 $note = sprintf(__('Order %1$s: %2$s is cancelled to free up the reservation in the customers bank account.', 'woo-vipps'), $orderid, $amount);
282 $order->add_order_note($note);
283 }
284 } catch (Exception $e) {
285 $ok = false;
286 // if this happens, we just log it - we may not have an active admin
287 $msg = sprintf(__('Was not able to cancel remaining amount for the order %1$s: %2$s','woo-vipps'), $orderid, $e->getMessage());
288 $order->add_order_note($msg);
289 $this->log($msg,'error');
290 }
291
292 // We need to update the order details after the fact. We can't fix errors here though. IOK 2024-11-22
293 try {
294 $this->update_vipps_payment_details($order);
295 } catch (Exception $e) {
296 // noop
297 }
298
299 // we just return true from this function for now PMB 2024-11-21
300 // return false if we couldn't cancel reserved. IOK 2024-11-22
301 return $ok;
302 }
303
304
305 public function get_icon () {
306 $src = $this->icon;
307 if ($this->get_payment_method_name() == "Vipps") {
308 $src = plugins_url('img/vipps-mark.svg',__FILE__);
309 } else {
310 $src = plugins_url('img/mobilepay-mark.png',__FILE__);
311 }
312 return '<img src="' . esc_attr($src) . '" alt="' . $this->get_payment_method_name() . '">';
313 }
314
315
316 // True iff this gateway is currently in test mode. IOK 2019-08-30
317 public function is_test_mode() {
318 if (VIPPS_TEST_MODE) return true;
319 if ($this->get_option('developermode') == 'yes' && $this->get_option('testmode') == 'yes') return true;
320 return false;
321 }
322 // These abstraction gets the correct client id and so forth based on whether or not test mode is on
323 // "test mode" is now per MSN, so we accept that as an argument IOK 2023-12-19
324 public function apiurl ($msn="") {
325 $msn = $msn ?? $this->get_merchant_serial();
326 $keyset = $this->get_keyset();
327 $entry = $keyset ? ($keyset[$msn] ?? null) : null;
328 if (!$entry) {
329 $testmode = $this->is_test_mode();
330 } else {
331 $testmode = $entry['testmode'];
332 }
333 if ($testmode) return $this->testapiurl;
334 return $this->apiurl;
335 }
336
337 // This returns the *current* merchant serial number. There may be more than one, for instance if the test mode is on.
338 // IOK 2023-12-19
339 public function get_merchant_serial() {
340 $merch = $this->get_option('merchantSerialNumber');
341 $testmerch = @$this->get_option('merchantSerialNumber_test');
342 if (!empty($testmerch) && $this->is_test_mode()) return $testmerch;
343 return $merch;
344 }
345
346 // Returns a table of all the keydata of this instance, keyed on MSN. IOK 2023-12-19
347 public function get_keyset() {
348 if ($this->keyset) return $this->keyset;
349 $stored = get_transient('_vipps_keyset');
350 if ($stored) {
351 return $stored;
352 }
353
354 $keyset = [];
355 $main = $this->get_option('merchantSerialNumber');
356 if ($main) {
357 $data = ['client_id'=>$clientid=$this->get_option('clientId'),
358 'client_secret' => $this->get_option('secret'),
359 'sub_key'=>$this->get_option('Ocp_Apim_Key_eCommerce'),
360 'country' => $this->get_option('country'),
361 'gw' => 'vipps'
362 ];
363 if (! in_array(false, array_map('boolval', array_values($data)))) {
364 $data['testmode'] = 0; // Must add after
365 $keyset[$main] = $data;
366 }
367 }
368
369 $test = @$this->get_option('merchantSerialNumber_test');
370 $testmode = @$this->get_option('testmode');
371 if ($testmode === 'yes' && $test) {
372 $data = [
373 'client_id'=>$clientid=$this->get_option('clientId_test'),
374 'client_secret' => $this->get_option('secret_test'),
375 'sub_key'=>$this->get_option('Ocp_Apim_Key_eCommerce_test'),
376 'country' => $this->get_option('country'),
377 'gw' => 'vipps'
378 ];
379
380 if (! in_array(false, array_map('boolval', array_values($data)))) {
381 $data['testmode'] = 1;
382 $keyset[$test] = $data;
383 }
384 }
385
386 $this->keyset = $keyset;
387 set_transient('_vipps_keyset', $keyset, DAY_IN_SECONDS);
388 return $keyset;
389 }
390
391 // Get and show any keysets from the Vipps Recurring plugin too IOK 2024-11-29
392 private function get_recurring_keysets () {
393 $res = [];
394 $settings = get_option( 'woocommerce_vipps_recurring_settings' );
395 if (empty($settings)) return $res;
396
397 $country = $this->get_option('country');
398
399 $client_id = $settings["client_id"] ?? "";
400 $client_secret = $settings["secret_key"] ?? "";
401 $subscription_key = $settings["subscription_key"] ?? "";
402 $merchant_serial_number = $settings["merchant_serial_number"] ?? "";
403 if ($merchant_serial_number && $client_id && $client_secret && $subscription_key ) {
404 $res[$merchant_serial_number] = ['client_id' => $client_id, 'client_secret' => $client_secret, 'sub_key' => $subscription_key, 'country' => $country, 'testmode' => 0, 'gw'=>'vipps_recurring'];
405 }
406
407 $client_id = $settings["test_client_id"] ?? "";
408 $client_secret = $settings["test_secret_key"] ?? "";
409 $subscription_key = $settings["test_subscription_key"] ?? "";
410 $merchant_serial_number = $settings["test_merchant_serial_number"] ?? "";
411 if ($merchant_serial_number && $client_id && $client_secret && $subscription_key ) {
412 $res[$merchant_serial_number] = ['client_id' => $client_id, 'client_secret' => $client_secret, 'sub_key' => $subscription_key, 'country' => $country, 'testmode' => 1, 'gw'=>'vipps_recurring'];
413 }
414 return $res;
415 }
416
417 // Return all webhooks for our MSNs
418 public function get_webhooks_from_vipps () {
419 $keys = $this->get_keyset();
420 $hooks = [];
421 foreach($keys as $msn=>$data) {
422 try {
423 $hooks[$msn] = $this->api->get_webhooks($msn);
424 } catch (Exception $e) {
425 $this->log(sprintf(__('Could not get webhooks for Merchant Serial Number %1$s: %2$s', 'woo-vipps'), $msn, $e->getMessage()), 'error');
426 $hooks[$msn]=[];
427 }
428 }
429 return $hooks;
430 }
431
432
433 // The rest of the settings gets the correct client id, secret, sub key and order prefix based on the MSN.
434 public function get_clientid($msn="") {
435 if (!$msn) $msn = $this->get_merchant_serial();
436 $keyset = $this->get_keyset();
437 if (!isset($keyset[$msn])) return false;
438 return $keyset[$msn]['client_id'];
439 }
440 public function get_secret($msn="") {
441 if (!$msn) $msn = $this->get_merchant_serial();
442 $keyset = $this->get_keyset();
443 if (!isset($keyset[$msn])) return false;
444 return $keyset[$msn]['client_secret'];
445 }
446 public function get_key($msn="") {
447 if (!$msn) $msn = $this->get_merchant_serial();
448 $keyset = $this->get_keyset();
449 if (!isset($keyset[$msn])) return false;
450 return $keyset[$msn]['sub_key'];
451 }
452 public function get_country($msn="") {
453 if (!$msn) $msn = $this->get_merchant_serial();
454 $keyset = $this->get_keyset();
455 if (!isset($keyset[$msn])) return false;
456 return $keyset[$msn]['country'];
457 }
458
459 public function get_orderprefix() {
460 $prefix = $this->get_option('orderprefix');
461 return $prefix;
462 }
463
464 // We did shenanigans here earlier, we don't have to do that anymore. IOK 2022-12-09
465 public function get_return_url($order=null) {
466 $url = parent::get_return_url($order);
467 return $url;
468 }
469
470
471 // Delete express checkout orders with no customer information - these were abandonend before the app started.
472 // IOK 2019-08-26
473 public function maybe_delete_order ($orderid) {
474 $order = wc_get_order($orderid);
475 if (!$order) return;
476 if (! Vipps::is_vipps_order($order)) return false;
477 $express = $order->get_meta('_vipps_express_checkout');
478 if (!$express) return false;
479 $email = $order->get_billing_email();
480 if ($email) return false;
481
482 // Only delete if we have to
483 if ($this->get_option('deletefailedexpressorders') != 'yes') return false;
484 // Mark this order that an order that wasn't completed with any user info - it can be deleted. IOK 2019-11-13
485 $order->update_meta_data('_vipps_delendum',1);
486 $order->save();
487 return true;
488 }
489
490
491 // Return the status to use after return from Vipps MobilePay for orders that are not both "virtual" and "downloadable".
492 // These orders are *not* complete, and payment is *not* captured, which is why the default status is 'on-hold'.
493 // If you use custom order statuses, or if you don't capture on 'processing' - see filter 'woo_vipps_captured_statuses' -
494 // you can instead use 'processing' here - which is much nicer.
495 // If you do so, remember to capture *before* shipping is done on the order - if you send the package and then do 'complete',
496 // the capture may fail. IOK 2018-12-05
497 //
498 // IOK As of 2023-12-22, the default is now 'processing', since this is more in line with what other gateways are using,
499 // what other integrations and plugins expect, the most popular choice by users; and because of the fact that "on-hold" is
500 // normally used to indicate "a problem with the order". Not being able to capture a reserved order has to my knowledge at this
501 // point only happened once, in 2018, with a completely different api and backend.
502 public function after_vipps_order_status($order=null) {
503 // Revert to on-hold if the user tries to set a payment status that is a 'captured' status IOK 2024-01-25
504 $defaultstatus = 'on-hold';
505
506 $chosen = $this->get_option('result_status');
507 $newstatus = apply_filters('woo_vipps_after_vipps_order_status', $chosen, $order);
508
509 if (in_array($newstatus, $this->captured_statuses)){
510 $this->log(sprintf(__("Cannot use %1\$s as status for non-autocapturable orders: payment is captured on this status. See the woo_vipps_captured_statuses-filter.",'woo-vipps'), $newstatus),'debug');
511 return $defaultstatus;
512 }
513 return $newstatus;
514 }
515
516 // Create callback urls' using WC's callback API in a way that works with Vipps MobilePay callbacks and both pretty and not so pretty urls.
517 private function make_callback_urls($forwhat,$token='', $reference=0) {
518 // Passing the token as GET arguments, as the Authorize header is stripped. IOK 2018-06-13
519 // This applies to Ecom, Checkout and Express Checkout callbacks. For epayment, we instead need to use
520 // the webhook api, which is altogether different. IOK 2023-12-19
521 $url = home_url("/", 'https');
522 $queryargs = [];
523 if ($token) $queryargs['tk']=$token;
524 if ($reference) $queryargs['id']=$reference;
525
526 // HTTPS required. IOK 2018-05-18
527 // If the user for some reason hasn't enabled pretty links, fall back to ancient version. IOK 2018-04-24
528 if ( !get_option('permalink_structure')) {
529 $queryargs['wc-api'] = $forwhat;
530 } else {
531 $url = trailingslashit(home_url("wc-api/$forwhat", 'https'));
532 }
533 // And we need to add an empty "callback" query arg as the very last arg to receive the actual callback.
534 // We can't use add_query_arg for that, as an empty argument will remove the equals-sign.
535 $callbackurl = add_query_arg($queryargs, $url) . "&callback=";
536 return $callbackurl;
537 }
538
539 // Webhook callbacks do not pass GET arguments at all, but do provide an X-Vipps-Authorization header for verification. IOK 2023-12-19
540 public function webhook_callback_url () {
541 $url = home_url("/", 'https');
542 $queryargs = ['callback'=>'webhook'];
543 $forwhat = 'wc_gateway_vipps'; // Same callback as for ecom, checkout, express checkout
544 // HTTPS required. IOK 2018-05-18
545 // If the user for some reason hasn't enabled pretty links, fall back to ancient version. IOK 2018-04-24
546 if ( !get_option('permalink_structure')) {
547 $queryargs['wc-api'] = $forwhat;
548 } else {
549 $url = trailingslashit(home_url("wc-api/$forwhat", 'https'));
550 }
551 $callbackurl = add_query_arg($queryargs, $url);
552 return $callbackurl;
553 }
554
555
556 // The main payment callback
557 public function payment_callback_url ($token='', $reference=0) {
558 return $this->make_callback_urls('wc_gateway_vipps',$token, $reference);
559 }
560 public function shipping_details_callback_url($token='',$reference=0) {
561 return $this->make_callback_urls('vipps_shipping_details',$token,$reference);
562 }
563 // Callback for the consetn removal callback. Must use template redirect directly, because wc-api doesn't handle DELETE.
564 // IOK 2018-05-18
565 public function consent_removal_callback_url () {
566 $queryargs = [];
567 $url = home_url("/", 'https');
568 if ( !get_option('permalink_structure')) {
569 $queryargs['vipps-consent-removal']=1;
570 } else {
571 $url = trailingslashit(home_url('vipps-consent-removal', 'https'));
572 }
573 // And we need to add an empty "callback" query arg as the very last arg to receive the actual callback.
574 // We can't use add_query_arg for that, as an empty argument will remove the equals-sign.
575 return add_query_arg($queryargs, $url) . "&callback=";
576 }
577
578 // Allow user to select the template to be used for the special Vipps MobilePay pages. IOK 2020-02-17
579 public function get_theme_page_templates() {
580 if (!$this->page_templates) {
581 $choices = array('' => __('Use default template', 'woo-vipps'));
582 foreach(wp_get_theme()->get_page_templates() as $filename=>$name) {
583 $choices[$filename]=$name;
584 }
585 $this->page_templates = $choices;
586 }
587 return $this->page_templates;
588 }
589
590 // We can't use get_pages to get a default list of pages for our settings, because it triggers
591 // actions that can be used by other plugins. Therefore we must use the database directly and cache the results. IOK 2023-08-22
592 public function get_pagelist () {
593 if (!$this->page_list) {
594 global $wpdb;
595 $page_list = array(''=>__('Use a simulated page (default)', 'woo-vipps'));
596 foreach($wpdb->get_results("SELECT ID,post_title FROM {$wpdb->prefix}posts WHERE post_type='page' and post_status='publish'") as $page) {
597 $page_list[$page->ID] = $page->post_title;
598 }
599 $this->page_list = $page_list;
600 }
601 return $this->page_list;
602 }
603
604 // Check to see if the product in question can be bought with express checkout IOK 2018-12-04
605 public function product_supports_express_checkout($product) {
606 // IOK 2023-12-12 Can only support express checkout for Vipps - not MobilePay (yet!)
607 // IOK 2025-09-01 Now supports mobilepay
608 return apply_filters('woo_vipps_product_supports_express_checkout', $this->product_supports_checkout($product), $product);
609 }
610
611 // Checkout and Express Checkout are very similarily restricted because they both replace the standard
612 // Woo Checkout page, but express checkout is even more restricted, so we need to separate out the commonalities. IOK 2024-01-11
613 public function product_supports_checkout($product) {
614 $type = $product->get_type();
615 $ok = in_array($type, $this->express_checkout_supported_product_types);
616 $ok = apply_filters('woo_vipps_product_supports_checkout',$ok,$product);
617 return $ok;
618 }
619
620 // Almost the same as express checkout - unfortunately not *entirely* the same. IOK 2024-01-11
621 public function cart_supports_checkout($cart=null) {
622 if (!$cart) $cart = WC()->cart;
623 if (!$cart) return false;
624 # Not supported by Vipps MobilePay
625 if ($cart->cart_contents_total <= 0) return false;
626
627 $supports = true;
628 foreach($cart->get_cart() as $key=>$val) {
629 $prod = $val['data'];
630 if (!is_a($prod, 'WC_Product')) continue;
631 $product_supported = $this->product_supports_checkout($prod);
632 if (!$product_supported) {
633 $supports = false;
634 break;
635 }
636 }
637 $supports = apply_filters('woo_vipps_cart_supports_checkout', $supports, $cart);
638 return $supports;
639 }
640
641 // Check to see if the cart passed (or the global one) can be bought with express checkout IOK 2018-12-04
642 public function cart_supports_express_checkout($cart=null) {
643 if (!$cart) $cart = WC()->cart;
644 $supports = true;
645 if (!$cart) return $supports;
646 # Not supported by Vipps MobilePay
647 if ($cart->cart_contents_total <= 0) return false;
648
649 foreach($cart->get_cart() as $key=>$val) {
650 $prod = $val['data'];
651 if (!is_a($prod, 'WC_Product')) continue;
652 $product_supported = $this->product_supports_express_checkout($prod);
653 if (!$product_supported) {
654 $supports = false;
655 break;
656 }
657 }
658 $supports = apply_filters('woo_vipps_cart_supports_express_checkout', $supports, $cart);
659 return $supports;
660 }
661
662 // True if "Express checkout" should be displayed IOK 2018-06-18
663 public function show_express_checkout() {
664 if (!$this->express_checkout_available()) return false;
665 $show = ($this->enabled == 'yes') && ($this->get_option('cartexpress') == 'yes') ;
666 $show = $show && $this->cart_supports_express_checkout();
667
668 // Earlier, we disabled this if Checkout was active; but we will now respect the setting in all
669 // cases. Also, there is a filter. IOK 2026-02-19
670
671 return apply_filters('woo_vipps_show_express_checkout', $show);
672 }
673
674 public function show_login_with_vipps() {
675 return false;
676 }
677
678 // Called when orders reach the 'refunded' status. We'll add a complete refund and note that any rest is to be cancelled.
679 public function maybe_refund_order($order_id) {
680 $order = wc_get_order($order_id);
681 if (! Vipps::is_vipps_order($order)) return false;
682 try {
683 $order = $this->update_vipps_payment_details($order);
684 } catch (Exception $e) {
685 //Do nothing with this for now
686 $this->log(__("Error getting payment details before doing refund: ", 'woo-vipps') . $e->getMessage(), 'warning');
687 }
688 $payment = $this->check_payment_status($order);
689 if ($payment == 'initiated' || $payment == 'cancelled') {
690 return true; // Can't refund these
691 }
692
693 // This will create + process a refund for the captured amount (if any). IOK 2026-01-26
694 // We always run this since woo will create a manual refund on this status change: we want the refund to be through our gw instead. LP 2026-06-10
695 $this->wc_order_fully_refunded ($order_id);
696
697 // In any case, note that this order is ready for cancellation - we don't actually do this here anymore
698 $order->update_meta_data('_vipps_capture_complete',true);
699 $order->save();
700 }
701
702 // Called when orders reach the 'cancelled'-status. When this happens, orders will be *refunded*
703 // when they have been captured, but for added safety, this is only done when the orders are relatively new.
704 public function maybe_cancel_order($order_id) {
705 $order = wc_get_order($order_id);
706 if (! Vipps::is_vipps_order($order)) return false;
707
708 try {
709 $order = $this->update_vipps_payment_details($order);
710 } catch (Exception $e) {
711 //Do nothing with this for now
712 $this->log(__("Error getting payment details before doing cancel: ", 'woo-vipps') . $e->getMessage(), 'warning');
713 }
714
715 $payment = $this->check_payment_status($order);
716 if ($payment == 'initiated' || $payment == 'cancelled') {
717 return true; // Can't cancel these
718 }
719
720 $days_threshold = apply_filters('woo_vipps_cancel_refund_days_threshold', 30);
721 $order_date = $order->get_date_created();
722 $days_since_order = (time() - $order_date->getTimestamp()) / (60 * 60 * 24);
723
724 $captured = intval($order->get_meta('_vipps_captured'));
725 $vippsstatus = $order->get_meta('_vipps_status');
726
727 // If we have captured some funds, we must first create a refund for the amount we've captured.
728 // However, we will only do this if the order is relatively fresh, to avoid accidentally refunding
729 // old orders.
730 if ($captured > 0 || $vippsstatus == 'SALE') {
731 // If this is true then the order is *too old to refund* which would happen on maybe_cancel_payment.
732 // add a note instead.
733 if ($days_since_order > $days_threshold) {
734 $note = sprintf(__('Order with captured funds older than %d days cancelled - because the order is this old, it will not be automatically refunded at Vipps. Manual refund may be required.', 'woo-vipps'), $days_threshold);
735 $order->add_order_note($note);
736 // Add an admin notice in case this is interactive
737 $msg = sprintf(__("Could not cancel %1\$s payment", 'woo-vipps'), $this->get_payment_method_name());
738 $this->adminerr(__('Order', 'woo-vipps') . " " . $order->get_id() . ": " . $note);
739 $order->save();
740 Vipps::instance()->store_admin_notices();
741 return false;
742 }
743 // This will create + process a refund for the captured amount. IOK 2026-01-26
744 $this->wc_order_fully_refunded ($order_id);
745 }
746 // In any case, note that this order is ready for cancellation - we don't actually do this here anymore
747 $order->update_meta_data('_vipps_capture_complete',true);
748 $order->save();
749 }
750
751 // IOK 2024-09-01 In general, we can refund most Vipps Mobilepay orders through the api,
752 // however, this is not the case for the Bank Transfer method available through Vipps Checkout.
753 public function can_refund_order( $order ) {
754 $method = $order->get_meta('_vipps_api');
755 switch ($method) {
756 case 'banktransfer':
757 return false;
758 break;
759 case 'epayment':
760 return true;
761 break;
762 // Default is old-style ecom v2.
763 default:
764 return true;
765 break;
766 }
767 }
768
769 // This is ran in woocommerce_order_status_refunded *before* woos own wc_order_fully_refunded (priority 9)
770 // so that we can create a through-the-gateway refund for this if neccessary. That way, *our* logic for refunds occur
771 // instead of the normal woo logic. IOK 2026-04-16
772 public function wc_order_fully_refunded ($orderid) {
773 $order = wc_get_order($orderid);
774 if (! Vipps::is_vipps_order($order)) return false;
775
776 // First check to see if we actually need to refund anything now IOK 2026-02-16
777 $max_refund = wc_format_decimal( $order->get_total() - $order->get_total_refunded() );
778 if ( ! $max_refund ) {
779 return;
780 }
781
782 // IOK 2019-10-03 it is now possible to do capture via other tools than Woo, so we must now first check to see if
783 // the order is capturable by getting full payment details.
784 try {
785 $order = $this->update_vipps_payment_details($order);
786 } catch (Exception $e) {
787 //Do nothing with this for now
788 $this->log(__("Error getting payment details before doing refund: ", 'woo-vipps') . $e->getMessage(), 'warning');
789 }
790
791 $data = [];
792 $data['amount'] = $max_refund;
793 $data['reason'] = __( 'Order fully refunded.', 'woocommerce' );
794 $data['order_id'] = $orderid;
795 $data['refund_payment'] = true; // This should call our "process_refund" instead of adding a manual refund
796
797 // IOK 2026-04-17 Should be all remaining un-refunded line items
798 $line_items = apply_filters('woo_vipps_order_fully_refunded_line_items', $this->get_remaining_refundable_line_items($order), $order);
799 $data['line_items'] = $line_items;
800
801 wc_switch_to_site_locale();
802 $the_refund = wc_create_refund($data);
803 wc_restore_locale();
804 if (is_wp_error($the_refund)) {
805 $refund_thru_gateway = false;
806 $msg = $the_refund->get_error_message();
807 $order->add_order_note(sprintf(__("Error when refunding payment through %1\$s:", 'woo-vipps'), $this->get_payment_method_name()) . ' ' . $msg);
808 $order->save();
809 $this->adminerr($msg);
810 }
811 return true;
812 }
813
814
815 // IOK 2026-04-16 Build wc_create_refund() line_items for all remaining refundable order items - used to provide line-item info for the refund to be processed when
816 // "fully refunded" is done.
817 // [ $item_id => ['qty' => 1, 'refund_total' => '100.00', 'refund_tax' => [ 1 => '25.00' ], * ], ... ]
818 // Includes line items, fees and shipping. For fees/shipping, qty is set to 0.
819 private function get_remaining_refundable_line_items( WC_Order $order ) {
820 $items = $order->get_items( array( 'line_item', 'fee', 'shipping' ));
821
822 $new_refund_line_items = [];
823 foreach($items as $item_id => $item) {
824 $new_refund_line = [];
825
826 // Calculate remaining tax for this line item; by tax id. The shape is [ [total] => [tax_id => value_for_this_tax_id] ].
827 // We want the tax id and the value.
828 $tax_data = wc_tax_enabled() ? $item->get_taxes() : false;
829 $remaining_tax = [];
830 if ($tax_data) {
831 foreach($tax_data['total'] as $tax_id => $value) {
832 if ('' === $value) continue; // don't add empty string as tax value, fatal crash. LP 2026-06-08
833 $remaining_tax[$tax_id] = $value;
834 }
835 }
836 // We can then subtract the tax already refunded for each of these items.
837 foreach($remaining_tax as $tax_id => $current) {
838 $refunded = $order->get_tax_refunded_for_item($item_id, $tax_id, $item->get_type());
839 $remaining = wc_format_decimal($current-$refunded);
840 if ($remaining > 0) {
841 $remaining_tax[$tax_id] = wc_format_decimal($current-$refunded);
842 } else {
843 unset($remaining_tax[$tax_id]);
844 }
845 }
846
847 // Then the quantity
848 $qty = (int) $item->get_quantity();
849 $refunded_quantity = abs((int) $order->get_qty_refunded_for_item($item_id, $item->get_type())); // Documented to be positive since 3.0, seems to be actually negative.
850 $remaining_quantity = $qty-$refunded_quantity;
851
852 $total = $item->get_total();
853 $refunded_total = $order->get_total_refunded_for_item($item_id, $item->get_type()); // A positive value
854 $remaining_total = wc_format_decimal($total-$refunded_total);
855
856
857 if ($remaining_quantity>0 || !empty($remaining_tax) || $remaining_total > 0) {
858 $new_refund_line['qty'] = max(0,$remaining_quantity);
859 $new_refund_line['refund_tax'] = $remaining_tax;
860 $new_refund_line['refund_total'] = $remaining_total;
861 $new_refund_line_items[$item_id] = $new_refund_line;
862 }
863
864 }
865
866 return $new_refund_line_items;
867
868 }
869
870
871 // This is for orders that are 'reserved' at Vipps but could actually be captured at once because
872 // they don't require payment. So we try to capture. IOK 2020-09-22
873 // do NOT call this unless the order is 'reserved' at Vipps!
874 protected function maybe_complete_payment($order) {
875 if (! Vipps::is_vipps_order($order)) return false;
876 if ($order->needs_processing()) return false; // No auto-capture for orders needing processing
877 // IOK 2018-10-03 when implementing partial capture, this must be modified.
878 $captured = intval($order->get_meta('_vipps_captured'));
879 $vippsstatus = $order->get_meta('_vipps_status');
880 if ($captured || $vippsstatus == 'SALE') {
881 return true;
882 }
883 $ok = 0;
884 try {
885 $ok = $this->capture_payment($order);
886 $order->add_order_note(sprintf(__('Payment automatically captured at %1$s for order not needing processing','woo_vipps'), $this->get_payment_method_name()));
887 } catch (Exception $e) {
888 $order->add_order_note(sprintf(__('Order does not need processing, but payment could not be captured at %1$s:','woo_vipps'), $this->get_payment_method_name()) . ' ' . $e->getMessage());
889 }
890 if (!$ok) return false;
891 $order->save();
892 return true;
893 }
894
895 // This filter runs on *all* refunds, including manual refunds. Its main job here is to
896 // disallow creating manual refunds on orders that have not been captured yet, since this makes the capture/cancel logic
897 // very confusing
898 public function woocommerce_create_refund ($refund, $args) {
899 $order_id = intval($args['order_id'] ?? 0);
900 $order = $order_id ? wc_get_order( $order_id ) : null;
901 if ( ! $order ) return;
902 if (! Vipps::is_vipps_order($order)) return;
903 // This is for manual refunds only IOK 2026-02-24
904 if (!($args['refund_payment'] ?? false)) {
905 try {
906 $order = $this->update_vipps_payment_details($order);
907 } catch (Exception $e) {
908 //Do nothing with this for now
909 $this->log(__("Error getting payment details before doing refund: ", 'woo-vipps') . $e->getMessage(), 'warning');
910 }
911 // This would be *per order line* in the fulfilment branch. IOK 2026-02-24 FIXME
912 $captured = intval($order->get_meta('_vipps_captured'));
913 if (!$captured) {
914 $msg = sprintf(__("Order %2\$d: It is not possible to create a manual refund for a %1\$s order before it has been captured - doing so makes it impossible to track how much to capture and how much to release. If you create the refund through %1\$s, a note will be made internally so that the amount to be refunded will *not* be captured - please do this instead if possible. Otherwise, capture the order then refund either manually or through %1\$s", 'woo-vipps'), $this->get_payment_method_name(), $order_id);
915 throw new Exception($msg);
916 }
917 }
918 }
919
920 // This is the Woocommerce refund api called by the "Refund" actions. IOK 2018-05-11
921 public function process_refund($orderid,$amount=null,$reason='') {
922 $order = wc_get_order($orderid);
923
924 $currency = $order->get_currency();
925
926 try {
927 $order = $this->update_vipps_payment_details($order);
928 } catch (Exception $e) {
929 //Do nothing with this for now
930 $this->log(__("Error getting payment details before doing refund: ", 'woo-vipps') . $e->getMessage(), 'warning');
931 }
932
933 $captured = intval($order->get_meta('_vipps_captured'));
934 $to_refund = intval($order->get_meta('_vipps_refund_remaining'));
935
936 // No funds captured, by epayment can do cancel of partial capture, so let's note that we are not to capture this.
937 if (!$captured) {
938 if ('epayment' != $order->get_meta('_vipps_api')) {
939 return new WP_Error('Vipps', sprintf(__("Cannot refund through %1\$s - the payment has not been captured yet.", 'woo-vipps'), $this->get_payment_method_name()));
940 }
941 if ($amount > $order->get_total()) {
942 return new WP_Error('Vipps', sprintf(__("Cannot refund through %1\$s - the refund amount is too large.", 'woo-vipps'), $this->get_payment_method_name()));
943 }
944 $msg = sprintf(__('The money for order %1$d has not been captured, only reserved. %2$s %3$s of the reserved funds will be released when the order is set to complete.', 'woo-vipps'), $orderid, $amount, $currency);
945 $this->log($msg, 'info');
946 $uncapturable = round($amount * 100) + intval($order->get_meta('_vipps_noncapturable'));
947
948 $order->update_meta_data('_vipps_noncapturable', $uncapturable);
949 $order->add_order_note($msg);
950 $order->save();
951 return true;
952 }
953
954 if ($amount*100 > $to_refund) {
955 return new WP_Error('Vipps', sprintf(__("Cannot refund through %1\$s - the refund amount is too large.", 'woo-vipps'), $this->get_payment_method_name()));
956 }
957 $ok = 0;
958
959 // Specialcase zero, because Vipps treats this as the entire amount IOK 2021-09-14
960 if (is_numeric($amount) && $amount == 0) {
961 $order->add_order_note($amount . ' ' . $currency . ' ' . sprintf(__(" refunded through %1\$s:",'woo-vipps'), Vipps::CompanyName()) . ' ' . $reason);
962 return true;
963 }
964
965 try {
966 $ok = $this->refund_payment($order,$amount);
967 } catch (TemporaryVippsApiException $e) {
968 $this->log(sprintf(__('Could not refund %1$s payment for order id:', 'woo-vipps'), $this->get_payment_method_name()) . ' ' . $orderid . "\n" .$e->getMessage(),'error');
969 return new WP_Error('Vipps',sprintf(__('%1$s is temporarily unavailable.','woo-vipps'), Vipps::CompanyName()) . ' ' . $e->getMessage());
970 } catch (Exception $e) {
971 $msg = sprintf(__('Could not refund %1$s payment','woo-vipps'), Vipps::CompanyName()) . ' ' . $e->getMessage();
972 $order->add_order_note($msg);
973 $this->log($msg,'error');
974 return new WP_Error('Vipps',$msg);
975 }
976
977 if ($ok) {
978 $order->add_order_note($amount . ' ' . $currency . ' ' . sprintf(__(" refunded through %1\$s:",'woo-vipps'), Vipps::CompanyName()) . ' ' . $reason);
979 }
980 return $ok;
981 }
982
983 // Detect default payment method based on country code NT-2024-10-15
984 public function detect_default_payment_method_from_country($country_code) {
985 // Default to MobilePay
986 $payment_method_name = 'MobilePay';
987 // Default to Vipps if country is Norway or Sweden
988 if($country_code == 'NO' || $country_code == 'SE') {
989 $payment_method_name = 'Vipps';
990 }
991 return $payment_method_name;
992 }
993
994 // Returns true iff this is a store where Vipps will allow external payment methods.
995 // Currently this is only Finland, and only Klarna is supported. We need to call this like so because
996 // most of woocommerce will not be initialized when we need this info. IOK 2024-05-28
997 public function allow_external_payments_in_checkout() {
998 $store_location= wc_get_base_location();
999 $store_country = $store_location['country'] ?? '';
1000 $finland = (get_woocommerce_currency() == "EUR" && $store_country == "FI");
1001 $norway = (get_woocommerce_currency() == "NOK" && $store_country == "NO");
1002 $sweden = (get_woocommerce_currency() == "SEK" && $store_country == "SE");
1003 return apply_filters('woo_vipps_allow_external_payment_methods', ($finland || $norway || $sweden));
1004 }
1005
1006 public function init_form_fields() {
1007 global $Vipps;
1008
1009 // Used for defaults in the admin interface; however this functions is called a loot more often than that.
1010 $page_templates = $this->get_theme_page_templates();
1011 $page_list = $this->get_pagelist();
1012
1013 $orderprefix = $Vipps->generate_order_prefix();
1014
1015 // Default handling based on other parameters and earlier values.
1016 $expresscreateuserdefault = "no";
1017 $vippscreateuserdefault = "no";
1018
1019 // Express checkout uses verified email addresses,so we'll create users if the Login plugin is installed and WooCommerce is set to allow user registration.
1020 if (class_exists('VippsWooLogin')) {
1021 $woodefault = 'yes' === get_option('woocommerce_enable_signup_and_login_from_checkout');
1022 if ($woodefault) {
1023 $expresscreateuserdefault = "yes";
1024 // $vippscreateuserdefault = "yes"; // However, for Vipps Checkout the email address is freetext so we'll treat the default a bit different.
1025 }
1026 }
1027
1028 // We will only show the Vipps Checkout options if the user has activated the feature (thus creating the pages involved etc). IOK 2021-10-01
1029 $vipps_checkout_activated = get_option('woo_vipps_checkout_activated', false);
1030
1031
1032 // This is used for new options,to set reasonable defaults based on older settings. We can't use WC_Settings->get_option for this unfortunately.
1033 $current = get_option('woocommerce_vipps_settings');
1034 // New defaults based on old defaults
1035 $default_static_shipping_for_checkout = 'no';
1036 $default_ask_address_for_express = 'no';
1037 $default_status_on_fail = 'failed';
1038 if ($current) {
1039 $default_static_shipping_for_checkout = (isset($current['enablestaticshipping'])) ? $current['enablestaticshipping'] : 'no';
1040 $default_ask_address_for_express = (isset($current['useExplicitCheckoutFlow']) && $current['useExplicitCheckoutFlow'] == "yes") ? "yes" : "no";
1041 // The old default used the same value as for Express Checkout. IOK 2023-07-27
1042 $vippscreateuserdefault = isset($current['expresscreateuser']) ? $current['expresscreateuser'] : $vippscreateuserdefault;
1043
1044 // For existing installs: set failed payments order status to cancelled to keep same default behaviour.
1045 // New installs will be set to failed instead of cancelled. LP 2026-03-26
1046 $default_status_on_fail = 'cancelled';
1047 }
1048
1049 // Get the already-set country code. For existing sites, this will guess the country based on the currency; for new sites, use
1050 // the woo base country. IOK 2024-10-17 (previously used the currency here too).
1051 $countries = new WC_Countries(); // Can't use WC()->countries here - too early IOK 2024-10-17
1052 $country_code = $current['country'] ?? $countries->get_base_country();
1053
1054 // Same issue as above: We need the default payment method name before it is set to be able to provide defaults IOK 2023-12-01
1055 $payment_method_name = $current['payment_method_name'] ?? $this->detect_default_payment_method_from_country($country_code);
1056
1057 $checkoutfields = array(
1058 'checkout_options' => array(
1059 'title' => "Checkout", // Vipps::CheckoutName(), // Don't translate this, but save some space IOK 2024-12-06
1060 'type' => 'title',
1061 'class' => 'tab',
1062 'description' => sprintf(__("%1\$s is a new service from %2\$s which replaces the usual WooCommerce checkout page entirely, replacing it with a simplified checkout screen providing payment both with %2\$s and credit card. Additionally, your customers will get the option of providing their address information using their %2\$s app directly.", 'woo-vipps'), Vipps::CheckoutName(), Vipps::CompanyName()),
1063 ),
1064
1065
1066 'vipps_checkout_enabled' => array(
1067 'title' => sprintf(__('Activate Alternative %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1068 'label' => sprintf(__('Enable Alternative %1$s screen, replacing the standard checkout page', 'woo-vipps'), Vipps::CheckoutName()),
1069 'type' => 'checkbox',
1070 'description' => sprintf(__('If activated, this will <strong>replace</strong> the standard Woo checkout screen with %1$s, providing easy checkout using %1$s or credit card, with no need to type in addresses.', 'woo-vipps'), Vipps::CheckoutName()),
1071 'default' => 'no',
1072 ),
1073
1074 'checkoutcreateuser' => array (
1075 'title' => sprintf(__('Create new customers on %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1076 'label' => sprintf(__('Create new customers on %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1077 'type' => 'checkbox',
1078 'description' => sprintf(__('Enable this to create and login customers when using %1$s. Otherwise these will all be guest checkouts. If using, you may want to install Login with Vipps too.', 'woo-vipps'), Vipps::CheckoutName()),
1079 'default' => $vippscreateuserdefault,
1080 ),
1081
1082 'enablestaticshipping_checkout' => array(
1083 'title' => sprintf(__('Enable static shipping for %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1084 'label' => __('Enable static shipping', 'woo-vipps'),
1085 'type' => 'checkbox',
1086 'description' => sprintf(__('If your shipping options do not depend on the customers address, you can enable \'Static shipping\', which will precompute the shipping options when using %1$s so that this will be much faster. If you do this and the customer isn\'t logged in, the base location of the store will be used to compute the shipping options for the order. You should only use this if your shipping is actually \'static\', that is, does not vary based on the customers address. So fixed price/free shipping will work. If the customer is logged in, their address as registered in the store will be used, so if your customers are always logged in, you may be able to use this too.', 'woo-vipps'), Vipps::CheckoutName()),
1087 'default' => $default_static_shipping_for_checkout
1088 ),
1089
1090
1091 'requireUserInfo_checkout' => array(
1092 'title' => __('Ask the user to consent to share user information', 'woo-vipps'),
1093 'label' => __('Ask the user to consent to share user information', 'woo-vipps'),
1094 'type' => 'checkbox',
1095 'description' => sprintf(__('If using %1$s, ask for the users consent to share user information with the store. This will allow better integration between Login With %1$s but will add another step to first-time buyers.', 'woo-vipps'), Vipps::CompanyName()),
1096 'default' => 'no'
1097 ),
1098
1099 'noAddressFields' => array(
1100 'title' => __('Drop the address fields on the Checkout screen', 'woo-vipps'),
1101 'label' => __('Don\'t require the address fields', 'woo-vipps'),
1102 'type' => 'checkbox',
1103 'description' => __('If your products <i>don\'t require shipping</i>, either because they are digital downloads, immaterial products or delivering the products directly on purchase, you can check this box. The user will then not be required to provide an address, which should speed things up a bit. If your products require shipping, this will have no effect. NB: If you have plugins that require shipping information, then this is not going to work very well.','woo-vipps'),
1104 'default' => 'no'
1105 ),
1106
1107 'noContactFields' => array(
1108 'title' => __('Drop the contact fields on the Checkout screen', 'woo-vipps'),
1109 'label' => __('Don\'t require the contact fields', 'woo-vipps'),
1110 'type' => 'checkbox',
1111 'description' => __('If your products <i>don\'t require shipping</i> as above, and you also don\'t care about the customers name or contact information, you can drop this too! The customer fields will then be filled with a placeholder. NB: If you have plugins that require contact information, then this is not going to work very well. Also, for this to work you have to check the \'no addresses\' box as well.','woo-vipps'),
1112 'default' => 'no'
1113 ),
1114
1115
1116 );
1117
1118 $vipps_checkout_shipping_fields = array(
1119
1120 'checkout_shipping' => array(
1121 'title' => sprintf(__('%1$s Shipping Methods', 'woo-vipps'), Vipps::CheckoutName()),
1122 'type' => 'title',
1123 'description' => sprintf(__("When using %1\$s, you have the option to use %1\$s specific shipping methods with extended features for certain carriers. These will add an apropriate logo as well as extended delivery options for certain methods. For some of these, you need to add integration data from the carriers below. You can then add these shipping methods to your shipping zones the normal way, but they will only appear in the %1\$s screen.", 'woo-vipps'), Vipps::CheckoutName())
1124 ),
1125
1126 'vcs_posten' => array(
1127 'title' => __('Posten Norge', 'woo-vipps'),
1128 'class' => 'vcs_posten vcs_main',
1129 'custom_attributes' => array('data-vcs-show'=>'.vcs_depend.vcs_posten'),
1130 'label' => sprintf(__('Support Posten Norge as a shipping method in %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1131 'type' => 'checkbox',
1132 'description' => sprintf(__('Activate this for Posten Norge as a %1$s Shipping method.', 'woo-vipps'), Vipps::CheckoutName()),
1133 'default' => 'yes'
1134 ),
1135
1136 'vcs_posti' => array(
1137 'title' => __('Posti', 'woo-vipps'),
1138 'class' => 'vcs_posti vcs_main',
1139 'custom_attributes' => array('data-vcs-show'=>'.vcs_depend.vcs_posti'),
1140 'label' => sprintf(__('Support Posti as a shipping method in %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1141 'type' => 'checkbox',
1142 'description' => sprintf(__('Activate this for Posti as a %1$s Shipping method.', 'woo-vipps'), Vipps::CheckoutName()),
1143 'default' => 'yes'
1144 ),
1145
1146 'vcs_postnord' => array(
1147 'title' => __('PostNord', 'woo-vipps'),
1148 'class' => 'vcs_postnord vcs_main',
1149 'custom_attributes' => array('data-vcs-show'=>'.vcs_depend.vcs_postnord'),
1150 'label' => sprintf(__('Support PostenNord as a shipping method in %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1151 'type' => 'checkbox',
1152 'description' => sprintf(__('Activate this for PostNord as a %1$s Shipping method.', 'woo-vipps'), Vipps::CheckoutName()),
1153 'default' => 'yes'
1154 ),
1155
1156 'vcs_porterbuddy' => array(
1157 'title' => __('Porterbuddy', 'woo-vipps'),
1158 'class' => 'vcs_porterbuddy vcs_main',
1159 'custom_attributes' => array('data-vcs-show'=>'.vcs_depend.vcs_porterbuddy'),
1160 'label' => sprintf(__('Support Porterbuddy as a shipping method in %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1161 'type' => 'checkbox',
1162 'description' => sprintf(__('Activate this for Porterbuddy as a %1$s Shipping method. Your store address will be used as the pick-up point and your admin email will be used for booking information from Porterbuddy.' ,'woo-vipps'), Vipps::CheckoutName()),
1163 'default' => 'no'
1164 ),
1165
1166 'vcs_porterbuddy_publicToken' => array(
1167 'title' => __('Porterbuddy public token', 'woo-vipps'),
1168 'class' => 'vippspw vcs_porterbuddy vcs_depend',
1169 'type' => 'password',
1170 'description' => __('The public key provided to you by Porterbuddy','woo-vipps'),
1171 'default' => '',
1172 ),
1173 'vcs_porterbuddy_apiKey' => array(
1174 'title' => __('Porterbuddy API key', 'woo-vipps'),
1175 'class' => 'vippspw vcs_porterbuddy vcs_depend',
1176 'type' => 'password',
1177 'description' => __('The API key provided to you by Porterbuddy','woo-vipps'),
1178 'default' => '',
1179 ),
1180 'vcs_porterbuddy_phoneNumber' => array(
1181 'title' => __('Porterbuddy Phone Number', 'woo-vipps'),
1182 'class' => 'vcs_porterbuddy vcs_depend',
1183 'type' => 'text',
1184 'description' => __('Your phone number where Porterbuddy may send you important messages. Format must be MSISDN (including country code). Example: "4791234567"','woo-vipps'),
1185 'default' => '',
1186 ),
1187
1188 // Vipps checkout *shipping options* - extra shipping options that only work with Vipps Checkout
1189 'vcs_helthjem' => array(
1190 'title' => __('Helthjem', 'woo-vipps'),
1191 'label' => sprintf(__('Support Helthjem as a shipping method in %1$s', 'woo-vipps'), Vipps::CheckoutName()),
1192 'type' => 'checkbox',
1193 'class' => 'vcs_helthjem vcs_main',
1194 'custom_attributes' => array('data-vcs-show'=>'.vcs_depend.vcs_helthjem'),
1195 'description' => sprintf(__('Activate this for Helthjem as a %1$s Shipping method.' ,'woo-vipps'), Vipps::CheckoutName()),
1196 'default' => 'no'
1197 ),
1198
1199 'vcs_helthjem_shopId' => array(
1200 'title' => __('Helthjem Shop Id', 'woo-vipps'),
1201 'class' => 'vcs_helthjem vcs_depend',
1202 'type' => 'number',
1203 'custom_attributes' => array('pattern'=>'[0-9]'),
1204 'description' => __('The ShopId provided to you by Helthjem','woo-vipps'),
1205 'default' => '',
1206 ),
1207
1208 'vcs_helthjem_username' => array(
1209 'title' => __('Helthjem Username', 'woo-vipps'),
1210 'class' => 'vcs_helthjem vcs_depend',
1211 'type' => 'text',
1212 'description' => __('The Username provided to you by Helthjem','woo-vipps'),
1213 'default' => '',
1214 ),
1215 'vcs_helthjem_password' => array(
1216 'title' => __('Helthjem Password', 'woo-vipps'),
1217 'class' => 'vippspw vcs_helthjem vcs_depend',
1218 'type' => 'password',
1219 'description' => __('Password provided to you by Helthjem','woo-vipps'),
1220 'default' => '',
1221 ),
1222
1223 );
1224
1225 /* Support for *certain* external payment methods in Vipps Checkout. IOK 2024-05-27 */
1226 $externals = [];
1227 $external_payment_fields = [];
1228 $allow_external_payments = $this->allow_external_payments_in_checkout();
1229 if ($allow_external_payments) {
1230 if (in_array('KCO_Gateway', Vipps::$installed_gateways) || in_array('WC_Gateway_Klarna_Payments', Vipps::$installed_gateways)) {
1231 $externals['checkout_external_payments_klarna'] = array(
1232 'title' => __('Klarna', 'woo-vipps'),
1233 'label' => __('Klarna', 'woo-vipps'),
1234 'type' => 'checkbox',
1235 'class' => 'external_payments klarna',
1236 'description' => sprintf(__("Allow Klarna as an external payment method in %1\$s",'woo-vipps'), Vipps::CheckoutName()),
1237 'default' => 'no',
1238 );
1239 }
1240 if (!empty($externals)) {
1241 $external_payment_fields = [
1242 'checkout_external_payment_title' => array(
1243 'title' => sprintf(__('External Payment Methods', 'woo-vipps'), Vipps::CheckoutName()),
1244 'type' => 'title',
1245 'description' => sprintf(__("Allow certain external payment methods in %1\$s, returning control to WooCommerce for the order", 'woo-vipps'), Vipps::CheckoutName())
1246 ),
1247 ];
1248 foreach($externals as $k => $def) $external_payment_fields[$k] = $def;
1249 }
1250 }
1251
1252 $vipps_checkout_widgets_fields = [
1253 'checkout_widgets' => [
1254 'title' => sprintf(__('%1$s widgets', 'woo-vipps'), Vipps::CheckoutName()),
1255 'type' => 'title',
1256 'description' => sprintf(__('Widgets are elements shown above the %1$s frame with extra functionality.', 'woo-vipps'), Vipps::CheckoutName()),
1257 ],
1258 'checkout_widget_ordernotes' => [
1259 'title' => __('Order notes', 'woo-vipps'),
1260 'label' => __('Enable the order notes widget', 'woo-vipps'),
1261 'type' => 'checkbox',
1262 'description' => __('A widget to add customer notes with their order.', 'woo-vipps'),
1263 'default' => 'yes'
1264 ],
1265 ];
1266 /* This seems to have broken some sites with OOM during plugin activation. 2025-05-27 */
1267 // if (wc_coupons_enabled()) {
1268 $vipps_checkout_widgets_fields['checkout_widget_coupon'] = [
1269 'title' => __('Coupon code', 'woo-vipps'),
1270 'label' => __('Enable the coupon code widget', 'woo-vipps'),
1271 'type' => 'checkbox',
1272 'description' => __('A widget to activate coupon codes.', 'woo-vipps'),
1273 'default' => 'yes'
1274 ];
1275 // }
1276
1277 $mainfields = array(
1278 'main_options' => array(
1279 'title' => __('Main options', 'woo-vipps'),
1280 'type' => 'title',
1281 'class' => 'tab',
1282 ),
1283 'enabled' => array(
1284 'title' => __('Enable/Disable', 'woocommerce'),
1285 'label' => sprintf(__('Enable %1$s', 'woo-vipps'), Vipps::CompanyName()),
1286 'type' => 'checkbox',
1287 'description' => '',
1288 'default' => 'no',
1289 ),
1290 'country' => array(
1291 'title' => __('Country', 'woo-vipps'),
1292 'label' => __('Country', 'woo-vipps'),
1293 'type' => 'select',
1294 'options' => array(
1295 'NO' => __('Norway', 'woo-vipps'),
1296 'SE' => __('Sweden', 'woo-vipps'),
1297 'FI' => __('Finland', 'woo-vipps'),
1298 'DK' => __('Denmark', 'woo-vipps'),
1299 ),
1300 'description' => __('Select the country for this merchant serial number. This will determine the appropriate payment method (Vipps or MobilePay).', 'woo-vipps'),
1301 'default' => $country_code,
1302 ),
1303
1304 'payment_method_name' => array(
1305 'title' => __('Payment method', 'woo-vipps'),
1306 'label' => __('Choose which payment method should be displayed to users at checkout', 'woo-vipps'),
1307 'type' => 'select',
1308 'options' => array(
1309 'Vipps' => __('Vipps','woo-vipps'),
1310 'MobilePay' => __('MobilePay', 'woo-vipps'),
1311 ),
1312 'description' => __('Choose which payment method should be displayed to users at checkout', 'woo-vipps'),
1313 'default' => $payment_method_name,
1314 ),
1315
1316 'orderprefix' => array(
1317 'title' => __('Order-id Prefix', 'woo-vipps'),
1318 'label' => __('Order-id Prefix', 'woo-vipps'),
1319 'type' => 'string',
1320 'description' => __('An alphanumeric textstring to use as a prefix on orders from your shop, to avoid duplicate order-ids','woo-vipps'),
1321 'default' => $orderprefix
1322 ),
1323 'merchantSerialNumber' => array(
1324 'title' => __('Merchant Serial Number', 'woo-vipps'),
1325 'label' => __('Merchant Serial Number', 'woo-vipps'),
1326 'type' => 'number',
1327 'description' => __('Your "Merchant Serial Number" from the Developer tab on https://portal.vippsmobilepay.com','woo-vipps'),
1328 'default' => '',
1329 ),
1330 'clientId' => array(
1331 'title' => __('Client Id', 'woo-vipps'),
1332 'class' => 'vippspw',
1333 'label' => __('Client Id', 'woo-vipps'),
1334 'type' => 'password',
1335 'description' => __('Find your account under the "Developer" tab on https://portal.vippsmobilepay.com/ and choose "Show keys". Copy the value of "client_id"','woo-vipps'),
1336 'default' => '',
1337 ),
1338 'secret' => array(
1339 'title' => __('Client Secret', 'woo-vipps'),
1340 'label' => __('Client Secret', 'woo-vipps'),
1341 'class' => 'vippspw',
1342 'type' => 'password',
1343 'description' => __('Find your account under the "Developer" tab on https://portal.vippsmobilepay.com/ and choose "show keys". Copy the value of "client_secret"','woo-vipps'),
1344 'default' => '',
1345 ),
1346 'Ocp_Apim_Key_eCommerce' => array(
1347 'title' => __('Subscription Key', 'woo-vipps'),
1348 'label' => __('Subscription Key', 'woo-vipps'),
1349 'class' => 'vippspw',
1350 'type' => 'password',
1351 'description' => __('Find your account under the "Developer" tab on https://portal.vippsmobilepay.com/ and choose "show keys". Copy the value of "Vipps-Subscription-Key"','woo-vipps'),
1352 'default' => '',
1353 ),
1354
1355 'result_status' => array(
1356 'title' => sprintf(__('Order status on return from %1$s', 'woo-vipps'), Vipps::CompanyName()),
1357 'label' => __('Choose default order status for reserved (not captured) orders', 'woo-vipps'),
1358 'type' => 'select',
1359 'options' => array(
1360 'processing' => __('Processing', 'woo-vipps'),
1361 'on-hold' => __('On hold','woo-vipps'),
1362 ),
1363 'description' => __('By default, orders that are <b>reserved</b> but not <b>yet captured</b> will now have the order status \'Processing\'. You can capture the sum manually, or by changing the status to \'Complete\'. You should ensure that your workflow is such that the order is not shipped until after this capture.<br><br> The status \'On hold\' can be chosen instead for stores using a workflow where orders are shipped when the status is \'Processing\'. In this case, \'On hold\' will mean "order is reserved but not yet captured". This is a slightly safer solution, and ensures that the order status will reflect the payment status. <br><br>However, in many stores \'On hold\' has the additional meaning "there is a problem with the order"; and an email is often sent to the customer about this problem. The default is \'Processing\' because of this, and because many plugins and integrations expect orders to be \'Processing\' when the customer has completed payment.', 'woo-vipps'),
1364 'default' => 'processing',
1365 ),
1366
1367 'status_on_fail' => array(
1368 'title' => sprintf(__('Order status on failed payment (for restartable orders)', 'woo-vipps'), Vipps::CompanyName()),
1369 'label' => __('Choose default order status for failed payments', 'woo-vipps'),
1370 'type' => 'select',
1371 'options' => array(
1372 /* translators: woocommerce status name */
1373 'failed' => __('Failed', 'woo-vipps'),
1374 /* translators: woocommerce status name */
1375 'cancelled' => __('Cancelled','woo-vipps'),
1376 ),
1377 /* translators: company name. cancelled and failed are woocommerce status names! */
1378 'description' => sprintf(__('By default, orders where payment is started but not completed at %1$s will be set to failed if they can be restarted. This setting changes this behaviour, but does <strong>not</strong> affect orders that cannot be restarted as these will always be set to cancelled.<br><br>Cancelled orders will keep the customer\'s shopping cart intact.<br>Failed orders can be restarted, possibly with another payment method.', 'woo-vipps'), Vipps::CompanyName()),
1379 'default' => $default_status_on_fail,
1380 ),
1381
1382 /*
1383 'title' => array(
1384 'title' => __('Title', 'woocommerce'),
1385 'type' => 'text',
1386 'description' => __('This controls the title which the user sees during checkout.', 'woocommerce'),
1387 'default' => sprintf(__('%1$s','woo-vipps'), $payment_method_name),
1388 ),
1389 */
1390
1391 'description' => array(
1392 'title' => __('Description', 'woocommerce'),
1393 'type' => 'textarea',
1394 'description' => __('This controls the description which the user sees during checkout.', 'woocommerce'),
1395 'default' => __("Pay safely and easily. No fees, no matter the amount.", 'woo-vipps'),
1396 ),
1397
1398 'vippsdefault' => array(
1399 'title' => sprintf(__('Use %1$s as default payment method on checkout page', 'woo-vipps'), $payment_method_name),
1400 'label' => sprintf(__('%1$s is default payment method', 'woo-vipps'), $payment_method_name),
1401 'type' => 'checkbox',
1402 'description' => sprintf(__('Enable this to use %1$s as the default payment method on the checkout page, regardless of order.', 'woo-vipps'), $payment_method_name),
1403 'default' => 'yes',
1404 ),
1405
1406 'checkout_phone_transformation' => array(
1407 'title' => sprintf(__('Phone number transformation for %1$s and Express Checkout', 'woo-vipps'), 'Checkout'),
1408 'label' => sprintf(__('Choose a transformation to apply to phone numbers for %1$s and Express Checkout', 'woo-vipps'), 'Checkout'),
1409 'type' => 'select',
1410 'options' => array(
1411 'none' => __('None', 'woo-vipps'),
1412 'ensure_plus' => __('Prepend \'+\'','woo-vipps'),
1413 'strip_country_code' => __('Strip country code','woo-vipps'),
1414 ),
1415 'description' => __('Phone numbers from Express or Checkout are in the format 47xxxxxx without plus-sign in front. If you prefer, or if it is neccessary for your integrations, you can transform these numbers either by adding the plus sign or by stripping the country-code (45, 46, 47, 358).<br>NB: stripping country codes is at the moment only supported for Norwegian, Danish, Finnish and Swedish numbers.<br>Remember to explicitly test your use case before committing to any transformation on your live store.', 'woo-vipps'),
1416 'default' => 'none',
1417 ),
1418 );
1419
1420 $expressfields = array(
1421 'express_options' => array(
1422 'title' => sprintf(__('Express Checkout', 'woo-vipps')),
1423 'type' => 'title',
1424 'class' => 'tab',
1425 'description' => sprintf(__("%1\$s allows you to buy products by a single click from the cart page or directly from product or catalog pages. Product will get a 'buy now' button which will start the purchase process immediately.", 'woo-vipps'), Vipps::ExpressCheckoutName())
1426 ),
1427
1428 'cartexpress' => array(
1429 'title' => __('Enable Express Checkout in cart', 'woo-vipps'),
1430 'label' => __('Enable Express Checkout in cart', 'woo-vipps'),
1431 'type' => 'checkbox',
1432 'description' => sprintf(__('Enable this to allow customers to shop using %1$s directly from the cart with no login or address input needed', 'woo-vipps'), Vipps::ExpressCheckoutName()) . '.<br>' .
1433 sprintf(__('Please note that for Express Checkout, shipping must be calculated in a callback from the %1$s app, without any knowledge of the customer. This means that Express Checkout may not be compatible with all Shipping plugins or setup. You should test that your setup works if you intend to provide this feature.', 'woo-vipps'), Vipps::CompanyName()),
1434 'default' => 'yes',
1435 ),
1436
1437 'singleproductexpress' => array(
1438 'title' => __('Enable Express Checkout for single products', 'woo-vipps'),
1439 'label' => __('Enable Express Checkout for single products', 'woo-vipps'),
1440 'type' => 'select',
1441 'options' => array(
1442 'none' => __('No products','woo-vipps'),
1443 'some' => __('Some products', 'woo-vipps'),
1444 'all' => __('All products','woo-vipps')
1445 ),
1446 'description' => sprintf(__('Enable this to allow customers to buy a product using %1$s directly from the product page. If you choose \'some\', you must enable this on the relevant products', 'woo-vipps'), Vipps::ExpressCheckoutName()),
1447 'default' => 'none',
1448 ),
1449 'singleproductexpressarchives' => array(
1450 'title' => __('Add \'Buy now\' button on catalog pages too', 'woo-vipps'),
1451 'label' => __('Add the button for all relevant products on catalog pages', 'woo-vipps'),
1452 'type' => 'checkbox',
1453 'description' => sprintf(__('If %1$s is enabled for a product, add the \'Buy now\' button to catalog pages too', 'woo-vipps'), Vipps::ExpressCheckoutName()),
1454 'default' => 'no',
1455 ),
1456 'expresscheckout_termscheckbox' => array(
1457 'title' => sprintf(__('Add terms and conditions checkbox on %1$s', 'woo-vipps'), Vipps::ExpressCheckoutName()),
1458 'label' => sprintf(__('Always ask for confirmation on %1$s', 'woo-vipps'), Vipps::ExpressCheckoutName()),
1459 'type' => 'checkbox',
1460 'description' => sprintf(__('When using %1$s, ask the user to confirm that they have read and accepted the stores terms and conditons before proceeding', 'woo-vipps'), Vipps::ExpressCheckoutName()),
1461 'default' => 'no',
1462 ),
1463
1464 'expresscheckout_always_address' => array(
1465 'title' => __('Always ask for address, even if products don\'t need shipping', 'woo-vipps'),
1466 'label' => __('Always ask the user for their address, even if you don\'t need it for shipping', 'woo-vipps'),
1467 'type' => 'checkbox',
1468 'description' => __('If the order contains only "virtual" products that do not need shipping, we do not normally ask the user for their address - but check this box to do so anyway.', 'woo-vipps'),
1469 'default' => $default_ask_address_for_express,
1470 ),
1471
1472 'enablestaticshipping' => array(
1473 'title' => __('Enable static shipping for Express Checkout', 'woo-vipps'),
1474 'label' => __('Enable static shipping', 'woo-vipps'),
1475 'type' => 'checkbox',
1476 'description' => __('If your shipping options do not depend on the customers address, you can enable \'Static shipping\', which will precompute the shipping options when using Express Checkout so that this will be much faster. If you do this and the customer isn\'t logged in, the base location of the store will be used to compute the shipping options for the order. You should only use this if your shipping is actually \'static\', that is, does not vary based on the customers address. So fixed price/free shipping will work. If the customer is logged in, their address as registered in the store will be used, so if your customers are always logged in, you may be able to use this too.', 'woo-vipps'),
1477 'default' => 'no',
1478 ),
1479
1480
1481 'expresscreateuser' => array (
1482 'title' => __('Create new customers on Express Checkout', 'woo-vipps'),
1483 'label' => __('Create new customers on Express Checkout', 'woo-vipps'),
1484 'type' => 'checkbox',
1485 'description' => sprintf(__('Enable this to create and login new customers when using express checkout. Otherwise these will all be guest checkouts. If you have "Login with Vipps" installed, this will be the default (unless you have turned off user creation in WooCommerce itself)', 'woo-vipps'), Vipps::CompanyName()),
1486 'default' => $expresscreateuserdefault,
1487 ),
1488 'singleproductbuynowcompatmode' => array(
1489 'title' => __('"Buy now" compatibility mode', 'woo-vipps'),
1490 'label' => __('Activate compatibility mode for all "Buy now" buttons', 'woo-vipps'),
1491 'type' => 'checkbox',
1492 'description' => __('Choosing this will use a different method of handling the "Buy now" button on a single product, which will work for more product types and more plugins - while being <i>slightly</i> less smooth. Use this if your product needs more configuration than simple or standard variable products', 'woo-vipps'),
1493 'default' => 'no',
1494 ),
1495
1496
1497 'deletefailedexpressorders' => array(
1498 'title' => __('Delete failed Express Checkout Orders', 'woo-vipps'),
1499 'label' => __('Delete failed Express Checkout Orders', 'woo-vipps'),
1500 'type' => 'checkbox',
1501 'description' => __('As Express Checkout orders are anonymous, failed orders will end up as "cancelled" orders with no information in them. Enable this to delete these automatically when cancelled - but test to make sure no other plugin needs them for anything.', 'woo-vipps'),
1502 'default' => 'no',
1503 )
1504 );
1505 // New shipping in express checkout is available, but merchant has overridden the old shipping callback. Ask what to do! IOK 2020-02-12
1506 if (has_action('woo_vipps_shipping_methods')) {
1507 $shippingoptions = array(
1508 'newshippingcallback' => array(
1509 'title' => __('Use old-style shipping callback for express checkout', 'woo-vipps'),
1510 'label' => __('Use your current shipping filters', 'woo-vipps'),
1511 'type' => 'select',
1512 'options' => array(
1513 'none' => __('Select one','woo-vipps'),
1514 'old' => __('Keep using old shipping callback with my custom filter', 'woo-vipps'),
1515 'new' => __('Use new shipping callback','woo-vipps')
1516 ),
1517 'description' => sprintf(__('Since version 1.4 this plugin uses a new method of providing shipping methods to %1$s when using Express Checkout. The new method supports metadata in the shipping options, which is neccessary for integration with Bring, Postnord etc. However, the new method is not compatible with the old <code>\'woo_vipps_shipping_methods\'</code> filter, which your site has overridden in a theme or plugin. If you want to, you can continue using this filter and the old method. If you want to disable your filters and use the new method, you can choose this here. ', 'woo-vipps'), Vipps::CompanyName()),
1518 'default' => 'none',
1519 )
1520 );
1521 $expressfields = array_merge(array_slice($expressfields ,0,1), $shippingoptions, array_slice($expressfields,1));
1522 }
1523
1524 $advancedfields = array(
1525 'advanced_options' => array(
1526 'title' => __('Advanced', 'woo-vipps'),
1527 'type' => 'title',
1528 'class' => 'tab',
1529 'description' => __("If you have issues with your theme, you might find a setting here that will help. Normally you do not need to change these.", 'woo-vipps')
1530 ),
1531
1532 'vippsorderattribution' => array(
1533 'title' => __( 'Support WooCommerces Order Attribution API for Checkout and Express Checkout', 'woo-vipps' ),
1534 'label' => __( 'Add support for Order Attribution', 'woo-vipps' ),
1535 'type' => 'checkbox',
1536 'default'=> 'no',
1537 'description' => __('Turn this on to add support for Woos Order Attribution API for Checkout and Express Checkout. Some stores have reported problems when using this API together with Vipps, so be sure to test this if you turn it on.', 'woo-vipps'),
1538 ),
1539
1540 'vippsspecialpagetemplate' => array(
1541 'title' => sprintf(__('Override page template used for the special %1$s pages', 'woo-vipps'), Vipps::CompanyName()),
1542 'label' => sprintf(__('Use specific template for %1$s', 'woo-vipps'), Vipps::CompanyName()),
1543 'type' => 'select',
1544 'options' => $page_templates,
1545 'description' => sprintf(__('Use this template from your theme or child-theme to display all the special %1$s pages. You will probably want a full-width template and it should call \'the_content()\' normally.', 'woo-vipps'), Vipps::CompanyName()),
1546 'default' => ''),
1547
1548 'vippsspecialpageid' => array(
1549 'title' => sprintf(__('Use a real page ID for the special %1$s pages - neccessary for some themes', 'woo-vipps'), Vipps::CompanyName()),
1550 'label' => __('Use a real page ID', 'woo-vipps'),
1551 'type' => 'select',
1552 'options' => $page_list,
1553 'description' => sprintf(__('Some very few themes do not work with the simulated pages used by this plugin, and needs a real page ID for this. Choose a blank page for this; the content will be replaced, but the template and other metadata will be present. You only need to use this if the plugin seems to break on the special %1$s pages.', 'woo-vipps'), Vipps::CompanyName()),
1554 'default'=>''),
1555
1556 'sendreceipts' => array(
1557 'title' => __("Send receipts and order confirmation info to the customers' app on completed purchases.", 'woo-vipps'),
1558 'label' => sprintf(__("Send receipts to the customers %1\$s app", 'woo-vipps'), Vipps::CompanyName()),
1559 'type' => 'checkbox',
1560 'description' => sprintf(__("If this is checked, a receipt will be sent to %1\$s which will be viewable in the users' app, specifying the order items, shipping et cetera", 'woo-vipps'), Vipps::CompanyName()),
1561 'default' => 'yes'
1562 ),
1563
1564 'receiptimage' => array (
1565 'title' => sprintf(__('Use this image for the order confirmation link uploaded to the customers\' %1$s app', 'woo-vipps'), Vipps::CompanyName()),
1566 'label' => sprintf(__('Profile image used in the %1$s App', 'woo-vipps'), Vipps::CompanyName()),
1567 'type' => 'woo_vipps_image',
1568 'description' => sprintf(__('If set, this image will be uploaded to %1$s and used to profile your store in the %1$s app for links to the order confirmation etc', 'woo-vipps'), Vipps::CompanyName()),
1569 'default' => 0,
1570 ),
1571
1572
1573 'use_flock' => array (
1574 'title' => __('Use flock() to lock orders for Express Checkout', 'woo-vipps'),
1575 'label' => __('Use flock() to lock orders for Express Checkout', 'woo-vipps'),
1576 'type' => 'checkbox',
1577 'description' => __('Use the flock() system call to ensure orders are only finalized once. You can use this for normal setups, but probably not on Windows with IIS, and possibly not on distributed filesystems like NFS. If you don\t know what it is, probably do not use it. If you get duplicated shipping lines on some express orders, you may try using this', 'woo-vipps'),
1578 'default' => 'no',
1579 ),
1580
1581 'delete_settings_on_deactivation' => array (
1582 'title' => __('Delete plugin settings on deactivation', 'woo-vipps'),
1583 'label' => __('Delete plugin settings on deactivation', 'woo-vipps'),
1584 'type' => 'checkbox',
1585 'description' => __('If set, all plugin settings will be deleted upon plugin deactivation. Warning: there is no recovery after deletion.', 'woo-vipps'),
1586 'default' => 'no',
1587 ),
1588
1589 'developermode' => array ( // DEVELOPERS! DEVELOPERS! DEVELOPERS! DEVE
1590 'title' => __('Enable developer mode', 'woo-vipps'),
1591 'label' => __('Enable developer mode', 'woo-vipps'),
1592 'type' => 'checkbox',
1593 'description' => __('Enable this to enter developer mode. This gives you access to the test-api and sometimes other tools not yet ready for general consumption', 'woo-vipps'),
1594 'default' => VIPPS_TEST_MODE ? 'yes' : 'no',
1595 )
1596
1597
1598 );
1599
1600 $developerfields = array(
1601 'developertitle' => array(
1602 'title' => __('Developer mode', 'woo-vipps'),
1603 'type' => 'title',
1604 'class' => 'tab',
1605 'description' => __('These are settings for developers that contain extra features that are normally not useful for regular users, or are not yet ready for primetime', 'woo-vipps'),
1606 ),
1607
1608 'testmode' => array(
1609 'title' => __('Test mode', 'woo-vipps'),
1610 'label' => __('Enable test mode', 'woo-vipps'),
1611 'type' => 'checkbox',
1612 'description' => sprintf(__('If you enable this, transactions will be made towards the %1$s Test API instead of the live one. No real transactions will be performed. You will need to fill out your test
1613 accounts keys below, and you will need to install a special test-mode app from Testflight on a device (which cannot run the regular %1$s app). Contact %1$s\'s technical support if you need this. If you turn this mode off, normal operation will resume. If you have the VIPPS_TEST_MODE defined in your wp-config file, this will override this value. ', 'woo-vipps'), Vipps::CompanyName()),
1614 'default' => VIPPS_TEST_MODE ? 'yes' : 'no',
1615 ),
1616 'merchantSerialNumber_test' => array(
1617 'title' => __('Merchant Serial Number', 'woo-vipps'),
1618 'class' => 'vippspw',
1619 'label' => __('Merchant Serial Number', 'woo-vipps'),
1620 'type' => 'number',
1621 'description' => __('Your test account "Merchant Serial Number" from the Developer tab on https://portal.vippsmobilepay.com','woo-vipps'),
1622 'default' => '',
1623 ),
1624 'clientId_test' => array(
1625 'title' => __('Client Id', 'woo-vipps'),
1626 'label' => __('Client Id', 'woo-vipps'),
1627 'type' => 'password',
1628 'class' => 'vippspw',
1629 'description' => __('Find your test account under the "Developer" tab on https://portal.vippsmobilepay.com/ and choose "Show keys". Copy the value of "client_id"','woo-vipps'),
1630 'default' => '',
1631 ),
1632 'secret_test' => array(
1633 'title' => __('Client Secret', 'woo-vipps'),
1634 'label' => __('Client Secret', 'woo-vipps'),
1635 'type' => 'password',
1636 'class' => 'vippspw',
1637 'description' => __('Find your test account under the "Developer" tab on https://portal.vippsmobilepay.com/ and choose "show keys". Copy the value of "client_secret"','woo-vipps'),
1638 'default' => '',
1639 ),
1640 'Ocp_Apim_Key_eCommerce_test' => array(
1641 'title' => __('Subscription Key', 'woo-vipps'),
1642 'label' => __('Subscription Key', 'woo-vipps'),
1643 'type' => 'password',
1644 'class' => 'vippspw',
1645 'description' => __('Find your test account under the "Developer" tab on https://portal.vippsmobilepay.com/ and choose "show keys". Copy the value of "Vipps-Subscription-Key"','woo-vipps'),
1646 'default' => '',
1647 ),
1648 );
1649
1650 // Add all the standard fields
1651 foreach($mainfields as $key=>$field) {
1652 $this->form_fields[$key] = $field;
1653 }
1654 foreach($expressfields as $key=>$field) {
1655 $this->form_fields[$key] = $field;
1656 }
1657 foreach($checkoutfields as $key=>$field) {
1658 $this->form_fields[$key] = $field;
1659 }
1660
1661
1662 foreach($external_payment_fields as $key=>$field) {
1663 $this->form_fields[$key] = $field;
1664 }
1665
1666 foreach($vipps_checkout_widgets_fields as $key=>$field) {
1667 $this->form_fields[$key] = $field;
1668 }
1669
1670 foreach($vipps_checkout_shipping_fields as $key=>$field) {
1671 $this->form_fields[$key] = $field;
1672 }
1673 foreach($advancedfields as $key=>$field) {
1674 $this->form_fields[$key] = $field;
1675 }
1676
1677 // The react UI decides whether or not to show the developer fields, however we always have to send this data to the client
1678 // because otherwise the react UI will not be able to show the correct translations, since they would be missing.
1679 foreach($developerfields as $key=>$field) {
1680 $this->form_fields[$key] = $field;
1681 }
1682 // Developer mode settings: Only shown when active. IOK 2019-08-30
1683 if ($this->get_option('developermode') == 'yes' || VIPPS_TEST_MODE) {
1684 if (VIPPS_TEST_MODE) {
1685 $this->form_fields['developermode']['description'] .= '<br><b>' . __('VIPPS_TEST_MODE is set to true in your configuration - dev mode is forced', 'woo-vipps') . "</b>";
1686 $this->form_fields['testmode']['description'] .= '<br><b>' . __('VIPPS_TEST_MODE is set to true in your configuration - test mode is forced', 'woo-vipps') . "</b>";
1687 }
1688 }
1689
1690
1691 }
1692
1693
1694 // IOK 2018-04-18 utilities for the 'admin notices' interface.
1695 private function adminwarn($what) {
1696 add_action('vipps_admin_notices',function() use ($what) {
1697 echo "<div class='notice notice-warning is-dismissible'><p>$what</p></div>";
1698 });
1699 }
1700 private function adminerr($what) {
1701 add_action('vipps_admin_notices',function() use ($what) {
1702 echo "<div class='notice notice-error is-dismissible'><p>$what</p></div>";
1703 });
1704 }
1705 private function adminnotify($what) {
1706 add_action('vipps_admin_notices',function() use ($what) {
1707 echo "<div class='notice notice-info is-dismissible'><p>$what</p></div>";
1708 });
1709 }
1710
1711 // Only be available if current currency is NOK IOK 2018-09-19
1712 // Only be available if current currency is supported NT 2023-12-04
1713 public function is_available() {
1714 // This is split into two functions to avoid triggering infinite recursion in filters that override this value below. IOK 2021-10-30
1715 $ok = $this->standard_is_available();
1716 $ok = apply_filters('woo_vipps_is_available', $ok, $this);
1717 return $ok;
1718 }
1719
1720 // True if the alternative Vipps Checkout screen is both available and activated. Returns the page id of the checkout
1721 // page for convenience. IOK 2021-10-01
1722 public function vipps_checkout_available () {
1723
1724 if ($this->get_option('vipps_checkout_enabled') != 'yes') return false;
1725 if (!$this->standard_is_available()) return false;
1726
1727 $checkoutid = wc_get_page_id('vipps_checkout');
1728 if (!$checkoutid) return false;
1729
1730 // Page doesn't exist anymore
1731 if (! get_post_status($checkoutid)) {
1732 delete_option('woocommerce_vipps_checkout_page_id');
1733 return false;
1734 }
1735
1736 // Restrictions on cart are similar to express checkout, but not exactly the same. IOK 2024-01-11
1737 if (!$this->cart_supports_checkout()) return false;
1738
1739 // Filter to false if you want to use the standard checkout for whatever reason
1740 return apply_filters('woo_vipps_checkout_available', $checkoutid, $this);
1741 }
1742
1743 // Get supported currencies for payment method NT 2023-12-04
1744 public function get_supported_currencies($payment_method) {
1745 switch ($payment_method) {
1746 case 'Vipps': return array('NOK', 'SEK');
1747 case 'MobilePay': return array('DKK', 'EUR');
1748 default: return array();
1749 }
1750 }
1751
1752 // Check if payment method supports currency. NT 2023-12-04
1753 public function payment_method_supports_currency($payment_method, $currency) {
1754 $ok = in_array($currency, $this->get_supported_currencies($payment_method));
1755 return $ok;
1756 }
1757
1758 // Basic unfiltered version of "can I use vipps" ? IOK 2021-10-01
1759 protected function standard_is_available () {
1760 if (!$this->can_be_activated()) return false;
1761 if (!parent::is_available()) return false;
1762 if (!$this->payment_method_supports_currency($this->get_payment_method_name(), get_woocommerce_currency())) return false;
1763 return true;
1764 }
1765
1766 // True if the express checkout feature should be available
1767 public function express_checkout_available() {
1768 if (! $this->is_available()) return false;
1769 $ok = true;
1770 $ok = apply_filters('woo_vipps_express_checkout_available', $ok, $this);
1771 return $ok;
1772 }
1773
1774 // IOK 2018-04-20 Initiate payment at Vipps and redirect to the Vipps payment terminal.
1775 public function process_payment ($order_id) {
1776 global $woocommerce, $Vipps;
1777 if (!$order_id) return [];
1778
1779 do_action('woo_vipps_before_process_payment',$order_id);
1780
1781 // Get current merchant serial
1782 $msn = $this->get_merchant_serial();
1783
1784 // Do a quick check for correct setup first - this is the most critical point IOK 2018-05-11
1785 try {
1786 $at = $this->api->get_access_token($msn);
1787 } catch (Exception $e) {
1788 $this->log(sprintf(__('Could not get access token when initiating %1$s payment for order id:','woo-vipps'), $this->get_payment_method_name()) . $order_id .":\n" . $e->getMessage(), 'error');
1789 wc_add_notice(sprintf(__('Unfortunately, the %1$s payment method is currently unavailable. Please choose another method.','woo-vipps'), $this->get_payment_method_name()),'error');
1790 return [];
1791 }
1792
1793
1794 // From the request, get either [billing_phone] => or [vipps phone]
1795 $phone = '';
1796 if (isset($_POST['vippsphone'])) {
1797 $phone = trim(sanitize_text_field($_POST['vippsphone']));
1798 }
1799 if (!$phone && isset($_POST['billing_phone'])) {
1800 $phone = trim(sanitize_text_field($_POST['billing_phone']));
1801 }
1802
1803 // This is for express checkout if we know the customers' phone.
1804 // thanks to sOndre @ github for reporting , https://github.com/vippsas/vipps-woocommerce/issues/22
1805 if (!$phone && WC()->customer) {
1806 $phone = WC()->customer->get_billing_phone();
1807 }
1808
1809 // No longer the case for V2 of the API
1810 if (false && !$phone) {
1811 wc_add_notice(sprintf(__('You need to enter your phone number to pay with %1$s','woo-vipps'), $this->get_payment_method_name()) ,'error');
1812 return [];
1813 }
1814
1815 $order = wc_get_order($order_id);
1816 $content = null;
1817
1818 // Should be impossible, but there we go IOK 2022-04-21
1819 if (! $order->has_status(['pending', 'failed'])) {
1820 $this->log(sprintf(__("Trying to start order %1\$s with status %2\$s - only 'pending' and 'failed' are allowed, so this will fail", 'woo-vipps'), $order_id, $order->get_status()));
1821 wc_add_notice(sprintf(__('This order cannot be paid with %1$s - please try another payment method or try again later', 'woo-vipps'), $this->get_payment_method_name()), 'error');
1822 return [];
1823 }
1824
1825 // If the Vipps order already has an init-timestamp, we should *not* call init_payment again,
1826 // in the *normal* case, this is a user who have lost their vipps session, so it suffices to
1827 // just return the stored vipps session URL (eg. the user used the Back button.) If abandoned, the
1828 // order will eventually be cancelled. Changes in the cart will result in a new order anyway.
1829 // Note: we now also support restarting the payment with a new retry session if there is no stored vipps session. LP 2026-03-12
1830 if ($order->get_meta('_vipps_init_timestamp')) {
1831 $oldurl = $order->get_meta('_vipps_orderurl');
1832
1833 // Poll status at VMP here to verify session is still open. LP 2026-02-27
1834 $vipps_status = 'unknown';
1835 $vipps_session_open = false;
1836 try {
1837 $vipps_status = $this->get_payment_details($order)['status'] ?? 'unknown';
1838 if ('unknown' !== $vipps_status) {
1839 $vipps_status = $this->interpret_vipps_order_status($vipps_status);
1840 $vipps_session_open = 'initiated' === $vipps_status;
1841 }
1842 } catch (Exception $e) {
1843 /* translators: company name, order id */
1844 $this->log(sprintf(__('Retry-branch: error getting payment details from %1$s for order id %2$s:','woo-vipps'), $this->get_payment_method_name(), $order->get_id()) . "\n" . $e->getMessage(), 'error');
1845 }
1846
1847 // Do we have an active session we can redirect to? LP 2026-02-27
1848 if ($vipps_session_open && $oldurl) {
1849 $order->add_order_note(sprintf(__('%1$s payment restarted','woo-vipps'), $this->get_payment_method_name()));
1850 return array('result'=>'success','redirect'=>$oldurl);
1851 }
1852
1853 // If not, then we need to create a new retry session with incrementing index. LP 2026-03-12
1854 $retry_count = intval($order->get_meta('_vipps_retry_count')) + 1;
1855 $enable_payment_retry = 'unknown' !== $vipps_status; // dont retry unknown statuses. LP 2026-03-18
1856 if (apply_filters('woo_vipps_enable_payment_retry', $enable_payment_retry, $order, $vipps_status, $retry_count)) {
1857 /* translators: number of attempts, order id. */
1858 $this->log(sprintf(__('Order %2$d session could not be restored, creating a new retry session (retry #%1$d).', 'woo-vipps'), $retry_count, $order_id), 'info');
1859 $order->update_meta_data('_vipps_retry_count', $retry_count);
1860 $order->save_meta_data();
1861 } else {
1862 // If restarting is disabled, then we have to cancel the order. LP 2026-03-12
1863 /* translators: order id. */
1864 $this->log(sprintf(__('Order %1$d session could not be restored, and payment retry is disabled. Cancelling the order!', 'woo-vipps'), $order_id), 'info');
1865 $order->update_status('cancelled', sprintf(__('Cannot restart order at %1$s', 'woo-vipps'), Vipps::CompanyName()));
1866 return [];
1867 }
1868 }
1869
1870 // This is needed to ensure that the callbacks from Vipps have access to the customers' session which is important for some plugins. IOK 2019-11-22
1871 $this->save_session_in_order($order);
1872
1873 // Vipps-terminal-page return url to poll/await return
1874 $returnurl= $Vipps->payment_return_url();
1875 // If we are using express checkout, use this to handle the address stuff
1876 // IOK 2018-11-19 also when *not* using express checkout. This allows us to pass the order-id in the return URL and use this as a password in case the sesson has been lost.
1877 $authtoken = $this->generate_authtoken();
1878
1879 // IOK 2019-11-19 We have to do this because even though we actually store the order ID in the session, we can a) be redirected to another browser than the one with
1880 // the session, and b) some plugins wipe the session for guest purchases.
1881 // So we might need to restore (enough of the) session to get to the than you page, even if the session is gone
1882 // or in another castle.
1883 // IOK 2023-01-23 store the limited session in the order instead and separeted it from the authtoken
1884 $limited_session = $this->generate_authtoken();
1885 $returnurl = add_query_arg('ls',$limited_session,$returnurl);
1886 $returnurl = add_query_arg('id', $order_id, $returnurl);
1887
1888
1889 try {
1890 // If the order was 'failed', it isnt any more! yet!
1891 if ($order->get_status() == 'failed') {
1892 $order->set_status('pending', __('Setting order status to pending to start payment', 'woo-vipps'));
1893 }
1894 // The requestid is actually for replaying the request, but I get 402 if I retry with the same Orderid.
1895 // Still, if we want to handle transient error conditions, then that needs to be extended here (timeouts, etc)
1896 // Update: replaced requestid with new idempotency key, moved this into epayment_initiate_payment. LP 2026-03-13
1897 $content = $this->api->epayment_initiate_payment($phone,$order,$returnurl,$authtoken);
1898 } catch (TemporaryVippsApiException $e) {
1899 $this->log(sprintf(__('Could not initiate %1$s payment','woo-vipps'), $this->get_payment_method_name()) . ' ' . $e->getMessage(), 'error');
1900 wc_add_notice(sprintf(__('Unfortunately, the %1$s payment method is temporarily unavailable. Please wait or choose another method.','woo-vipps'), $this->get_payment_method_name()),'error');
1901 return [];
1902 } catch (Exception $e) {
1903
1904 // Special case the "duplicate order id" thing to ensure it doesn't happen again, and if it does, at least
1905 // log some more info IOK 2022-11-02
1906 if (preg_match("/Duplicate Order Id/i", $e->getMessage())) {
1907 do_action('woo_vipps_duplicate_order_id', $order);
1908 $this->log(sprintf(__("Duplicate Order ID! Please report this to support@wp-hosting.no together with as much info about the order as possible. Express: %1\$s Status: %2\$s User agent: %3\$s", 'woo-vipps'), $order->get_meta('_vipps_express_checkout'), $order->get_status(), $order->get_customer_user_agent()), 'error');
1909 $order->update_status('cancelled', __('Cannot restart order with same order ID: Must cancel', 'woo-vipps'));
1910 }
1911
1912 $this->log(sprintf(__('Could not initiate %1$s payment','woo-vipps'), $this->get_payment_method_name()) . ' ' . $e->getMessage(), 'error');
1913 wc_add_notice(sprintf(__('Unfortunately, the %1$s payment method is currently unavailable. Please choose another method.','woo-vipps'), $this->get_payment_method_name()),'error');
1914 return [];
1915 }
1916
1917 $url = $content['url'];
1918 $vippstamp = time();
1919
1920 // Ensure we only check the status by ajax of our own orders. IOK 2018-05-03
1921 $sessionorders= WC()->session->get('_vipps_session_orders');
1922 $sessionorders[$order_id] = 1;
1923 WC()->session->set('_vipps_session_orders',$sessionorders);
1924 WC()->session->set('_vipps_pending_order',$order_id); // Send information to the 'please confirm' screen IOK 2018-04-24
1925
1926 $order = wc_get_order($order_id);
1927 if ($authtoken) {
1928 $order->update_meta_data('_vipps_authtoken',wp_hash_password($authtoken));
1929 }
1930 if ($limited_session) {
1931 $order->update_meta_data('_vipps_limited_session',wp_hash_password($limited_session));
1932 }
1933 // Store the "session URL" for restarts of the order in the same session context. IOK 2022-11-02
1934 $order->update_meta_data('_vipps_init_timestamp',$vippstamp);
1935 $order->update_meta_data('_vipps_orderurl', $url);
1936
1937 $order->update_meta_data('_vipps_status','INITIATE'); // INITIATE right now
1938 $order->add_order_note(sprintf(__('%1$s payment initiated','woo-vipps'), $this->get_payment_method_name()));
1939 $order->add_order_note(sprintf(__('Awaiting %1$s payment confirmation','woo-vipps'), $this->get_payment_method_name()));
1940 $order->save();
1941
1942 // Create a signal file that we can check without calling wordpress to see if our result is in IOK 2018-05-04
1943 try {
1944 $Vipps->createCallbackSignal($order);
1945 } catch (Exception $e) {
1946 // Could not create a signal file, but that's ok.
1947 }
1948
1949 do_action('woo_vipps_before_redirect_to_vipps',$order_id);
1950
1951 // This will send us to a receipt page where we will do the actual work. IOK 2018-04-20
1952 return array('result'=>'success','redirect'=>$url);
1953 }
1954
1955
1956 // This tries to capture a Vipps payment, and resets the status to 'on-hold' if it fails. IOK 2018-05-07
1957 public function maybe_capture_payment($orderid) {
1958 $order = wc_get_order($orderid);
1959 if (! Vipps::is_vipps_order($order)) return false;
1960 $ok = 0;
1961
1962 # Shortcut orders that have been directly captured
1963 $vippsstatus = $order->get_meta('_vipps_status');
1964 if ($vippsstatus == 'SALE') {
1965 return true;
1966 }
1967
1968 $remaining = intval($order->get_meta('_vipps_capture_remaining'));
1969
1970 // Somehow the order status in payment_complete has been set to the 'after order status' or 'complete' by a filter. If so, do not capture.
1971 // Capture will be done *before* payment_complete if appropriate IOK 2020-09-22
1972 if (did_action('woocommerce_pre_payment_complete')) {
1973 if (!$order->needs_processing()) return; // This is fine, we've captured.
1974 if ($remaining>0) {
1975 // Not everything has been captured, but we have reached a capturable status. Complain, do not capture. IOK 2020-09-22
1976 $this->log(sprintf(__("Filters are setting the payment_complete order status to '%1\$s' - will not capture", 'woo-vipps'), $order->get_status()),'debug');
1977 $order->add_order_note(sprintf(__('Payment complete set status to "%1$s" - will not capture payments automatically','woo-vipps'), $order->get_status()));
1978 return false;
1979 }
1980 }
1981
1982 // IOK 2019-10-03 it is now possible to do capture via other tools than Woo, so we must now first check to see if
1983 // the order is capturable by getting full payment details.
1984 try {
1985 $order = $this->update_vipps_payment_details($order);
1986 } catch (Exception $e) {
1987 //Do nothing with this for now
1988 $this->log(__("Error getting payment details before doing capture: ", 'woo-vipps') . $e->getMessage(), 'warning');
1989 }
1990
1991 try {
1992 $ok = $this->capture_payment($order);
1993 } catch (Exception $e) {
1994 // This is handled in sub-methods so we shouldn't actually hit this IOK 2018-05-07
1995 }
1996 if ($ok) {
1997 // Signal other hooked actions that this one actually did something. IOK 2025-02-04
1998 $order->update_meta_data('_vipps_capture_complete',true);
1999 $order->save();
2000 } else {
2001 $order->update_meta_data('_vipps_capture_complete',false);
2002 $msg = sprintf(__("Could not capture %1\$s payment for this order!", 'woo-vipps'), $this->get_payment_method_name());
2003 $order->add_order_note($msg);
2004 $order->save();
2005 if (apply_filters('woo_vipps_on_hold_on_failed_capture', true, $order)) {
2006 $msg = sprintf(__("Could not capture %1\$s payment - status set to", 'woo-vipps'), $this->get_payment_method_name()) . ' ' . __('on-hold','woocommerce');
2007 $order->set_status('on-hold',$msg);
2008 $order->save();
2009 global $Vipps;
2010 $this->adminerr($msg);
2011 $Vipps->store_admin_notices();
2012 return false;
2013 }
2014 }
2015 }
2016
2017
2018 // Capture (possibly partially) the order. Only full capture really supported by plugin at this point. IOK 2018-05-07
2019 // Except that we *do* note that money "refunded" through vipps before capture should be "uncapturable". IOK 2024-11-25
2020 public function capture_payment($order) {
2021 $pm = $order->get_payment_method();
2022 if (! Vipps::is_vipps_order($pm)) {
2023 $this->log(sprintf(__('Trying to capture payment on order not made by %1$s:','woo-vipps'), $this->get_payment_method_name()). ' ' . $order->get_id(), 'error');
2024 $this->adminerr(sprintf(__('Cannot capture payment on orders not made by %1$s','woo-vipps'), $this->get_payment_method_name()));
2025 return false;
2026 }
2027
2028 // Partial capture can happen if the order is edited IOK 2017-12-19
2029 $captured = intval($order->get_meta('_vipps_captured'));
2030 $vippsstatus = $order->get_meta('_vipps_status');
2031 $noncapturable = intval($order->get_meta('_vipps_noncapturable')); // This money has been marked as not-to-be-captured. It will be cancelled on complete.
2032
2033 // Ensure 'SALE' direct captured orders work
2034 if (!$captured && $vippsstatus == 'SALE') {
2035 $order = $this->update_vipps_payment_details($order);
2036 $captured = intval($order->get_meta('_vipps_captured'));
2037 }
2038
2039 $total = round(wc_format_decimal($order->get_total(),'')*100);
2040 $amount = $total-$captured-$noncapturable; // IOK subtract any amount not to be captured here
2041
2042 if ($amount<=0) {
2043 $order->add_order_note(__('Payment already captured','woo-vipps'));
2044 return true;
2045 }
2046
2047 // If we already have captured everything, then we are ok! IOK 2017-05-07
2048 if ($captured) {
2049 $remaining = intval($order->get_meta('_vipps_capture_remaining'));
2050 if (!$remaining) {
2051 $order->add_order_note(__('Payment already captured','woo-vipps'));
2052 return true;
2053 }
2054 }
2055
2056 // Each time we succeed, we'll increase the 'capture' transaction id so we don't just capture the same amount again and again. IOK 2018-05-07
2057 // (but on failre, we don't increase it - and also, we don't really support partial capture yet.) IOK 2018-05-07
2058 $requestidnr = intval($order->get_meta('_vipps_capture_transid'));
2059 // IOK 2023-03-13 keep track of failed captures; because some stores automate capturing without paying attention to the result.
2060 // some reservations are for only 7 days (or 30 days or 180 days) so some orders will be uncapturable. This will be reset by the
2061 // 'Show full transaction details' metabox.
2062 $failures = intval($order->get_meta('_vipps_capture_failures'));
2063 $failurelimit = 10;
2064 try {
2065
2066 // Assume we cannot capture if we have gotten errors 10 times from the API
2067 if ($failures >= $failurelimit) {
2068 throw new Exception(sprintf(__("More than %1\$d API exceptions trying to capture order - this order cannot be captured.", 'woo-vipps'), $failures));
2069 }
2070
2071 $requestid = $requestidnr . ":" . $order->get_order_key();
2072 $api = $order->get_meta('_vipps_api');
2073
2074
2075 if ($api == 'banktransfer') {
2076 // This is an error - we should not ever get to the 'capture' branch if we are a banktransfer payment.
2077 // IOK 2024-01-09
2078 $content = [];
2079 } elseif ($api == 'epayment') {
2080 $content = $this->api->epayment_capture_payment($order,$amount,$requestid);
2081 } else {
2082 $content = $this->api->capture_payment($order,$amount,$requestid);
2083 }
2084 } catch (TemporaryVippsApiException $e) {
2085 $this->log(sprintf(__('Could not capture %1$s payment for order id:', 'woo-vipps'), $this->get_payment_method_name()) . ' ' . $order->get_id() . "\n" .$e->getMessage(),'error');
2086 $this->adminerr(sprintf(__('%1$s is temporarily unavailable.','woo-vipps'), $this->get_payment_method_name()) . "\n" . $e->getMessage());
2087 return false;
2088 } catch (Exception $e) {
2089 // Keep track of API failures up to a point. IOK 2024-03-13
2090 if ($failures < $failurelimit) {
2091 $order->update_meta_data('_vipps_capture_failures', $failures + 1);
2092 $order->save();
2093 }
2094
2095 $msg = sprintf(__('Could not capture %1$s payment for order_id:','woo-vipps'), $this->get_payment_method_name()) . ' ' . $order->get_id() . "\n" . $e->getMessage();
2096 $this->log($msg,'error');
2097 $this->adminerr($msg);
2098 return false;
2099 }
2100
2101 $currency = $order->get_currency();
2102
2103 // Previously, we got this from the transactionInfo field of the Vipps data - this is no longer provided. IOK 2025-08-12
2104 // We simply have to keep track: There is no way of knowing what the correct values are here yet, as we only get these values async, after
2105 // the fact.
2106 $captured = $amount + intval($order->get_meta('_vipps_captured'));
2107 $remaining = intval($order->get_meta('_vipps_amount')) - $captured - intval($order->get_meta('_vipps_cancelled'));
2108 $refundable = $captured - intval($order->get_meta('_vipps_refunded'));
2109
2110 $order->update_meta_data('_vipps_captured', $captured);
2111 $order->update_meta_data('_vipps_capture_remaining', $remaining);
2112 $order->update_meta_data('_vipps_refund_remaining', $refundable);
2113 $order->update_meta_data('_vipps_capture_timestamp', time());
2114 $order->add_order_note(sprintf(__('%1$s Payment captured:','woo-vipps'), $this->get_payment_method_name()) . ' ' . sprintf("%0.2f",$captured/100) . ' ' . $currency);
2115
2116
2117 // Since we succeeded, the next time we'll start a new transaction.
2118 $order->update_meta_data('_vipps_capture_transid', $requestidnr+1);
2119 $order->save();
2120
2121 return true;
2122 }
2123
2124
2125 // Cancel (only completely) a reserved but not yet captured order IOK 2018-05-07
2126 public function cancel_payment($order) {
2127 $pm = $order->get_payment_method();
2128 if (! Vipps::is_vipps_order($pm)) {
2129 $this->log(sprintf(__('Trying to cancel payment on order not made by %1$s:','woo-vipps'), $this->get_payment_method_name()). ' ' .$order->get_id(), 'error');
2130 $this->adminerr(sprintf(__('Cannot cancel payment on orders not made by %1$s','woo-vipps'), $this->get_payment_method_name()));
2131 return false;
2132 }
2133 // We'll use the same transaction id for all cancel jobs, as we can only do it completely. IOK 2018-05-07
2134 // For epayment, partial cancellations will be possible. IOK 2022-11-12
2135 $api = $order->get_meta('_vipps_api');
2136 try {
2137 $requestid = "";
2138 if ($api == 'banktransfer') {
2139 // If we are here, and the order is somehow not captured, just do nothing. IOK 2024-01-09
2140 $content = [];
2141 } elseif ($api == 'epayment') {
2142 $requestid = 1;
2143 // This will cancel any remaining, not-captured amount IOK 2026-01-28
2144 $content = $this->api->epayment_cancel_payment($order,$requestid);
2145 } else {
2146 // If we have captured the order, we can't cancel it with the ecom API IOK 2018-05-07
2147 $captured = intval($order->get_meta('_vipps_captured'));
2148 if ($captured>0) {
2149 $msg = sprintf(__('Cannot cancel a captured %1$s transaction - use refund instead', 'woo-vipps'), "ECOM " . $this->get_payment_method_name());
2150 $this->adminerr($msg);
2151 return false;
2152 }
2153 $content = $this->api->cancel_payment($order,$requestid);
2154 }
2155 } catch (TemporaryVippsApiException $e) {
2156 $this->log(sprintf(__('Could not cancel %1$s payment for order_id:', 'woo-vipps'), $this->get_payment_method_name()) . ' ' . $order->get_id() . "\n" .$e->getMessage(),'error');
2157 $this->adminerr(sprintf(__('%1$s is temporarily unavailable.','woo-vipps'), $this->get_payment_method_name()) . ' ' . $e->getMessage());
2158 return false;
2159 } catch (Exception $e) {
2160 $msg = sprintf(__('Could not cancel %1$s payment for order id:','woo-vipps'), $this->get_payment_method_name()) . $order->get_id() . "\n" . $e->getMessage();
2161 $this->log($msg,'error');
2162 $this->adminerr($msg);
2163 return false;
2164 }
2165
2166 // the epay v2 API would return transactionInfo and Summary with the result, the new epayment api returns nothing.
2167 // Removed epay branch 2025-08-12 IOK
2168 $total = intval($order->get_meta('_vipps_amount'));
2169 $captured = intval($order->get_meta('_vipps_captured'));
2170 # $cancelled = $amount + intval($order->get_meta('_vipps_cancelled');
2171 $cancelled = $total;
2172 $remaining = $total - $captured - $cancelled;
2173
2174 // We need to assume it worked. Also, we can't do partial cancels yet, so just cancel everything.
2175 $order->update_meta_data('_vipps_cancel_timestamp',time());
2176 $order->update_meta_data('_vipps_cancelled', $cancelled);
2177 $order->update_meta_data('_vipps_cancel_remaining', $remaining);
2178
2179
2180 // Set status from Vipps, ignore errors, use statusdata if we have it.
2181 try {
2182 $status = $this->get_vipps_order_status($order);
2183 if ($status) $order->update_meta_data('_vipps_status',$status);
2184 $order->add_order_note(sprintf(__('%1$s Payment cancelled:','woo-vipps'), $this->get_payment_method_name()));
2185 $order->save();
2186 } catch (Exception $e) {
2187 }
2188 return true;
2189 }
2190
2191 // Refund (possibly partially) the captured order. IOK 2018-05-07
2192 // The caller must handle the errors.
2193 public function refund_payment($order,$amount=0,$cents=false) {
2194 $pm = $order->get_payment_method();
2195 if (! Vipps::is_vipps_order($pm)) {
2196 $msg = sprintf(__('Trying to refund payment on order not made by %1$s:','woo-vipps'), $this->get_payment_method_name()) . ' ' . $order->get_id();
2197 $this->log($msg,'error');
2198 throw new VippsAPIException($msg);
2199 }
2200
2201
2202 // If we haven't captured anything, we can't refund IOK 2017-05-07
2203 $captured = intval($order->get_meta('_vipps_captured'));
2204 if (!$captured) {
2205 $msg = sprintf(__('Trying to refund payment on %1$s payment not captured:','woo-vipps'), $this->get_payment_method_name()). ' ' .$order->get_id();
2206 $this->log($msg,'error');
2207 throw new VippsAPIException($msg);
2208 }
2209
2210 // Each time we succeed, we'll increase the 'refund' transaction id so we don't just refund the same amount again and again. IOK 2018-05-07
2211 // (but on failre, we don't increase it.) IOK 2018-05-07
2212 $requestidnr = intval($order->get_meta('_vipps_refund_transid'));
2213 $requestid = $requestidnr . ":" . $order->get_order_key();
2214
2215 $api = $order->get_meta('_vipps_api');
2216 if ($api == 'banktransfer') {
2217 $msg = sprintf(__("Cannot refund bank transfer order %1\$d", 'woo-vipps'), $order->get_id());
2218 $this->log($msg, 'error');
2219 throw new Exception($msg);
2220 } elseif ($api == 'epayment') {
2221 $content = $this->api->epayment_refund_payment($order,$requestid,$amount,$cents);
2222 } else {
2223 $content = $this->api->refund_payment($order,$requestid,$amount,$cents);
2224 }
2225
2226 $currency = $order->get_currency();
2227
2228 // Previously, we got updated transaction info in a transactionInfo field. this is no longer provided,
2229 // so we have to do dead reckoning. IOK 2025-08-12
2230 // We simply have to keep track: There is no way of knowing what the correct values are here yet, as we only get these values async, after
2231 // the fact.
2232 $captured = intval($order->get_meta('_vipps_captured'));
2233
2234 if (!$amount) {
2235 $amount = wc_format_decimal($order->get_total(),'');
2236 $cents = false;
2237 }
2238 if ($amount && !$cents) {
2239 $amount = round($amount * 100);
2240 }
2241
2242 $refunded_now = $amount;
2243 $refunded = intval($order->get_meta('_vipps_refunded')) + $amount;
2244 $remaining = $captured - $refunded;
2245
2246 $order->update_meta_data('_vipps_refunded', $refunded);
2247 $order->update_meta_data('_vipps_refund_remaining', $remaining);
2248 $order->update_meta_data('_vipps_refund_timestamp', time());
2249 $order->add_order_note(sprintf(__('%1$s Payment Refunded:','woo-vipps'), $this->get_payment_method_name()) . ' ' . sprintf("%0.2f",$refunded/100) . ' ' . $currency );
2250
2251 // Since we succeeded, the next time we'll start a new transaction.
2252 $order->update_meta_data('_vipps_refund_transid', $requestidnr+1);
2253 $order->save();
2254 return true;
2255 }
2256
2257 // Generate a one-time password for certain callbacks, with some backwards compatibility for PHP 5.6
2258 public function generate_authtoken($length=32) {
2259 $token="";
2260 if (function_exists('random_bytes')) {
2261 $token = bin2hex(random_bytes($length));
2262 } elseif (function_exists('openssl_random_pseudo_bytes')) {
2263 $token = bin2hex(openssl_random_pseudo_bytes($length));
2264 } elseif (function_exists('mcrypt_create_iv')) {
2265 // These aren't "secure" but they are probably ok for this purpose. IOK 2018-05-18
2266 $indirect = 'mcrypt_create_iv'; // grep-based 7.2 compatibility checkers need to be worked around IOK 2018-10-24
2267 $token = bin2hex($indirect($length));
2268 } else {
2269 // Final fallback
2270 $token = bin2hex(md5(microtime() . ":" . mt_rand()));
2271 }
2272
2273 return $token;
2274 }
2275
2276 // Collapse several statuses to a known list IOK 2019-01-23
2277 // Statuses still in use are annotated. IOK 2025-08-12
2278 public function interpret_vipps_order_status($status) {
2279 switch ($status) {
2280 case 'INITIATE': // legacy, used by us to indicate a fresh order
2281 case 'REGISTER':
2282 case 'REGISTERED':
2283 case 'CREATED': // Checkout, Epayment
2284 return 'initiated';
2285 break;
2286 case 'RESERVE':
2287 case 'RESERVED':
2288 case 'AUTHORISED':
2289 case 'AUTHORIZED': // Checkout, Epayment
2290 case 'CAPTURED': // Epayment
2291 case 'REFUNDED': // epayment - this is probably authorized, because it will have had that state *before* it was refuned. IOK 2025-08-12
2292 return 'authorized';
2293 break;
2294 case 'SALE':
2295 return 'complete';
2296 break;
2297 case 'CANCEL':
2298 case 'CANCELLED': // Epayment
2299 case 'VOID':
2300 case 'AUTOREVERSAL':
2301 case 'AUTOCANCEL':
2302 case 'AUTO_CANCEL':
2303 case 'RESERVE_FAILED':
2304 case 'FAILED':
2305 case 'REJECTED':
2306 case 'TERMINATED': // Checkout, Epayment
2307 case 'ABORTED': // Epayment
2308 case 'EXPIRED': // Epayment
2309 return 'cancelled';
2310 break;
2311 }
2312 // Default should never happen, but just to ensure we are in our enumeration
2313 return "initiated";
2314 }
2315
2316 // This does not normally call Vipps, so if you need to refresh status, please use callback_check_order_status first. IOK 2019-01-23
2317 public function check_payment_status($order) {
2318 if (!$order) return 'cancelled';
2319 $status = $this->interpret_vipps_order_status($order->get_meta('_vipps_status'));
2320 // This can happen if the vipps status is set from the back end for instance. IOK 2020-08-14
2321 if ($order->get_status() == 'pending' && $status != 'initiated') {
2322 $this->callback_check_order_status($order);
2323 $order = wc_get_order($order->get_id()); // refresh to get the new status IOK 2021-01-20
2324 $status = $this->interpret_vipps_order_status($order->get_meta('_vipps_status'));
2325 }
2326 return $status;
2327 }
2328
2329 // Called by callback_check_order_status and handle_callback to handle the situation where
2330 // the payment method has been set to something else *after* Vipps has gotten the order.
2331 // This happens very rarely for people who use Vipps as an external payment method in Klarna, so
2332 // we only do it for orders that match this. IOK 2023-02-03
2333 public function reset_erroneous_payment_method($order) {
2334 // This is only called by methods that are Vipps-specific, but still lets be careful not to touch other orders
2335
2336 // New 2026-01-05: we now check all other payment methods that aren't vipps, and reset it back to vipps.
2337 // The issue was using Klarna Payments and pressing 'back' in the browser, then completing the payment in vipps checkout
2338 // the order still had the payment method klarna_payments, since we previously only checked 'kco' = klarna/kustom checkout. LP 2026-01-05
2339 if (! Vipps::is_vipps_order($order) && $order->get_meta("_vipps_orderid")) {
2340 $order->set_payment_method('vipps');
2341 $express = $order->get_meta('_vipps_express_checkout');
2342 $checkout = $order->get_meta('_vipps_checkout');
2343 $order->set_payment_method_title('Vipps');
2344 if ($express) $order->set_payment_method_title('Vipps Express Checkout');
2345 if ($checkout) $order->set_payment_method_title('Vipps Checkout');
2346 $order->save();
2347
2348 $msg = sprintf(__("Payment method reset to %1\$s - it had been set to another payment method while completing the order for %2\$d", 'woo-vipps'), $this->get_payment_method_name(), $order->get_id());
2349 $this->log($msg, 'debug');
2350 $order->add_order_note($msg);
2351 }
2352 }
2353
2354 // Check status of order at Vipps, in case the callback has been delayed or failed.
2355 // Should only be called if in status 'pending'; it will modify the order when status changes.
2356 public function callback_check_order_status($order, $allow_retry = true) {
2357 global $Vipps;
2358 $orderid = $order->get_id();
2359
2360 clean_post_cache($order->get_id());
2361 $order = wc_get_order($orderid); // Ensure a fresh copy is read.
2362
2363 $oldstatus = $order->get_status();
2364 $newstatus = $oldstatus;
2365
2366 // Only do work when the orders woo status is pending
2367 if ($oldstatus != 'pending') return $oldstatus;
2368
2369 $oldvippsstatus = $this->interpret_vipps_order_status($order->get_meta('_vipps_status'));
2370 $vippsstatus = "";
2371
2372 /* Now read the payment details and update the order with the relevant values, finding the new Vipps status IOK 2021-01-20 */
2373 $paymentdetails = array();
2374 try {
2375 $paymentdetails = $this->get_payment_details($order);
2376 $newvippsstatus = $paymentdetails['status'];
2377 $vippsstatus = $this->interpret_vipps_order_status($newvippsstatus);
2378
2379 $ready = false; // True if money is authorized or complete
2380 if (in_array($vippsstatus, ['authorized', 'complete'])) {
2381 $ready = true;
2382 }
2383
2384 // No change == nothing to do. Ensure we don't modify the order at this point. IOK 2025-10-24
2385 if ($vippsstatus == $oldvippsstatus) {
2386 return $oldstatus;
2387 }
2388 // Something changed, so we are now going to sideeffect the order. IOK 2025-10-15
2389 $this->log(sprintf(__("%1\$s poll: Handling order: ", 'woo-vipps'), Vipps::CompanyName()) . " " . $orderid, 'debug');
2390
2391 // If we are in the process of getting a callback from vipps, don't update anything. Currently, Woo/WP has no locking mechanism,
2392 // and it isn't feasible to implement one portably. So this reduces somewhat the likelihood of races when this method is called
2393 // and callbacks happen at the same time.
2394 if (!$Vipps->lockOrder($order)) {
2395 return $oldstatus;
2396 }
2397
2398 // Failsafe for rare bug when using Klarna Checkout with Vipps as an external payment method
2399 // IOK 2024-01-09 ensure this is called only when order is complete/authorized
2400 if ($ready) {
2401 $this->reset_erroneous_payment_method($order);
2402 }
2403
2404 $order->update_meta_data('_vipps_status',$newvippsstatus);
2405
2406 // Extract order metadata from either Checkout or Epayment - set below IOK 2025-08-13
2407 if (!empty($paymentdetails)) {
2408
2409
2410 // checkout has a string, epayment has an array with upper case "type" and apparently, cardBin IOK 2025-08-12
2411 $paymentMethod = $paymentdetails['paymentMethod'] ?? "epayment";
2412 // After normalization, all APIs will have data here.
2413 $details = $paymentdetails['paymentDetails'];
2414 if (isset($details['paymentMethod'])) {
2415 $paymentMethod = $details['paymentMethod'];
2416 }
2417 if (!is_string($paymentMethod)) {
2418 // should be WALLET
2419 $paymentMethod = $paymentMethod['type'] ?? "epayment";
2420 }
2421 $transaction = array();
2422 $transaction['timeStamp'] = date('Y-m-d H:i:s', time());
2423 $transaction['amount'] = $details['amount']['value'];
2424 $transaction['currency'] = $details['amount']['currency'];
2425 $transaction['status'] = $details['state'];
2426 $transaction['paymentmethod'] = $paymentMethod;
2427 $this->order_set_transaction_metadata($order, $transaction);
2428 }
2429
2430 } catch (Exception $e) {
2431 $this->log(sprintf(__("Error getting payment details from %1\$s for order_id:",'woo-vipps'), $this->get_payment_method_name()) . $orderid . "\n" . $e->getMessage(), 'error');
2432 clean_post_cache($order->get_id());
2433 $Vipps->unlockOrder($order);
2434 return $oldstatus;
2435 }
2436 $order->save();
2437
2438 // We have a completed order, but the callback haven't given us the payment details yet - so handle it.
2439 if (($vippsstatus == 'authorized' || $vippsstatus=='complete') && $order->get_meta('_vipps_express_checkout')) {
2440
2441 do_action('woo_vipps_express_checkout_get_order_status', $paymentdetails);
2442 $address_set = $order->get_meta('_vipps_shipping_set');
2443
2444 if ($address_set) {
2445 // Callback has handled the situation, do nothing
2446 } elseif ($paymentdetails['shippingDetails'] ?? "") {
2447 // We need to set shipping details here
2448 $billing = isset($paymentdetails['billingDetails']) ? $paymentdetails['billingDetails'] : false;
2449 $this->set_order_shipping_details($order,$paymentdetails['shippingDetails'], $paymentdetails['userDetails'], $billing, $paymentdetails);
2450 } else {
2451 // IN THIS CASE we actually need to cancel the order as we have no way of determining whose order this is.
2452 // But first check to see if it has customer info!
2453 // Cancel any orders where the Checkout session is dead and there is no address info available
2454 if (!$order->has_shipping_address() && !$order->has_billing_address()) {
2455 $this->log(sprintf(__("No shipping details from %1\$s for express checkout for order id:",'woo-vipps'), $this->get_payment_method_name()) . ' ' . $orderid, 'error');
2456 $sessiontimeout = time() - (60*90);
2457 $then = intval($order->get_meta('_vipps_init_timestamp'));
2458 if ($then < $sessiontimeout) {
2459 $this->log(sprintf(__("Order %2\$d has no address info and any %1\$s session is dead - have to cancel.", 'woo-vipps'), Vipps::CheckoutName(), $order->get_id()));
2460 $order->update_status('cancelled', sprintf(__('Could not get address info for order from %1$s', 'woo-vipps'), Vipps::CompanyName()));
2461 $order->save();
2462 } else {
2463 // NOOP - the vipps checkout session can still be active, so we need to let it be
2464 $this->log(sprintf(__("No address information for order %2\$d, but there still might be an active %1\$s session for it, so do not cancel it.", 'woo-vipps'), Vipps::CheckoutName(), $order->get_id()));
2465 }
2466 }
2467 clean_post_cache($order->get_id());
2468 $Vipps->unlockOrder($order);
2469 return $oldstatus;
2470 }
2471 }
2472
2473 # Since the order is pending, and the vipps status has changed, switch to the correct vipps status in woo too IOK 2025-10-24
2474 switch ($vippsstatus) {
2475 case 'authorized':
2476 $this->payment_complete($order);
2477 break;
2478 case 'complete':
2479 $msg = sprintf(__('Payment captured directly at %1$s', 'woo-vipps'), $this->get_payment_method_name());
2480 $msg = $msg . __(" - order does not need processing", 'woo-vipps');
2481 $order->add_order_note($msg);
2482 $order = $this->update_vipps_payment_details($order, $paymentdetails);
2483 $order->payment_complete();
2484 break;
2485 case 'cancelled':
2486 $order_is_retryable = $allow_retry && Vipps::order_is_vipps_retryable($order->get_id());
2487 $status_on_fail = $this->get_option('status_on_fail');
2488 $cancel_on_fail = apply_filters('woo_vipps_cancel_failed_orders', false, $order, $vippsstatus);
2489 if ($cancel_on_fail || !$order_is_retryable) {
2490 $status_on_fail = 'cancelled';
2491 }
2492 if (!in_array($status_on_fail, ['cancelled', 'failed'])) {
2493 /* translators: order status name. Cancelled is woocommerce status name */
2494 $this->log(__('Unsupported status for payment failure of \'%1$s\', falling back to cancelled.', 'woo-vipps'), 'warning');
2495 $status_on_fail = 'cancelled';
2496 }
2497
2498 /* translators: company name */
2499 $order->update_status($status_on_fail, sprintf(__('Order failed or rejected at %1$s.', 'woo-vipps'), Vipps::CompanyName()));
2500 break;
2501 }
2502
2503 $order->save();
2504 clean_post_cache($order->get_id());
2505 $newstatus = $order->get_status();
2506 $Vipps->unlockOrder($order);
2507 return $newstatus;
2508 }
2509
2510 // IOK 2020-01-20 Previously was just a debugging tool, then was used to update postmeta values. Now is used as the main source of info
2511 // about the order from Vipps; the previous side-effecting is now done by update_vipps_payment_details.
2512 // IOK 2021-11-24 Because of this, we need to handle 402 and 404 errors differently here now - these *are* results, meaning there is
2513 // no payment details because the order doesn't exist.
2514 // IOK 2022-01-19 And now, with the epayment API in use by checkout, we also need to use the poll api because the epayment API does not return user- and shipping data. We do get an order status though.
2515 // IOK 2025-08-12 And now, with epayment used for Express Checkout also, there *is* user- and shipping-data when using Express Checkout, so we can simplify. We still need to transform the data
2516 // so old hooks and filters can get the input they expect.
2517 public function get_payment_details($order) {
2518 $result = array();
2519 $checkout_session = $order->get_meta('_vipps_checkout_session');
2520 $express = $order->get_meta('_vipps_express_checkout');
2521
2522 // IOK 2025-08-12: Three cases; either this is Checkout, in which case we need to get user/shipping-data from the checkout session,
2523 // or it is Express Checkout or normal payment, in which cases we just retrieve the payment from the epayment API - possibly containing user data
2524 if ($checkout_session) {
2525 try {
2526 $result = $this->api->checkout_get_session_info($order);
2527
2528 if ($result == 'EXPIRED') {
2529 $result = array('status'=>'CANCEL', 'state'=>'CANCEL');
2530 return $result;
2531 }
2532
2533 // For checkout, we are really handling *session states* which we map to *order states*, but sometimes
2534 // these indicate a failed order.
2535 // 'state' can be missing for Checkout, first case is if this is because the session is invalid.
2536 // The sesssion states are # "SessionCreated" "PaymentInitiated" "SessionExpired" "PaymentSuccessful" "PaymentTerminated"
2537 if (isset($result['sessionState']) && ($result['sessionState'] == 'SessionTerminated' || $result['sessionState'] == 'SessionExpired')) {
2538 $result['state'] = 'CANCEL';
2539 $result['status'] = 'CANCEL';
2540 $order->add_order_note(sprintf(__('%1$s Order with no order status, so session was never completed; setting status to cancelled', 'woo-vipps'), Vipps::CheckoutName()));
2541 return $result;
2542 }
2543
2544 // IOK 2023-12-14 at some point, apparently SessionStarted became SessionCreated
2545 if (isset($result['sessionState']) && ($result['sessionState'] == 'SessionStarted' || $result['sessionState'] == 'SessionCreated')) {
2546 // We have no order info, only the session data (this is a checkout order). Therefore, assume it has been started at least.
2547 $result['status'] = "INITIATE";
2548 $result['state'] = "INITIATE";
2549 $created = $order->get_date_created();
2550 $timestamp = 0;
2551 $now = time();
2552 try {
2553 $timestamp = $created->getTimestamp();
2554 } catch (Exception $e) {
2555 // PHP 8 gives ValueError for certain older versions of WooCommerce here.
2556 $timestamp = intval($created->format('U'));
2557 }
2558 $passed = $now - $timestamp;
2559 $minutes = ($passed / 60);
2560
2561 // Give up after 120 minutes. Actually, 60 minutes is probably enough: We expire live sessions after 50 mins.
2562 if ($minutes > 120) {
2563 $this->log(sprintf(__('Checkout order older than 120 minutes with no order status - cancelled as abandoned: %1$s', 'woo-vipps'), $order->get_id()), 'debug');
2564 $order->add_order_note(sprintf(__('%1$s Order with no order status, so session was never completed; setting status to cancelled', 'woo-vipps'), Vipps::CheckoutName()));
2565 $result['status'] = 'CANCEL';
2566 $result['state'] = 'CANCEL';
2567 }
2568 return $result;
2569 }
2570
2571
2572 } catch (VippsAPIException $e) {
2573 $resp = intval($e->responsecode);
2574 if ($resp == 402 || $resp == 404) {
2575 $result = array('status'=>'CANCEL', 'state'=>'CANCEL');
2576 return $result;
2577 } else {
2578 throw $e;
2579 }
2580 }
2581 } else {
2582 try {
2583 $result = $this->api->epayment_get_payment($order);
2584 } catch (VippsAPIException $e) {
2585 $resp = intval($e->responsecode);
2586 if ($resp == 402 || $resp == 404) {
2587 $result = array('status'=>'CANCEL', 'state'=>'CANCEL');
2588 return $result;
2589 } else {
2590 $this->log(sprintf(__("Could not get order status from %1\$s using epayment api: ", 'woo-vipps'), Vipps::CompanyName()) . $e->getMessage(), "error");
2591 throw $e;
2592 }
2593 }
2594 }
2595
2596 if (!$result || $result == "ERROR") {
2597 $this->log(sprintf(__("Could not get payment results for order %1\$s", 'woo-vipps'), $order->get_id()));
2598 wp_die(sprintf(__("Could not get payment results for order %1\$s - you may have the wrong MSN for the order. Please check logs for more information", 'woo-vipps'), $order->get_id()));
2599 }
2600
2601 // We now have a result which maybe will contain user and shipping data, which we will need to normalize because it is slightly different in the different
2602 // APIs, and we have provided filters/hooks that receive this information. IOK 2025-08-12
2603 // If we now have epayment data, we want to translate this to the ecom 'view' for now. Later, we will do the opposite.
2604 // We now only need to map Checkout and epayment to the same format, but we will try to keep the normalized result compatible with
2605 // ecom, in case consumers have created filters/hooks. IOK 2025-08-12
2606
2607 // if Checkout, the result will have a sessionState, reference etc, userInfo, shippingDetails, billingDetails and the payment details in a paymentDetails member.
2608 // if not, the result will *be* a paymentDetails field, but with user*Details* and shippingDetails added. No billingDetails.
2609 // The end result should have state/status (not neccessarily present with Checkout), userDetails, paymentDetails, shippingDetails and billingDetails, and a transactionSummary.
2610 // Because that's what the code depending on this has been expecting. IOK 2025-08-12
2611 if (!$checkout_session) {
2612 // This should be an ecom result, so move all data (for simplicitys sake) into paymentDetails
2613 $result['paymentDetails'] = $result;
2614 }
2615 // Ensure we get payment details with state + aggregate, which we do not if the payment method is bank transfer for checkout. IOK 2024-01-09
2616 // Also add keys and transform for backwards compatibility.
2617 $result = $this->normalizePaymentDetails($result);
2618 $newstatus = $this->interpret_vipps_order_status($result['status']);
2619 $ready = false;
2620 if (in_array($newstatus, ['authorized', 'complete'])) {
2621 $ready = true;
2622 }
2623
2624
2625 // if this is *express - not checkout * and there is no user information, this is probably because we only get that when adding the 'address' scope.
2626 // if we didn't want the address, we now need to ask for user details using the login get_userinfo api. IOK 2025-08-12
2627 // This is also the only way to get "email_verified", so we may want to add a setting that always calls this if neccessary. IOK 2025-08-13
2628 // Also we don't get this when the state is different from AUTHORIZED. Especially not ABORTED.
2629 // IOK 2025-09-29: This is *no longer the case* . We actually now get userDetails every time we add the relevant scopes,
2630 // so this is now probably dead code.
2631 if ($ready && $express && !$checkout_session && !isset($result['userDetails'])) {
2632
2633 $sub = isset($result['profile']) && isset($result['profile']['sub']) ? $result['profile']['sub'] : null;
2634 $userinfo = [];
2635 if (!$sub) {
2636 // This should never happen, but be prepared
2637 $message = sprintf(__("Could not get user info for order %1\$d using the userinfo API: %2\$s. Please use the 'get complete transaction details' on the button to try to recover this. ", 'woo-vipps'), $order->get_id(), "No 'sub' passed for user ID" );
2638 $order->add_order_note($message);
2639 $this->log($message , "error");
2640 } else {
2641 // If this happens, the merchant *may* be able to retrieve the information from Vipps so add a note for it.
2642 try {
2643 $userinfo = $this->api->get_userinfo($sub);
2644 } catch (Exception $e) {
2645 $message = sprintf(__("Could not get user info for order %1\$d using the userinfo API: %2\$s. Please use the 'get complete transaction details' on the button to try to recover this. ", 'woo-vipps'), $order->get_id(), $e->getMessage());
2646 $order->add_order_note($message);
2647 $this->log($message, 'woo-vipps', "error");
2648 }
2649 }
2650 if ($userinfo) {
2651 $userDetails = array(
2652 'email_verified' => $userinfo['email_verified'],
2653 'email' => $userinfo['email'],
2654 'firstName' => $userinfo['given_name'] ?? '',
2655 'lastName' => $userinfo['family_name'] ?? '',
2656 'mobileNumber' => $userinfo['phone_number'] ?? '',
2657 'phoneNumber' => $userinfo['phone_number'] ?? '',
2658 'userId' => $userinfo['phone_number'] ?? '',
2659 'sub' => $userinfo['sub']
2660 );
2661
2662 $result['userDetails'] = $userDetails;
2663
2664 // We may have asked for the address of the customer, so add that too, or a dummy.
2665 if (!isset($result['shippingDetails'])) {
2666 $countries=new WC_Countries();
2667 $address =[];
2668 $address['addressLine1'] = "";
2669 $address['addressLine2'] = "";
2670 $address['city'] ="";
2671 $address['postCode'] = "";
2672 $address['country'] = $countries->get_base_country();
2673
2674 // This uses other keys than both epayment and checkout, but we'll normalize it later. IOK 2025-08-13
2675 if (isset($userinfo['address'])) {
2676 $address['addressLine1'] = $userinfo['address']['street_address'];
2677 $address['city'] = $userinfo['address']['region'];
2678 $address['country'] = $userinfo['address']['country'];
2679 $address['postCode'] = $userinfo['address']['postal_code'];
2680 }
2681 $result['shippingDetails'] = ['address' => $address];
2682 }
2683 }
2684 }
2685
2686 if ($ready && ($express || $checkout_session)) {
2687 // For Vipps Checkout version 3 there are no more userDetails, so we will add it, including defaults for anonymous purchases IOK 2023-01-10
2688 // This will also normalize userDetails, adding 'sub' where required and fields for backwards compatibility. 2025-08-12
2689 $result = $this->ensure_userDetails($result, $order);
2690
2691 // After, we need to normalize shipping details or even add them if e.g. using Checkout without address or contact info IOK 2025-08-13
2692 // Epayment Express Checkout is of course also significantly different from both the old Express and from Checkout in the formatting here. IOK 2025-08-12
2693 $result = $this->normalizeShippingDetails($result, $order);
2694 }
2695
2696 return $result;
2697 }
2698
2699 // IOK 2025-08-12 Normalize the shippingDetails field for backwards compatibility, since this is different from old express, new express and checkout.
2700 function normalizeShippingDetails($result, $order) {
2701
2702 // We may actually get no shipping details eg. for Checkout when not asking for addresses etc.
2703 if (!isset($result['shippingDetails'])) {
2704 $result['shippingDetails'] = ['address' => [] ];
2705 }
2706 $details = $result['shippingDetails'];
2707
2708 $user = $result['userDetails']; // Normalized earlier
2709 $address = $details['address'] ?? [];
2710
2711 // No address, but we have a list of addresses in the userDetails field. This is ecom with the address scope added.
2712 // We will use the first one.
2713 if (empty($address) && isset($result['userDetails']) && isset($result['userDetails']['addresses']) && !empty($result['userDetails']['addresses'])) {
2714 $address = $result['userDetails']['addresses'][0];
2715 }
2716
2717 // Checkout has address info inside shippingDetails, whereas Express Checkout now has it in an address field IOK 2025-08-12
2718 if (empty($address)) {
2719 $address['firstName'] = $details['firstName'] ?? "";
2720 $address['lastName'] = $details['lastName'] ?? "";
2721 $address['email'] = $details['email'] ?? "";
2722 $address['mobileNumber'] = $details['phoneNumber'] ?? "";
2723 $address['addressLine1'] = $details['streetAddress'] ?? "";
2724 $address['addressLine2'] = "";
2725 $address['city'] = $details['city'] ?? "";
2726 $address['postCode'] = $details['postalCode'] ?? "";
2727 $address['country'] = $details['country'] ?? "";
2728 }
2729
2730 // Need at least a country for VAT so add our own.
2731 if (!$address['country']) {
2732 $countries=new WC_Countries();
2733 $address['country'] = $countries->get_base_country();
2734 }
2735
2736 // Normalize from user details when neccessary (mostly for new express)
2737 $address['firstName'] = ($address['firstName'] ?? "") ?: $user['firstName'];
2738 $address['lastName'] = ($address['lastName'] ?? "") ?: $user['lastName'];
2739 $address['email'] = ($address['email'] ?? "") ?: $user['email'];
2740 $address['mobileNumber'] = ($address['mobileNumber'] ?? "") ?: $user['mobileNumber'];
2741
2742 // phoneNumber is checkout, mobileNumber is epayment
2743 $address['phoneNumber'] = $address['mobileNumber'];
2744 // addressline1 and 2 are epayment, streetAddress is checkout
2745 $address['streetAddress'] = $address['addressLine1'];
2746 // postCode is epayment, postalCode is checkout
2747 $address['postalCode'] = $address['postCode'];
2748
2749
2750 // Ensure we have 'address' as in Express/epayment
2751 $details['address'] = $address;
2752
2753 // Name change from Checkout/Express to new Express from MethodId to OptionId IOK 2025-08-12
2754 $details['shippingMethodId'] = $details['shippingMethodId'] ?? ($details['shippingOptionId'] ?? "");
2755 $details['shippingOptionId'] = $details['shippingMethodId'];
2756
2757 $result['shippingDetails'] = $details;
2758 return $result;
2759 }
2760
2761
2762 // IOK 2024-01-09 If using Vipps Checkout with the BankTransfer method, which is eg. used in Finland,
2763 // we are (currently) not receiving any 'state' or 'aggregate', so add this iff the payment is successful.
2764 // The reason for this is that this payment type does not actually use the epayment API at all (!)
2765 // Also moved some other compatibility code here -
2766 // --- reference used to be orderId
2767 // --- state used to be status
2768 // --- there used to be a transactionSummary field
2769 // --- at one point there was a 'transactionAggregate' instead of an 'aggregate'
2770 private function normalizePaymentDetails($result) {
2771 // the 'reference' used to be an 'orderId', keep for compatibility.
2772 $result['orderId'] = $result['reference'];
2773 if (isset($result['sessionState']) && $result['sessionState'] == 'PaymentSuccessful' && $result['paymentMethod'] == 'BankTransfer') {
2774 $details = $result['paymentDetails'];
2775 $details['state'] = 'SALE'; // Payment is actually complete at this point
2776 $aggregate=[];
2777 $aggregate['capturedAmount'] = $details['amount'];
2778 $aggregate['authorizedAmount'] = $details['amount'];
2779 $aggregate['refundedAmount'] = ['value'=>0, 'currency'=>$details['amount']['currency']];
2780 $aggregate['cancelledAmount'] = ['value'=>0, 'currency'=>$details['amount']['currency']];
2781 $details['aggregate'] = $aggregate;
2782 $result['paymentDetails'] = $details;
2783 }
2784
2785 // Sometimes we get the state at top level, sometimes in paymentDetails.
2786 $state = $result['state'] ?? false;
2787
2788 // Now, if we don't have payment details, we should have a dead session or something like it. If we do, we can cretae
2789 // a normalized result. IOK 2023-12-13
2790 if (isset($result['paymentDetails'])) {
2791 $details = $result['paymentDetails'];
2792 $state = $state ?: $details['state'];
2793 $result['state'] = $state;
2794 $details['state'] = $state;
2795
2796 # IOK 2022-01-19 for this, the docs and experience does not agree, so check both
2797 $aggregate = (isset($details['transactionAggregate'])) ? $details['transactionAggregate'] : $details['aggregate'];
2798
2799 // if 'AUTHORISED' and directCapture is set and true, set to SALE which will set the order to complete
2800 // IOK 2025-08-12: This is never true anymore - directCapture is never set and the SALE state does not seem to exist.
2801 // this was an extra feature for merchants with special products however, so keep the logic just in case.
2802 if (($result['state'] == 'AUTHORISED' || $result['state'] == "AUTHORIZED") && isset($result['directCapture']) && $result['directCapture']) {
2803 $result['state'] = "SALE";
2804 }
2805
2806 # the transactionSummary used to contain the information now present in 'aggregate', so map it back for compatibility.
2807 $transactionSummary = array();
2808 // Always NOK at this point, but we also don't care because the order has the currency
2809 // IOK 2024-03-22 Now supports other currencies, but we still don't care.
2810 $transactionSummary['capturedAmount'] = isset($aggregate['capturedAmount']) ? $aggregate['capturedAmount']['value'] : 0;
2811 $transactionSummary['refundedAmount'] = isset($aggregate['refundedAmount']) ? $aggregate['refundedAmount']['value'] : 0;
2812 $transactionSummary['cancelledAmount'] =isset($aggregate['cancelledAmount']) ? $aggregate['cancelledAmount']['value'] : 0;
2813 $transactionSummary['authorizedAmount'] =isset($aggregate['authorizedAmount']) ? $aggregate['authorizedAmount']['value'] : 0;
2814 $transactionSummary['remainingAmountToCapture'] = $transactionSummary['authorizedAmount'] - $transactionSummary['cancelledAmount'] - $transactionSummary['capturedAmount'];
2815 $transactionSummary['remainingAmountToRefund'] = $transactionSummary['capturedAmount'] - $transactionSummary['refundedAmount'];
2816 // now also reducing remainingAmmountToCancel with cancelledAmount PMB 2024-11-21
2817 $transactionSummary['remainingAmountToCancel'] = $transactionSummary['authorizedAmount'] - $transactionSummary['capturedAmount'] - $transactionSummary['cancelledAmount'];
2818
2819 $result['transactionSummary'] = $transactionSummary;
2820 }
2821 // After this, the result will contain a 'state' which used to be a 'status' - map back for compatibility.
2822 // The reason for the method is that in ecom v2 we needed to calculate this from the transaction history. IOK 2025-08-12
2823 $result['status'] = $this->get_payment_status_from_payment_details($result);
2824
2825 // No longer used; was used in later versions of ecom to deduce order status. Added for typewise compatibility.
2826 $result['transactionLogHistory'] = array();
2827 // The corresponding epayment log. Filled on-demand by debugging code.
2828 $result['epaymentLog'] = null;
2829
2830 return $result;
2831 }
2832
2833 // Vipps Checkout v3 does *not* provide userDetails. Vipps Checkout v2 and epayment *does*. But Checkout additionally allows
2834 // for anonymous purchases, in which case there is *no* user details. In this case we provide an anonymous user so we can actually create an order.
2835 // To handle this, we provide this utility that ensures we have userDetails no matter the input. For this we use the anonymous filters and "billingDetails" if present
2836 // if not, we use shippingDetails. IOK 2023-01-10
2837 // Also, epayment uses mobileNumber and checkout uses phoneNumber, so normalize.
2838 public function ensure_userDetails($vippsdata, $order) {
2839 $userDetails = [];
2840
2841 // If we have userDetails, use it (ecom API with user data requested - Express Checkout
2842 if (isset($vippsdata['userDetails'])) {
2843 $userDetails = $vippsdata['userDetails'];
2844 // This is the verified user information from the app - this is always the customer for Express Checkout, but not for Checkout IOK 2025-08-12
2845 $sub = "";
2846 if (isset($vippsdata['profile']) && isset($vippsdata['profile']['sub'])) {
2847 $sub = $vippsdata['profile']['sub'];
2848 }
2849 $userDetails['sub'] = $sub;
2850
2851 } else if (isset($vippsdata['billingDetails'])) {
2852 // Otherwise this is now Checkout, and we want to get it from billingDetails preferrably
2853 $addr = $vippsdata['billingDetails'];
2854 $phone = $addr['phoneNumber'];
2855 $userDetails = array(
2856 'firstName' => $addr['firstName'],
2857 'lastName' => $addr['lastName'],
2858 'email' => $addr['email'],
2859 'phoneNumber' => $phone,
2860 // This is the verified user information from the app - this is always the customer for Express Checkout, but not for Checkout IOK 2025-08-12
2861 'sub' => ""
2862 );
2863
2864 // Or use shippingDetails - this is still Checkout
2865 } else if (isset($vippsdata['shippingDetails'])) {
2866 $addr = $vippsdata['shippingDetails'];
2867 $phone = $addr['phoneNumber'];
2868 $userDetails = array(
2869 'firstName' => $addr['firstName'],
2870 'lastName' => $addr['lastName'],
2871 'email' => $addr['email'],
2872 'phoneNumber' => $phone,
2873 // This is the verified user information from the app - this is always the customer for Express Checkout, but not for Checkout IOK 2025-08-12
2874 'sub' => ""
2875 );
2876
2877 // And it is possible to not require user details in Checkout at all (or if not using express)
2878 } else {
2879 $userDetails = array(
2880
2881 'firstName' => apply_filters('woo_vipps_anon_customer_first_name', __('Anonymous customer', 'woo-vipps'), $order),
2882 'lastName' => apply_filters('woo_vipps_anon_customer_last_name', "", $order),
2883 'email' => apply_filters('woo_vipps_anon_customer_email', '', $order),
2884 'phoneNumber' => apply_filters('woo_vipps_anon_customer_phone_number', '', $order),
2885 'sub' => ""
2886 );
2887 }
2888
2889 //Normalize the result
2890 $phone = $userDetails['phoneNumber'] ?? ($userDetails['mobileNumber'] ?? "");
2891 $userDetails['phoneNumber'] = $phone;
2892 $userDetails['mobileNumber'] = $phone;
2893
2894
2895 // No longer used, but try to provide it for backwards compatibility
2896 $userDetails['userId'] = $userDetails['phoneNumber'];
2897 // This is possible to get iff we have the 'sub', unfortunately it is not passed directly in several of the apis. IOK 2025-08-12
2898 $userDetails['email_verified'] = ($userDetails['email_verified'] ?? false);
2899
2900 $vippsdata['userDetails'] = $userDetails;
2901
2902 return $vippsdata;
2903 }
2904
2905 // Update the order with Vipps payment details, either passed or called using the API.
2906 public function update_vipps_payment_details ($order, $details = null) {
2907 if (!$details) {
2908 try {
2909 $details = $this->get_payment_details($order);
2910 } catch (Exception $e) {
2911 // We'll try but if we fail, that's too bad. IOK 2026-03-18. No recovery is really possible here.
2912 $this->log(sprintf(__("Could not get payment results for order %1\$s", 'woo-vipps'), $order->get_id()));
2913 $this->log($e->getMessage());
2914 }
2915 }
2916
2917 if ($details) {
2918 if (isset($details['transactionSummary'])) {
2919 $transactionSummary= $details['transactionSummary'];
2920 $order->update_meta_data('_vipps_status',$details['status']);
2921 $order->update_meta_data('_vipps_captured',$transactionSummary['capturedAmount']);
2922 $order->update_meta_data('_vipps_refunded',$transactionSummary['refundedAmount']);
2923 $order->update_meta_data('_vipps_capture_remaining',$transactionSummary['remainingAmountToCapture']);
2924 $order->update_meta_data('_vipps_refund_remaining',$transactionSummary['remainingAmountToRefund']);
2925 if (isset($details['transactionSummary']['cancelledAmount'])) {
2926 $order->update_meta_data('_vipps_cancelled',$transactionSummary['cancelledAmount']);
2927 $order->update_meta_data('_vipps_cancel_remaining',$transactionSummary['remainingAmountToCancel']);
2928 }
2929 }
2930 // This is the epayment API - IOK 2022-01-20
2931 if (isset($details['paymentDetails'])) {
2932 $d = $details['paymentDetails'];
2933 if (isset($d['amount'])) {
2934 $order->update_meta_data('_vipps_amount', $d['amount']['value']);
2935 }
2936 $aggregate = (isset($d['transactionAggregate'])) ? $d['transactionAggregate'] : $d['aggregate'];
2937 if ($aggregate) {
2938 // capturedAmount, refundedAmount, authorizedAmount, cancelledAmount
2939 if (isset($aggregate['authorizedAmount'])) {
2940 $order->update_meta_data('_vipps_amount', $aggregate['authorizedAmount']['value']);
2941 }
2942 }
2943 }
2944 // Modify payment method name if neccessary
2945 if (isset($details['paymentMethod']) && $details['paymentMethod'] == 'Card') {
2946 if ($order->get_meta('_vipps_checkout')) {
2947 $order->set_payment_method_title(sprintf(__('Credit Card / %1$s', 'woo-vipps'), Vipps::CheckoutName()));
2948 }
2949 }
2950 if (isset($details['paymentMethod']) && $details['paymentMethod'] == 'BankTransfer') {
2951 if ($order->get_meta('_vipps_checkout')) {
2952 $order->set_payment_method_title(sprintf(__('Bank Transfer/ %1$s', 'woo-vipps'), Vipps::CheckoutName()));
2953 $order->update_meta_data('_vipps_api', 'banktransfer');
2954 }
2955 }
2956 $order->save();
2957 }
2958 return $order;
2959 }
2960
2961 // IOK 2021-01-20 from March 2021 the order_status interface is removed; so we now need to interpret the payment history to find
2962 // out the order status.
2963 // IOK 2022-01-19 With the epayment API on the other hand, the payment status is back as 'state'.
2964 // IOK 2025-08-12 Except for certain payment methods in Checkout. So.
2965 // IOK 2025-08-12 Removing the ecom support now, so all code will use 'state', as normalized by normalizePaymentDetails
2966 public function get_payment_status_from_payment_details($details) {
2967 $status = $details['state'];
2968 return $status;
2969 }
2970
2971 // Get the order status as defined by Vipps; if you have the payment details already, pass them. Will modify the order. IOK 2021-01-20
2972 public function get_vipps_order_status($order, $statusdata=null) {
2973 $vippsorderid = $order->get_meta('_vipps_orderid');
2974 if (!$vippsorderid) {
2975 $msg = sprintf(__('Could not get %1$s order status - it has no %1$s Order Id. Must cancel.','woo-vipps'), $this->get_payment_method_name());
2976 $this->log($msg,'error');
2977 return 'CANCEL';
2978 }
2979 if (!$statusdata) {
2980 try {
2981 $statusdata = $this->get_payment_details($order);
2982 } catch (TemporaryVippsApiException $e) {
2983 $this->log(sprintf(__('Could not get %1$s order status for order id:', 'woo-vipps'), Vipps::CompanyName()) . ' ' . $order->get_id() . "\n" .$e->getMessage(),'error');
2984 return null;
2985 } catch (VippsAPIException $e) {
2986 $msg = sprintf(__('Could not get %1$s order status','woo-vipps'), $this->get_payment_method_name()) . ' ' . $e->getMessage();
2987 $this->log($msg,'error');
2988 if (intval($e->responsecode) == 402 || intval($e->responsecode) == 404) {
2989 $this->log(sprintf(__('Order does not exist at %1$s - cancelling','woo-vipps'), $this->get_payment_method_name()) . ' ' . $order->get_id(), 'warning');
2990 return 'CANCEL';
2991 }
2992 } catch (Exception $e) {
2993 $msg = sprintf(__('Could not get %1$s order status for order id:','woo-vipps'), $this->get_payment_method_name()) . ' ' . $order->get_id() . "\n" . $e->getMessage();
2994 $this->log($msg,'error');
2995 return null;
2996 }
2997 }
2998 if (!$statusdata) return null;
2999
3000 $vippsstatus = isset($statusdata['status']) ? $statusdata['status'] : "";
3001
3002 if (!$vippsstatus) {
3003 $this->log("Unknown Vipps Status: " . print_r($statusdata, true), 'debug');
3004 }
3005 return $vippsstatus;
3006 }
3007
3008 // The various Vipps APIs return address info with various keys and formats, so we need to translate all of them
3009 // to a canonical format.
3010 public function canonicalize_vipps_address($address, $user) {
3011 // eCom has user info only in the user struct
3012 $firstname = $user['firstName'];
3013 $lastname = $user['lastName'];
3014 $email = $user['email'];
3015
3016 // Get the passed phone number from checkout or express, which could be in any number of slots IOK 2025-
3017 $phone = isset($user['mobileNumber']) ? $user['mobileNumber'] : "";
3018 if (isset($user['phoneNumber'])) $phone = $user['phoneNumber'];
3019 if (!$phone && ($address['phoneNumber'] ?? "")) $phone = $address['phoneNumber'];
3020 if (!$phone && ($address['mobileNumber'] ?? "")) $phone = $address['mobileNumber'];
3021
3022 // Phone number transformations - the format Vipps Mobilepay uses is often not what merchants expect or need
3023 // NOTE: as of writing this, the checkout+expresscheckout expected format is '{countrycode}{phonenr}', so we assume this. LP 2025-12-29
3024 $phone_transformation = $this->get_option('checkout_phone_transformation');
3025 switch($phone_transformation) {
3026 case 'ensure_plus':
3027 $phone = "+$phone";
3028 break;
3029 case 'strip_country_code':
3030 // We only support norway,denmark,swedish,finnish country codes as of now. LP 2025-12-29
3031 // We can't do these replaces in sequence, because e.g. +47 46 12 34 56 would become 0 12 34 56 instead of the correct 46 12 34 56. LP 2026-02-19
3032 if (preg_match('!^(45|47)!', $phone)) { // NO, DK
3033 $phone = preg_replace('!^(45|47)!', '', $phone);
3034 } else if (preg_match('!^(46|358)!', $phone)) { // SE, FI: leading zero for area codes is not used with country code, so add it back here. LP 2026-02-09
3035 $phone = preg_replace('!^(46|358)!', '0', $phone);
3036 }
3037 break;
3038 }
3039 $phone = apply_filters('woo_vipps_canonicalize_checkout_phone', $phone, $address, $user);
3040
3041 if (!isset($address['firstName']) or !$address['firstName']) {
3042 $address['firstName'] = $firstname;
3043 }
3044 if (!isset($address['lastName']) or !$address['lastName']) {
3045 $address['lastName'] = $lastname;
3046 }
3047 // checkout uses phonenumber
3048 if (!isset($address['phoneNumber']) or !$address['phoneNumber']) {
3049 $address['phoneNumber'] = $phone;
3050 }
3051 // epayment uses mobileNumber
3052 if (!isset($address['mobileNumber']) or !$address['mobileNumber']) {
3053 $address['mobileNumber'] = $phone;
3054 }
3055 if (!isset($address['email']) or !$address['email']) {
3056 $address['email'] = $email;
3057 }
3058
3059 // epayment
3060 $addressline1 = isset($address['addressLine1']) ? $address['addressLine1'] : "";
3061 $addressline2 = isset($address['addressLine2']) ? $address['addressLine2'] : "";
3062 // checkout
3063 if (isset($address['streetAddress'])) {
3064 $addressline1 = $address['streetAddress'];
3065 }
3066 if (isset($address['street_address'])) { // From the userinfo api
3067 $addressline1 = $address['street_address'];
3068 }
3069 if ($addressline1 == $addressline2) $addressline2 = '';
3070 $address['addressLine1'] = $addressline1; // epayment
3071 $address['addressline2'] = $addressline2;
3072 $address['streetAddress'] = $addressline1; // Checkout
3073
3074 $city = "";
3075 if (isset($address['city'])) { // checkout and epayment
3076 $city = $address['city'];
3077 } elseif (isset($address['region'])) { // ecom
3078 $city = $address['region'];
3079 }
3080 $address['city'] = $city;
3081 $address['region'] = $city;
3082
3083 $postcode= "";
3084 if (isset($address['postCode'])) {
3085 $postcode= $address['postCode']; // epayment
3086 } elseif (isset($address['postalCode'])){
3087 $postcode= $address['postalCode']; // checkout
3088 } elseif (isset($address['postal_code'])) {
3089 $postcode= $address['postal_code']; // userinfo
3090 }
3091 $address['postCode'] = $postcode; // epayment
3092 $address['zipCode'] = $postcode; // ecom
3093 $address['postalCode'] = $postcode; // checkout
3094
3095 // Allow users to modify the address to e.g. handle phone numbers differently IOK 2025-01-20
3096 // note: added separate filter for phone number 'woo_vipps_canonicalize_checkout_phone' because of the different uses, keys etc. LP 2025-12-29
3097 return apply_filters('woo_vipps_canonicalize_checkout_address', $address, $user);
3098 }
3099
3100 public function set_order_shipping_details($order,$shipping, $user, $billing=false, $alldata=null, $assigncustomer=true) {
3101 global $Vipps;
3102 $done = $order->get_meta('_vipps_shipping_set');
3103 if ($done) return true;
3104 $order->update_meta_data('_vipps_shipping_set', true);
3105 $order->save(); // Limit the window for double shipping as much as possible.
3106
3107 // This is for handling a custom consent checkbox for mailing lists etc. IOK 2023-02-09
3108 if ($alldata && isset($alldata['customConsentProvided'])) {
3109 $order->update_meta_data('_vipps_custom_consent_provided', intval($alldata['customConsentProvided']));
3110 }
3111
3112
3113 // We get different values from the normal callback and the Checkout callback, so be prepared for several results. IOK 2021-09-02
3114 // IOK VERIFY this should be normalized now or soon at any rate
3115 $address = isset($shipping['address']) ? $shipping['address'] : $shipping;;
3116
3117 // Sometimes we get an empty shipping address! In this case, fill the details with the billing address.
3118 // This only happens with ecommerce though, so we need to check before canonicalizing. IOK 2022-03-21
3119 // billing is only present in Checkout, which uses phoneNumber, streetAddress, postalCode etc.
3120 $shipping_empty = true;
3121 if ($billing && array_key_exists('streetAddress', $address)) {
3122 $keys = ['firstName', 'lastName', 'email', 'phoneNumber', 'streetAddress', 'postalCode', 'city', 'country'];
3123 foreach ($keys as $key) {
3124 if (isset($address[$key]) && $address[$key]) {
3125 $shipping_empty = false; break;
3126 }
3127 }
3128 if ($shipping_empty) {
3129 foreach ($keys as $key) $address[$key] = $billing[$key];
3130 }
3131 }
3132
3133 if (!$billing) $billing = $address;
3134 $address = $this->canonicalize_vipps_address($address, $user);
3135 $billing = $this->canonicalize_vipps_address($billing, $user);
3136
3137 # Billing.
3138 $order->set_billing_email($billing['email']);
3139 $order->set_billing_phone($billing['mobileNumber']);
3140 $order->set_billing_first_name($billing['firstName']);
3141 $order->set_billing_last_name($billing['lastName']);
3142 $order->set_billing_address_1($billing['addressLine1']);
3143 if ($billing['addressLine2'] ?? false) $order->set_billing_address_2($billing['addressLine2']);
3144 $order->set_billing_city($billing['city'] ?? "");
3145 $order->set_billing_postcode($billing['postCode'] ?? "");
3146 $order->set_billing_country($billing['country'] ?? "");
3147
3148 # Shipping.
3149 $order->set_shipping_first_name($address['firstName']);
3150 $order->set_shipping_last_name($address['lastName']);
3151 if (version_compare(WC_VERSION, '5.6.0', '>=')) {
3152 $order->set_shipping_phone($address['mobileNumber']);
3153 }
3154 $order->set_shipping_address_1($address['addressLine1']);
3155 if ($address['addressLine2'] ?? "") $order->set_shipping_address_2($address['addressLine2']);
3156 $order->set_shipping_city($address['city']);
3157 $order->set_shipping_postcode($address['postCode']);
3158 $order->set_shipping_country($address['country']);
3159
3160 $order->save();
3161
3162 // This is *essential* to get VAT calculated correctly. That calculation uses the customer, which uses the session, which we will have restored at this point.IOK 2019-10-25
3163 if (WC()->customer) {
3164 WC()->customer->set_billing_email($billing['email']);
3165 WC()->customer->set_email($billing['email']);
3166
3167 $country = $billing['country'] ?? ($address['country'] ?? "");
3168 WC()->customer->set_billing_location($country,'',$billing['postalCode'],$billing['region']);
3169 WC()->customer->set_shipping_location($address['country'],'',$address['postalCode'],$address['region']);
3170 }
3171
3172 // We may need the order total early on, so start with that
3173 $ordertotal = $order->get_total() ?: 0;
3174
3175 $vipps_reserved = $alldata['paymentDetails']['amount']['value'] ?? null;
3176 // i dont expect order total to ever be greater than vipps reserved total here, so i dont use abs(). LP 2026-01-28
3177 $diff_reserved_ordertotal = is_numeric($vipps_reserved) ? ($vipps_reserved / 100 - $ordertotal) : 0;
3178
3179 // Now do shipping, if it exists IOK 2021-09-02
3180 $method = isset($shipping['shippingMethodId']) ? $shipping['shippingMethodId'] : false;
3181
3182 // We will add a shipping rate either if there has been passed a shipping method; or if this
3183 // is an order that needs shipping and the amount reserved at vipps is greater than the order total
3184 // (with a bit of tolerance for rounding errors). If we *don't* have a shipping method but we know
3185 // we need a shipping rate; this is an error condition that the merchant needs to resolve. We'll add a fake
3186 // 'Unknown' rate to ensure we capture the right amount and add this fact to the order log. Code by LP, comment by IOK 2026-01-28
3187 $needs_shipping = $method || $order->get_meta('_vipps_needs_shipping');
3188 $tol = 0.01;
3189 $has_shipping = $method || $diff_reserved_ordertotal > $tol;
3190
3191 if ($needs_shipping && $has_shipping) {
3192 $shipping_rate=null;
3193 $option_table = [];
3194
3195 // Try to find the shipping rate. LP 2026-01-28
3196 if ($method) {
3197 if (substr($method,0,1) != '$') {
3198 // This is the old way of adding shipping. We should probably deprecate this sometime soon. IOK 2026-01-28
3199 $shipping_rate = $this->get_legacy_express_checkout_shipping_rate($shipping);
3200 } else {
3201 // Strip suffixes if we have several Express rates mapping to the same Woo rate (eg. for Posten). IOK 2025-05-04
3202 $matches = [];
3203 preg_match("!^(?P<key>[^:]+):?(?P<option_index>.+)?$!", $method, $matches);
3204 $key = $matches['key'] ?? "";
3205 $option_index = intval(trim($matches['option_index'] ?? "")); // 0 is never an index
3206 $shipping_table = $order->get_meta('_vipps_express_checkout_shipping_method_table');
3207 $is_base64 = $shipping_table ? ( $shipping_table['_is_base64'] ?? false) : false;
3208
3209 if (is_array($shipping_table) && isset($shipping_table[$key])) {
3210 $decoded = $is_base64 ? @base64_decode($shipping_table[$key]) : $shipping_table[$key];
3211 $shipping_rate = $decoded ? @unserialize($decoded) : null;
3212 if (!$shipping_rate) {
3213 $this->log(sprintf(__("%1\$s: Could not deserialize the chosen shipping method %2\$s for order %3\$d", 'woo-vipps'), Vipps::ExpressCheckoutName(), $method, $order->get_id()), 'error');
3214 $this->log(sprintf(__("Serialized data was %1\$s", 'woo-vipps'), $decoded), 'error');
3215 } else {
3216 // Special-case the Woo pickup location methods. IOK 2026-01-28
3217 if ($option_index) {
3218 $meta = $shipping_rate->get_meta_data();
3219 $option_table = $meta['_vipps_pickupPoints'] ?? [];
3220 // force string table IOK 2025-08-15
3221 $point = $option_table["i".$option_index] ?? "";
3222 if ($point) {
3223 $shipping['pickupPoint'] = $point;
3224 }
3225 $shipping_rate->add_meta_data('_vipps_pickupPoints', null);
3226 }
3227 // Empty this when done, but not if there was an error - let the merchant be able to debug. IOK 2020-02-14
3228 $order->update_meta_data('_vipps_express_checkout_shipping_method_table', null);
3229 }
3230 }
3231 }
3232
3233 // Possible extra metadata from Vipps Checkout IOK 2023-01-17
3234 // Store in the order, but also in the shipping rate so it will be visible in the order screen
3235 // along with the shipping ragte
3236 if (isset($shipping['pickupPoint'])) {
3237 $order->update_meta_data('vipps_checkout_pickupPoint', $shipping['pickupPoint']);
3238 if ($shipping_rate) {
3239 $pp = $shipping['pickupPoint'];
3240 $addr = [];
3241 foreach(['address', 'postalCode', 'city', 'country'] as $key) {
3242 $v = trim($pp[$key]);
3243 if (!empty($v)) $addr[] = trim($pp[$key]);
3244 }
3245
3246 $shipping_rate->add_meta_data('pickup_location', $pp['name']);
3247 $shipping_rate->add_meta_data('pickup_address', join(", ", $addr));
3248 $shipping_rate->add_meta_data('pickup_details', ""); // Not supported by the API unfortunately. IOK 2025-06-07
3249 }
3250 }
3251 if (isset($shipping['timeslot'])) {
3252 $order->update_meta_data('vipps_checkout_timeslot', $shipping['timeslot']);
3253 if ($shipping_rate) {
3254 $pp = $shipping['timeslot'];
3255 $slot = "";
3256 $slot .= sprintf(__("Date: %s", 'woo-vipps'), ($pp['date'] ?? ""));
3257 $slot .= " " . sprintf(__("Start: %s", 'woo-vipps'), ($pp['start'] ?? ""));
3258 $slot .= " " . sprintf(__("End: %s", 'woo-vipps'), ($pp['end'] ?? ""));
3259 $shipping_rate->add_meta_data('vipps_delivery_timeslot', $slot);
3260 $shipping_rate->add_meta_data('vipps_delivery_timeslot_id', $pp['id']);
3261 }
3262 }
3263 }
3264
3265 // We know we need a shipping rate, and what its price has to be, so ensure we have one by making one up if missing. LP 2026-01-28
3266 if (!$shipping_rate) {
3267 $shipping_rate = new WC_Shipping_Rate(
3268 'UNKNOWN',
3269 sprintf(__('Unknown shipping: please check the shipping details at %1$s', 'woo-vipps'), Vipps::CompanyName()),
3270 $diff_reserved_ordertotal,
3271 [],
3272 'UNKNOWN',
3273 0,
3274 );
3275 $shipping_rate = apply_filters('woo_vipps_unknown_shipping_rate_dummy', $shipping_rate, $order);
3276
3277 // Add an error log for the merchants to quote to us.
3278 $msg = sprintf(__("%1\$s Could not retrieve any shipping rate for this order, with method %2\$s",'woo-vipps'), $this->get_payment_method_name(), $method) . " " . $order->get_id();
3279 $order->add_order_note($msg);
3280 $this->log($msg, 'warning');
3281 }
3282
3283 $shipping_rate = apply_filters('woo_vipps_express_checkout_final_shipping_rate', $shipping_rate, $order, $shipping);
3284
3285 $total_shipping = 0;
3286 $total_shipping_tax = 0;
3287 $it = null;
3288
3289 // Recover the Shipping Method class
3290 $methods_classes = WC()->shipping->get_shipping_method_class_names();
3291 $methodclass = $methods_classes[$shipping_rate->get_method_id()] ?? null;
3292 $shipping_method = $methodclass ? new $methodclass($shipping_rate->get_instance_id()) : null;
3293 $is_vipps_checkout_shipping = $shipping_method && is_a($shipping_method, 'VippsCheckout_Shipping_Method');
3294
3295 // Some Vipps Checkout-specific shipping methods calculate the cost in the Vipps window.
3296 if ($is_vipps_checkout_shipping && $shipping_method->dynamic_cost) {
3297 $vippsamount = intval($order->get_meta('_vipps_amount'));
3298 $shipping_tax_rate = floatval($order->get_meta('_vipps_shipping_tax_rates'));
3299 $compareamount = $ordertotal * 100;
3300 $amountdiff = $vippsamount-$compareamount; // this is the *actual* shipping cost at this point
3301 $diffnotax = ($amountdiff / (100 + $shipping_tax_rate)); // Adjusted to correct values actually
3302 $difftax = WC_Tax::round($amountdiff/100 - $diffnotax);
3303 $actual = $amountdiff/100 - $difftax;
3304
3305 $shipping_rate->set_cost($actual);
3306 $shipping_rate->set_taxes( [ 1 => $difftax] );
3307 }
3308
3309 $it = new WC_Order_Item_Shipping();
3310 $it->set_shipping_rate($shipping_rate);
3311 $it->set_order_id( $order->get_id() );
3312 // This should actually have been done by the "set_shipping_rate" call above, but as of 3.9.2 at least, this does not work.
3313 // Therefore, do it manually/forcefully IOK 2020-02-17
3314 foreach($shipping_rate->get_meta_data() as $key => $value) {
3315 $it->add_meta_data($key,$value,true);
3316 }
3317 $it->save();
3318
3319 $order->add_item($it);
3320
3321 $total_shipping = $it->get_total() ?: 0;
3322 $total_shipping_tax = $it->get_total_tax() ?: 0;
3323
3324 // Try to avoid calculate_totals, because this will recalculate shipping _without checking if the rate
3325 // in question actually should use tax_. Therefore we will just add the pre-calculated values, so that the
3326 // value reserved at Vipps and the order total is the same. IOK 2022-10-03
3327 $order->set_shipping_total($total_shipping);
3328 $order->set_shipping_tax($total_shipping_tax);
3329
3330 $order->set_total($ordertotal + $total_shipping + $total_shipping_tax);
3331 $order->update_taxes(); // Necessary for the admin view only; does not recalculate order.
3332
3333 // Add an early hook for Vipps Checkout orders with special shipping methods
3334 $metadata = $shipping_rate->get_meta_data();
3335 if (isset($metadata['type'])) {
3336 do_action('woo_vipps_checkout_special_shipping_method', $order, $shipping_rate, $metadata['type']);
3337 }
3338
3339 $order->save();
3340 // NB: WE DO NOT CALL CALCULATE TOTALS!
3341 // THIS WILL CALCULATE SHIPPING FOR TAX IF THERE IS A TAX RATE FOR THE GIVEN AREA WITH THE 'shipping' PROPERTY CHECKED - EVEN IF THE SHIPPING RATE IT SELF IS NOT THUS CONFIGURED.
3342 // Same thing happens when using the "recalculate" button in the backend
3343 // This will *only* affect users that choose "No tax" for the shipping rates themselves, which is mostly just wrong, but we want to ensure consistency here since this is hard
3344 // to debug.
3345 // $order->calculate_totals(true);
3346 }
3347
3348
3349 // If we have the 'expresscreateuser' thing set to true, we will create or assign the order here, as it is the first-ish place where we can.
3350 // If possible and safe, user will be logged in before being sent to the thankyou screen. IOK 2020-10-09
3351 // Same thing for Vipps Checkout, mutatis mutandis. The function below returns false if no customer exists or gets created.
3352 $customer = false;
3353 if ($assigncustomer) {
3354 $customer = Vipps::instance()->express_checkout_get_vipps_customer($order);
3355 }
3356 if ($customer) {
3357 // This would have been used to ensure that we 'enroll' the users the same way as in the Login plugin. Unfortunately, the userId from express checkout isn't
3358 // the same as the 'sub' we get in Login so that must be a future feature. IOK 2020-10-09
3359 // IOK 2025-08-13 we do get the 'sub' now, at least for express checkout. For Checkout, we would have to compare the email of the user with the verified email
3360 // after calling get_userinfo, so we'll leave that be.
3361 if (class_exists('VippsWooLogin') && $customer && !is_wp_error($customer) && !get_user_meta($customer->get_id(), '_vipps_phone',true)) {
3362 update_user_meta($customer->get_id(), '_vipps_phone', $billing['phoneNumber']);
3363 if (isset($user['sub'])) {
3364 $userid = $customer->get_id();
3365 update_user_meta($userid, '_vipps_id', $user['sub']);
3366 update_user_meta($userid, '_vipps_just_connected', 1);
3367 }
3368 }
3369
3370 // Ensure we get any changes made to the order, as it will be re-saved later
3371 $order = wc_get_order($order->get_id());
3372 }
3373
3374 do_action('woo_vipps_set_order_shipping_details', $order, $shipping, $user);
3375 $order->save(); // I'm not sure why this is neccessary - but be sure.
3376
3377 }
3378
3379 // Previously, shipping rates were added by creating them here with metadata packed into the shippingMethodId. This is from 1.4.0 only
3380 // used when the woo_vipps_shipping_methods filter has been overriden by the merchant. IOK 2020-02-14
3381 private function get_legacy_express_checkout_shipping_rate($shipping) {
3382 $method = $shipping['shippingMethodId'];
3383 list ($rate,$tax) = explode(";",$method);
3384 // The method ID is encoded in the rate ID but we apparently must still send it to the WC_Shipping_Rate constructor. IOK 2018-06-01
3385 // Unfortunately, Vipps won't accept long enought 'shipingMethodId' for us to actually stash all the information we need. IOK 2018-06-01
3386 list ($method,$product) = explode(":",$rate);
3387 $tax = wc_format_decimal($tax,'');
3388 $label = $shipping['shippingMethod'];
3389 $cost = wc_format_decimal($shipping['shippingCost'],''); // This is inclusive of tax
3390 $costExTax= wc_format_decimal($cost-$tax,'');
3391 $shipping_rate = new WC_Shipping_Rate($rate,$label,$costExTax,array(array('total'=>$tax)), $method, $product);
3392 $shipping_rate = apply_filters('woo_vipps_express_checkout_shipping_rate',$shipping_rate,$costExTax,$tax,$method,$product);
3393 return $shipping_rate;
3394 }
3395
3396 // Used by both callback_check_order_status and handle_callback - sets the neccessary order metadata after a successful (or not vipps transaction). IOK 2025-08-13
3397 public function order_set_transaction_metadata($order, $transaction) {
3398 // Set Vipps metadata as early as possible
3399 $vippsstamp = strtotime($transaction['timeStamp']);
3400 $vippsamount = $transaction['amount'] ?? '';
3401 $vippscurrency= $transaction['currency'] ?? '';
3402 $vippsstatus = $transaction['status'];
3403
3404 $order->update_meta_data('_vipps_callback_timestamp',$vippsstamp);
3405 $order->update_meta_data('_vipps_amount',$vippsamount);
3406 $order->update_meta_data('_vipps_currency',$vippscurrency);
3407 $order->update_meta_data('_vipps_status',$vippsstatus);
3408
3409 // Checkout only, modify payment method name if neccessary
3410 if ($transaction['paymentmethod'] == 'Card') {
3411 if ($order->get_meta('_vipps_checkout')) {
3412 $order->set_payment_method_title(sprintf(__('Credit Card / %1$s', 'woo-vipps'), Vipps::CheckoutName()));
3413 }
3414 }
3415 // Checkout only, banktransfers are handled specially so note that
3416 if ($transaction['paymentmethod'] == 'BankTransfer') {
3417 $order->set_payment_method_title(sprintf(__('Bank Transfer/ %1$s', 'woo-vipps'), Vipps::CheckoutName()));
3418 $order->update_meta_data('_vipps_api', 'banktransfer');
3419 }
3420 }
3421
3422 // Handle the callback from Vipps eCom.
3423 public function handle_callback($result, $order, $ischeckout=false, $iswebhook=false) {
3424 global $Vipps;
3425
3426 $vippsorderid = $result['orderId'];
3427 $merchant= $result['merchantSerialNumber'];
3428
3429 $keyset = $this->get_keyset();
3430 $me = array_keys($keyset);
3431
3432 if (!in_array($merchant, $me)) {
3433 $this->log(sprintf(__("%1\$s callback with wrong merchantSerialNumber - might be forged",'woo-vipps'), $this->get_payment_method_name()) . " " . $order->get_id(), 'warning');
3434 return false;
3435 }
3436
3437 if (!$order) {
3438 $this->log(sprintf(__("%1\$s callback for unknown order",'woo-vipps'), $this->get_payment_method_name()) . " " . $order->get_id(), 'warning');
3439 return false;
3440 }
3441 $orderid = $order->get_id();
3442 // We may need to use poll to get data, depending on the content passed.
3443 $express = $order->get_meta('_vipps_express_checkout');
3444 $checkout_session = $order->get_meta('_vipps_checkout_session');
3445
3446 if ($vippsorderid != $order->get_meta('_vipps_orderid')) {
3447 $this->log(sprintf(__("Wrong %1\$s Orderid - possibly an attempt to fake a callback ", 'woo-vipps'), Vipps::CompanyName()), 'warning');
3448 clean_post_cache($order->get_id());
3449 exit();
3450 }
3451
3452 $errorInfo = $result['errorInfo'] ?? '';
3453 if ($errorInfo) {
3454 $this->log(sprintf(__("Message in callback from %1\$s for order",'woo-vipps'), $this->get_payment_method_name()) . ' ' . $orderid . ' ' . $errorInfo['errorMessage'],'error');
3455 $order->add_order_note(sprintf(__("Message from %1\$s: %2\$s",'woo-vipps'), $this->get_payment_method_name(), $errorInfo['errorMessage']));
3456 }
3457
3458 // The payment details field is passed in Checkout, not in Express, but none of them are complete, so we fill out the values
3459 // depending on which one we are IOK 2025-08-13
3460 $details = [];
3461 // Checkout has this as a field, containing *some* of the neccessary data
3462 if (isset($result['paymentDetails'])) {
3463 // Checkout. The sesssion states are # "SessionCreated" "PaymentInitiated" "SessionExpired" "PaymentSuccessful" "PaymentTerminated"
3464 // -- we should only get callbacks for successful sessions actually.
3465 $details = $result['paymentDetails'];
3466 $result['state'] = $result['sessionState'] == 'PaymentSuccessful' ? 'AUTHORIZED' : ($result['sessionState'] == 'PaymentTerminated' ? 'TERMINATED' : 'CREATED');
3467 $details['state'] = $result['state'];
3468 $details['paymentMethod'] = $result['paymentMethod'];
3469 } else {
3470 // This should be an ecom callback; which we need to add a lot of data for to get a valid "paymentDetails".
3471 $details = [];
3472 $result['state'] = $result['name']; // The name of the callback - which should be AUTHORIZED, TERMINATED etc
3473 $details['state'] = $result['name'];
3474 $details['amount'] = $result['amount']; // currency, value
3475 $details['paymentMethod'] = 'epayment';
3476 $currency = $details['amount']['currency'];
3477 $nothing = [ 'currency' => $currency, 'value' => 0];
3478 }
3479
3480 // For both callbacks, set 'aggregate'
3481 $currency = $details['amount']['currency'];
3482 $nothing = [ 'currency' => $currency, 'value' => 0];
3483 $aggregate = ['authorizedAmount' => $nothing, 'cancelledAmount' => $nothing, 'capturedAmount' => $nothing, 'refundedAmount' => $nothing];
3484 if ($details['state'] == 'AUTHORIZED') {
3485 $aggregate['authorizedAmount'] = $details['amount'];
3486 }
3487 $details['aggregate'] = $aggregate;
3488 $result['paymentDetails'] = $details;
3489
3490 $result = $this->normalizePaymentDetails($result);
3491 $details = $result['paymentDetails'];
3492
3493 $vippsstatus = $result['status']; // Will exist now, because of the normalization IOK 2025-08-13
3494 $newstatus = $this->interpret_vipps_order_status($vippsstatus);
3495
3496 // Extract order metadata from either Checkout or Epayment - set below IOK 2025-08-13
3497 $transaction = array();
3498 $stamp = ($result['timestamp'] ?? false) ? strtotime($result['timestamp']) : time();
3499 $transaction['timeStamp'] = date('Y-m-d H:i:s', $stamp);
3500 $transaction['amount'] = $details['amount']['value'];
3501 $transaction['currency'] = $details['amount']['currency'];
3502 $transaction['status'] = ($result['state'] ?? $details['state']);
3503 $transaction['paymentmethod'] = $details['paymentMethod'] ?? "";
3504
3505 if (!$transaction) {
3506 $this->log(sprintf(__("Anomalous callback from %1\$s, handle errors and clean up",'woo-vipps'), $this->get_payment_method_name()),'warning');
3507 clean_post_cache($order->get_id());
3508 return false;
3509 }
3510
3511 $order->add_order_note(sprintf(__('%1$s callback received','woo-vipps'), $this->get_payment_method_name()));
3512 do_action('woo_vipps_callback_received', $order, $result, $transaction);
3513
3514 $oldstatus = $order->get_status();
3515 if ($oldstatus != 'pending') {
3516 // Actually, we are ok with this order, abort the callback. IOK 2018-05-30
3517 clean_post_cache($order->get_id());
3518 return false;
3519 }
3520
3521 // If the callback is late, and we have called get order status, and this is in progress, we'll log it and just drop the callback.
3522 // We do this because neither Woo nor WP has locking, and it isn't feasible to implement one portably. So this reduces somewhat the likelihood of race conditions
3523 // when callbacks happen while we are polling for results. IOK 2018-05-30
3524 if (!$Vipps->lockOrder($order)) {
3525 clean_post_cache($order->get_id());
3526 return false;
3527 }
3528
3529 // Ensure we use the same session as for the original order from here on. IOK 2019-10-21
3530 // IOK 2023-07-18 but because of the race condition issue, we cannot guarantee that any changes
3531 // made to the session here will be saved. Sorry.
3532 $Vipps->callback_restore_session($orderid);
3533
3534 // Set Vipps metadata as early as possible
3535 $this->order_set_transaction_metadata($order, $transaction);
3536
3537 $this->log(sprintf(__("%1\$s callback: Handling order: ", 'woo-vipps'), Vipps::CompanyName()) . " " . $orderid, 'debug');
3538
3539
3540 // This order is ready to set order shipping details etc for IOK 2025-09-19
3541 $ready = false;
3542 if (in_array($newstatus, ['authorized', 'complete'])) {
3543 $ready = true;
3544 }
3545 if ($ready) {
3546 // Failsafe for rare bug when using Klarna Checkout with Vipps as an external payment method
3547 // IOK 2024-01-09 ensure this is called only when order is complete/authorized
3548 $this->reset_erroneous_payment_method($order);
3549 }
3550
3551 if ($ready && ($express || $ischeckout)) {
3552 // For Vipps Checkout version 3 there are no more userDetails, so we will add it, including defaults for anonymous purchases IOK 2023-01-10
3553 // This will also normalize userDetails, adding 'sub' where required and fields for backwards compatibility. 2025-08-12
3554 $result = $this->ensure_userDetails($result, $order);
3555
3556 // Some Express Checkout orders aren't really express checkout orders, but normal orders to which we have
3557 // added scope name, email, phoneNumber. The reason is that we don't care about the address. But then
3558 // we also get no user data in the callback, so we must replace the callback with a user info call. IOK 2023-03-10
3559 // IOK 2025-09-29: This is probably *no longer true* - we now almost certainly *always* get a userDetails field if
3560 // we have added a scope of any kind. This is therefore probably dead code.
3561 // This being dead code, we'll not try to handle errors gracefully here. IOK 2026-03-18
3562 if (!isset($result['userDetails'])) {
3563 // This also calls ensure_userDetails and normalizeShippingDetails - but NB: it could fail, so call only when neccessary.
3564 try {
3565 $details = $this->get_payment_details($order);
3566 $result = $details;
3567 } catch (Exception $e) {
3568 $this->log(sprintf(__("Could not get payment results for order %1\$s", 'woo-vipps'), $order->get_id()));
3569 $this->log($e->getMessage());
3570 }
3571 }
3572
3573 // Epayment Express Checkout is of course also significantly different from both the old Express and from Checkout in the formatting here. IOK 2025-08-12
3574 $result = $this->normalizeShippingDetails($result, $order);
3575
3576 // We should now always have shipping details.
3577 if (isset($result['shippingDetails'])) {
3578 $billing = isset($result['billingDetails']) ? $result['billingDetails'] : false;
3579 $this->set_order_shipping_details($order,$result['shippingDetails'], $result['userDetails'], $billing, $result);
3580 }
3581 }
3582
3583 // the only status we now care about is AUTHORIZED. Previously we had AUTHORISED and RESERVED and RESERVE as well. And SALE.
3584 if ($vippsstatus == 'AUTHORIZED') {
3585 $this->payment_complete($order);
3586 } else if ($vippsstatus == 'SALE') {
3587 // Direct capture needs special handling because most of the meta values we use are missing IOK 2019-02-26
3588 // Actually not supported anymore, but keep logic. IOK 2025-08-13
3589 $order->add_order_note(sprintf(__('Payment captured directly at %1$s', 'woo-vipps'), $this->get_payment_method_name()));
3590 $order->payment_complete();
3591 $this->update_vipps_payment_details($order);
3592 } else {
3593 // Not ok status; set to failed/cancelled
3594 $order_is_retryable = Vipps::order_is_vipps_retryable($order->get_id());
3595 $status_on_fail = $this->get_option('status_on_fail');
3596 $cancel_on_fail = apply_filters('woo_vipps_cancel_failed_orders', false, $order, $vippsstatus);
3597 if ($cancel_on_fail || !$order_is_retryable) {
3598 $status_on_fail = 'cancelled';
3599 }
3600 if (!in_array($status_on_fail, ['cancelled', 'failed'])) {
3601 /* translators: order status name. Cancelled is woocommerce status name */
3602 $this->log(__('Unsupported status for payment failure of \'%1$s\', falling back to cancelled.', 'woo-vipps'), 'warning');
3603 $status_on_fail = 'cancelled';
3604 }
3605
3606 /* translators: company name */
3607 $order->update_status($status_on_fail, sprintf(__('Callback: Payment cancelled at %1$s', 'woo-vipps'), Vipps::CompanyName()));
3608 }
3609
3610 $order->save();
3611 clean_post_cache($order->get_id());
3612
3613 // Restore the session again so that we aren't causing issues with the customer-return branch, which may have to update the session concurrently. IOK 2023-018
3614 $Vipps->callback_restore_session($orderid);
3615 $Vipps->unlockOrder($order);
3616
3617 // Create a signal file (if possible) so the confirm screen knows to check status IOK 2018-05-04
3618 try {
3619 $Vipps->createCallbackSignal($order,'ok');
3620 } catch (Exception $e) {
3621 // Could not create a signal file, but that's ok.
3622 }
3623
3624 // Signal that we in fact handled the order.
3625 return true;
3626 }
3627
3628 // Do the 'payment_complete' logic for non-SALE orders IOK 2020-09-22
3629 public function payment_complete($order,$transactionid='') {
3630 // Orders not needing processing can be autocaptured, so try to do so now.
3631 $autocapture = $this->maybe_complete_payment($order);
3632 if (!$autocapture) {
3633 add_filter('woocommerce_payment_complete_order_status',
3634 function ($status, $orderid, $order) {
3635 return $this->after_vipps_order_status($order);
3636 }, 99, 3);
3637 $order->add_order_note(sprintf(__('Payment authorized at %1$s', 'woo-vipps'), $this->get_payment_method_name()));
3638 }
3639 $order->payment_complete();
3640 }
3641
3642 // Hook run by Woo after order is complete (authorized or sale). We'll add receipt info etc here.
3643 public function order_payment_complete ($orderid) {
3644 $order = wc_get_order($orderid);
3645 if (!is_a($order, 'WC_Order')) return false;
3646 if (! Vipps::is_vipps_order($order)) return false;
3647
3648 $do_order_management = apply_filters('woo_vipps_order_management_on_payment_complete', true, $orderid);
3649 if (!$do_order_management) return;
3650
3651 // We do the actual order management call in a separate request which we call non-blocking to avoid it locking
3652 // up the users' session on return from the store. This won't work if your Wordpress doesn't support non-blocking calls,
3653 // so in this case, allow the user to set a longer timeout (5 seconds should be plenty.) IOK 2022-07-01
3654 // Yes, it will block until timeout even if non-blocking is set. IOK 2022-07-01
3655 $timeout = apply_filters('woo_vipps_asynch_timeout', 0.5);
3656 $data = [ 'action'=> 'woo_vipps_order_management','orderid'=>$orderid, 'orderkey' => $order->get_order_key() ];
3657 $args = array( "method" => "POST", "body"=>$data, "timeout"=>$timeout, "blocking" => false);
3658 $url = admin_url('admin-post.php');
3659 $asynch = wp_remote_request($url,$args);
3660 if (is_wp_error($asynch)) {
3661 $this->log(__("Error calling the Order Management API: %1\$s ", 'woo-vipps'), $asynch->get_error_message());
3662 }
3663 }
3664
3665 // The below actions *may* be long-running, and we can't be sure
3666 // they will happen at callback-time. Some user may be affected, even if using wp-cron.
3667 // We therefore set them up to be run at shutdown, as soon as payment complete is done
3668 public function payment_complete_at_shutdown ($orderid, $orderkey) {
3669 // Ensure consistent environment here
3670 global $Vipps;
3671 if (!$Vipps) $Vipps = Vipps::instance();
3672 $order = wc_get_order($orderid);
3673 if (!is_a($order, 'WC_Order')) {
3674 return false;
3675 }
3676 if (! Vipps::is_vipps_order($order)) return false;
3677 if ($order->get_order_key() != wc_clean($orderkey)) {
3678 return false;
3679 }
3680 try {
3681
3682 $sendreceipt = apply_filters('woo_vipps_send_receipt', ($this->get_option('sendreceipts') == 'yes'), $order);
3683 if ($sendreceipt) {
3684 $this->api->add_receipt($order);
3685 $this->order_add_vipps_categories($order);
3686 }
3687 do_action('woo_vipps_payment_complete_at_shutdown', $order, $this);
3688 } catch (Exception $e) {
3689 // This is/should be non-critical so just log it.
3690 $this->log(sprintf(__("Could not do all payment-complete actions on %1\$s order %2\$d: %3\$s ", 'woo-vipps'), Vipps::CompanyName(), $orderid, $e->etMessage()), "error");
3691 }
3692 }
3693
3694 // This is run on payment complete. Per default will it only add a link to the order confirmation page, but
3695 // the hook added should be used if selling tickets, bookings etc to add these to the Vipps app receipt; with images if desired (eg. QR images).
3696 public function order_add_vipps_categories ($order) {
3697 if (!is_a($order, 'WC_Order')) return;
3698
3699 $none = ['link'=>null, 'image'=>null, 'imagesize'=>null];
3700 $orderconfirmation = ['link' => $this->get_return_url($order), 'image' => null, 'imagesize'=>null];
3701
3702 $receipt_image = $this->get_option('receiptimage');
3703 if ($receipt_image) {
3704 $orderconfirmation['image'] = intval($receipt_image);
3705 $orderconfirmation['imagesize'] = 'full';
3706 }
3707
3708 // Do these in this order, in case we get terminated at some point during processing
3709 $default = ['TICKET'=>$none,'ORDER_CONFIRMATION' => $orderconfirmation, 'RECEIPT' => $none,"BOOKING" => $none, "DELIVERY" => $none, "GENERAL" => $none];
3710 $categories = apply_filters('woo_vipps_add_order_categories', $default, $order, $this);
3711
3712 foreach ($categories as $category=>$data) {
3713 if ($data['link']) {
3714 $this->order_add_vipps_category($category, $order, $data['link'], $data['image'], $data['imagesize']);
3715 }
3716 // Let people handle this in other ways if not using filter above IOK 2022-07-01
3717 do_action('woo_vipps_add_order_category', $category, $order, $this);
3718
3719 }
3720 }
3721
3722 // Use the Order Management API to add a link with a category name and an optional image, which is viewable in the order.
3723 public function order_add_vipps_category($categoryname, $order, $link, $image=null, $imagesize='medium') {
3724 $imageid = $image ? $this->add_vipps_image($image, $imagesize) : null;
3725 return $this->api->add_category($order, $link, $imageid, $categoryname);
3726 }
3727
3728 // Use the Order Management API to upload an image that can be attached to the order.
3729 public function add_vipps_image ($imagespec, $size = 'medium') {
3730 // Imagespec is an attachmend id (of an image) or a filename (to an image), and a size if using an attachment id.
3731 $filename = null;
3732 $imageid = 0;
3733 $imagefile = "";
3734 $mime = "";
3735 $accepted_types = ["image/jpeg", "image/png", "image/jpg"]; // Only accepted types at Vipps
3736 $vippsid = null;
3737 $uploads = wp_get_upload_dir();
3738
3739 if (is_numeric($imagespec)) {
3740 // Don't send same image twice if we have an id
3741 $stored = get_post_meta($imagespec, '_vipps_imageid', true);
3742 if ($stored && !$this->is_test_mode()) {
3743 return $stored;
3744 }
3745 $imageid = intval($imagespec);
3746 $imagefile = get_attached_file($imageid);
3747 $mime = get_post_mime_type($imageid);
3748 }
3749
3750 if (!is_file($imagefile) || !in_array($mime, $accepted_types)) {
3751 $this->log(sprintf(__('%1$s is not an image that can be uploaded to %2$s', 'woo-vipps'), $imagefile, Vipps::CompanyName()), 'error');
3752 $this->log(sprintf(__('File type was %1$s; supported types are %2$s', 'woo-vipps'), $mime, join(", ", $accepted_types)), 'error');
3753 return null;
3754 }
3755
3756 if ($imageid) {
3757 $intermediate = image_get_intermediate_size($imageid, $size);
3758 if ($intermediate && isset($intermediate['path'])) {
3759 $imagefile = join(DIRECTORY_SEPARATOR, [$uploads['basedir'] , $intermediate['path']]);
3760 }
3761 }
3762
3763 if ($imagefile) {
3764 // Check image dimensions before uploading
3765 $dimensions = getimagesize($imagefile);
3766 if ($dimensions && $dimensions[1] < 167) { // [1] is height
3767 $this->log(sprintf(__('Image %1$s is too small - height %2$dpx (minimum 167px required)', 'woo-vipps'),
3768 $imagefile, $dimensions[1]), 'error');
3769 return null;
3770 }
3771
3772 $vippsid = $this->api->add_image($imagefile);
3773 if ($vippsid) {
3774 update_post_meta($imageid, '_vipps_imageid', $vippsid);
3775 }
3776 }
3777 return $vippsid;
3778 }
3779
3780 // For the express checkout mechanism, create a partial order without shipping details by simulating checkout->create_order();
3781 // IOK 2018-05-25
3782 public function create_partial_order($ischeckout=false) {
3783 // This is neccessary for some plugins, like Yith Dynamic Pricing, that adds filters to get_price depending on whether or not ischeckout is true.
3784 // so basically, since we are impersonating WC_Checkout here, we should define this constant too. IOK 2020-07-03
3785 wc_maybe_define_constant('WOOCOMMERCE_CHECKOUT', true );
3786
3787 // In *some* cases you may need to actually load classes and reload the cart, because some plugins do not load when DOING_AJAX.
3788 do_action('woo_vipps_express_checkout_before_calculate_totals');
3789 WC()->cart->calculate_fees();
3790 WC()->cart->calculate_totals();
3791 do_action('woo_vipps_before_create_express_checkout_order', WC()->cart);
3792
3793 // We store this in the order so we don't have to access the cart when initiating payment. This allows us to restart orders etc.
3794 $needs_shipping = WC()->cart->needs_shipping();
3795
3796 $contents = WC()->cart->get_cart_contents();
3797 $contents = apply_filters('woo_vipps_create_express_checkout_cart_contents',$contents);
3798 try {
3799 $cart_hash = md5(json_encode(wc_clean($contents)) . WC()->cart->total);
3800 $order = new WC_Order();
3801 $order->set_status('pending');
3802 $order->set_payment_method($this);
3803 if ($ischeckout) {
3804 $order->update_meta_data('_vipps_api', 'epayment');
3805 $order->set_payment_method_title('Vipps Checkout');
3806 } else {
3807 $order->set_payment_method_title('Vipps Express Checkout');
3808 }
3809 // We use 'checkout' as the created_via key as per requests, but allow merchants to use their own. IOK 2022-09-15
3810 $created_via = apply_filters('woo_vipps_express_checkout_created_via', 'checkout', $order, $ischeckout);
3811 $order->set_created_via($created_via);
3812
3813 $dummy = sprintf(__('Vipps Express Checkout', 'woo-vipps')); // this is so gettext will find this string.
3814 $dummy = sprintf(__('Vipps Checkout', 'woo-vipps')); // this is so gettext will find this string.
3815
3816 $order->update_meta_data('_vipps_express_checkout',1);
3817
3818 # To help with address fields, scope etc in inititate payment
3819 $order->update_meta_data('_vipps_needs_shipping', $needs_shipping);
3820
3821 $order->set_customer_id( apply_filters('woocommerce_checkout_customer_id', get_current_user_id() ) );
3822 $order->set_currency( get_woocommerce_currency() );
3823 $order->set_prices_include_tax('yes' === get_option('woocommerce_prices_include_tax') );
3824 $order->set_customer_ip_address( WC_Geolocation::get_ip_address() );
3825 $order->set_customer_user_agent( wc_get_user_agent() );
3826 $order->set_discount_total( WC()->cart->get_discount_total());
3827 $order->set_discount_tax( WC()->cart->get_discount_tax() );
3828 $order->set_cart_tax( WC()->cart->get_cart_contents_tax() + WC()->cart->get_fee_tax() );
3829
3830 // Use these methods directly - they should be safe.
3831 WC()->checkout->create_order_line_items( $order, WC()->cart);
3832 WC()->checkout->create_order_fee_lines( $order, WC()->cart);
3833 WC()->checkout->create_order_tax_lines( $order, WC()->cart);
3834 WC()->checkout->create_order_coupon_lines( $order, WC()->cart);
3835 do_action('woo_vipps_before_calculate_totals_partial_order', $order);
3836 $order->calculate_totals(true);
3837
3838 // Added to support third-party plugins that wants to do stuff with the order before it is saved. IOK 2020-07-03
3839 do_action('woocommerce_checkout_create_order', $order, array());
3840
3841 $orderid = $order->save();
3842
3843 do_action('woo_vipps_express_checkout_order_created', $orderid);
3844
3845 // Normally done by the WC_Checkout::create_order method, so call it here too. IOK 2018-11-19
3846 do_action('woocommerce_checkout_update_order_meta', $orderid, array());
3847
3848 // It isn't possible to remove the javascript or 'after order notice' actions, because these are added as closures
3849 // before anything else is run. But we can disable the hook that saves data. IOK 2024-01-18
3850 if (WC_Gateway_Vipps::instance()->get_option('vippsorderattribution') != 'yes') {
3851 remove_all_filters( 'woocommerce_order_save_attribution_data');
3852 }
3853
3854 // And another one. IOK 2021-11-24
3855 do_action('woocommerce_checkout_order_created', $order );
3856 } catch ( Exception $e ) {
3857 if ( $order && $order instanceof WC_Order ) {
3858 $order->get_data_store()->release_held_coupons( $order );
3859 do_action('woocommerce_checkout_order_exception', $order );
3860 }
3861 // Any errors gets passed upstream IOK 2021-11-24
3862 throw $e;
3863 }
3864 return $orderid;
3865 }
3866
3867 // The order attribution subsystem of Woo requires extra work for our partial orders. IOK 2024-01-09
3868 // The attribution data is added to the order forms with prefixes (after 'order note') and we need to strip the prefix.
3869 public function get_order_attribution_data($input_data) {
3870 $prefix = (string) apply_filters( 'wc_order_attribution_tracking_field_prefix', 'wc_order_attribution_');
3871 $prefix = trim( $prefix, '_' ) . "_";
3872 $len = strlen($prefix);
3873 $params = [];
3874 foreach($input_data as $key=>$val) {
3875 $found = strpos($key, $prefix);
3876 if ($found === 0) {
3877 $paramkey = substr($key, $len);
3878 $params[$paramkey] = $val;
3879 }
3880 }
3881 return $params;
3882 }
3883
3884 public function save_session_in_order($order) {
3885 // The callbacks from Vipps carry no session cookie, so we must store this in the order and use a special session handler when in a callback.
3886 // The Vipps class will restore the session from this on callbacks.
3887 // IOK 2019-10-21
3888 $sessioncookie = array();
3889 $sessionhandler = WC()->session;
3890 if ($sessionhandler && is_a($sessionhandler, 'WC_Session_Handler')) {
3891 // If customer is actually logged in, take note IOK 2019-10-25
3892 WC()->session->set('express_customer_id',get_current_user_id());
3893 WC()->session->save_data();
3894 $sessioncookie=$sessionhandler->get_session_cookie();
3895 } else {
3896 // This actually can't happen. IOK 2020-04-08. Branch added for debugging only.
3897 }
3898
3899 if (!empty($sessioncookie)) {
3900 // Customer id, session expiration, session-epiring and cookie-hash is the contents. IOK 2019-10-21
3901 $order->update_meta_data('_vipps_sessiondata',json_encode($sessioncookie));
3902 $order->save();
3903 }
3904
3905 }
3906
3907 // Using this internally to allow the 'enable' button or not. Checks SSL in addition to currency,
3908 // is valid_for_use can in principle run on a http version of the page; we only need to have https accessible for callbacks,
3909 // but if so, admin should definitely be HTTPS so we just check that. IOK 2018-06-06
3910 public function can_be_activated () {
3911 if (!is_ssl() && !preg_match("!^https!i",home_url())) return false;
3912 return true;
3913 }
3914
3915 // Used by the ajax thing that 'sets activated' - checks that it can be activated and that all keys are present. IOK 2018-06-06
3916 function needs_setup() {
3917 if (!$this->can_be_activated()) return true;
3918 $required = array('merchantSerialNumber','clientId', 'secret', 'Ocp_Apim_Key_eCommerce');
3919 foreach ($required as $key) {
3920 if (!$this->get_option($key)) return true;
3921 }
3922 return false;
3923 }
3924
3925 // Not present in WooCommerce until 3.4.0. Should be deleted when required versions are incremented. IOK 2018-10-26
3926 public function update_option( $key, $value = '') {
3927 if ( empty( $this->settings ) ) {
3928 $this->init_settings();
3929 }
3930 $this->settings[ $key ] = $value;
3931 return update_option( $this->get_option_key(), apply_filters('woocommerce_settings_api_sanitized_fields_' . $this->id, $this->settings ), 'yes');
3932 }
3933
3934
3935 public function admin_options() {
3936 $currency = get_woocommerce_currency();
3937 $payment_method = $this->get_payment_method_name();
3938
3939 if (!$this->can_be_activated()) {
3940 $this->update_option('enabled', 'no');
3941 }
3942
3943 if ($payment_method != "Vipps"): ?>
3944 <style>
3945 #woocommerce_vipps_express_options, #woocommerce_vipps_express_options-table {
3946 display: none;
3947 }
3948 </style>
3949 <?php endif; ?>
3950
3951 <h2 id='vipps-settings-page'><?php echo __(Vipps::CompanyName(),'woo-vipps'); ?> <img style="float:right;max-height:40px;margin-top:-15px" alt="<?php _e($this->title,'woo-vipps'); ?>" src="<?php echo $this->icon; ?>"></h2>
3952 <?php $this->display_errors(); ?>
3953
3954 <?php
3955
3956
3957 if (!$this->payment_method_supports_currency($payment_method, $currency)):
3958 ?>
3959 <div class="inline error">
3960 <p><strong><?php echo sprintf(__('%1$s does not support your currency.', 'woo-vipps'), $payment_method); ?></strong>
3961 <br>
3962 <?php echo sprintf(__('%1$s supported currencies: %2$s', 'woo-vipps'), $payment_method, implode(", ", $this->get_supported_currencies($payment_method))); ?>
3963 </p>
3964 </div>
3965 <?php endif; ?>
3966
3967 <?php if (!is_ssl() && !preg_match("!^https!i",home_url())): ?>
3968 <div class="inline error">
3969 <p><strong><?php _e('Gateway disabled', 'woocommerce'); ?></strong>:
3970 <?php echo sprintf(__('%1$s requires that your site uses HTTPS.', 'woo-vipps'), $payment_method); ?>
3971 </p>
3972 </div>
3973 <?php endif; ?>
3974
3975 <?php // We will only show the Vipps Checkout options if the user has activated the feature (thus creating the pages involved etc). IOK 2021-10-01
3976 $vipps_checkout_activated = get_option('woo_vipps_checkout_activated', false);
3977 ?>
3978
3979 <?php /* We will *not* allow vipps checkout to be activated at this point, since the product is no longer sold. IOK 2026-04-30 */ ?>
3980 <?php if (!$vipps_checkout_activated): ?>
3981
3982 <?php endif; ?>
3983 <table class="form-table">
3984 <?php $this->generate_settings_html(); ?>
3985 </table> <?php
3986 }
3987
3988 // Validate/mangle input fields
3989 function validate_text_field ($key, $value) {
3990 if ($key != 'orderprefix') return parent::validate_text_field($key,$value);
3991 $value = preg_replace('![^a-zA-Z0-9]!','',$value);
3992 return $value;
3993 }
3994 function validate_checkbox_field($key,$value) {
3995 if ($key == 'testmode' && VIPPS_TEST_MODE) {
3996 return "yes";
3997 } else if ($key == 'developermode' && VIPPS_TEST_MODE) {
3998 return "yes";
3999 } else if ($key == 'enabled') {
4000 if ($value && $this->can_be_activated()) return 'yes';
4001 return "no";
4002 }
4003 return parent::validate_checkbox_field($key,$value);
4004 }
4005
4006 function process_admin_options () {
4007 // Handle options updates
4008 $saved = parent::process_admin_options();
4009 // We may have changed the number of form fields at this point if dev mode was changed
4010 // from off to on,so re-initialize the form fields here. IOK 2019-09-03
4011 $this->init_form_fields();
4012
4013 // Reinitialize keysets in case user added/changed these
4014 $this->keyset = null;
4015 delete_transient('_vipps_keyset');
4016 $keyset = $this->get_keyset();
4017
4018 // IOK FIXME check if we are called using ajax for this; and if so add the notifications to a list of notifications
4019 // instead of doing the adminerr/adminnotify thing. IOK 2024-01-03
4020
4021 list($ok,$msg) = $this->check_connection();
4022 if ($ok) {
4023 $this->adminnotify(sprintf(__("Connection to %1\$s is OK", 'woo-vipps'), Vipps::CompanyName()));
4024 } else {
4025 $this->adminerr(sprintf(__("Could not connect to %1\$s", 'woo-vipps'), Vipps::CompanyName()) . ": $msg");
4026 }
4027
4028 if ($ok) {
4029 $this->check_webhooks();
4030 // Try to ensure we have webhooks defined for the epayment-api IOK 2023-12-19
4031 $hooks = $this->initialize_webhooks();
4032 }
4033
4034 // If enabling this, ensure the page in question exists
4035 if ($this->get_option('vipps_checkout_enabled') == 'yes') {
4036 update_option('woo_vipps_checkout_activated', true, true); // This must be true here, but still, make sure
4037 Vipps::instance()->maybe_create_vipps_pages();
4038 }
4039
4040 return $saved;
4041 }
4042
4043 // Check our stored webhooks for consistency, which means the callback URLs should point to *this* site. If they don't,
4044 // delete all the ones pointing wrong. If this returns false, you should reinitialize the webhooks. IOK 2023-12-20
4045 public function check_webhooks () {
4046 $local_hooks = get_option('_woo_vipps_webhooks');
4047 if (!$local_hooks) return false;
4048
4049 $callback = $this->webhook_callback_url();
4050 $callback_compare = strtok($callback, '?');
4051 $problems = false;
4052
4053 // We are going to re-initialize our webhooks after this, but just to ensure we're not keeping any 'stale' hooks,
4054 // we'll update the local hooks too. IOK 2025-02-13
4055 $change = false;
4056 $msns = array_keys($local_hooks);
4057 foreach($msns as $msn) {
4058 $hooks = $local_hooks[$msn];
4059 $ids = array_keys($hooks);
4060 foreach ($ids as $id) {
4061 $hook = $hooks[$id];
4062 $noargs = strtok($hook['url'], '?');
4063 if ($noargs == $callback_compare) continue; // This hook is good, probably, unless somebody has deleted it
4064 try {
4065 $this->log(sprintf(__("For msn %s we have a webhook %s %s which is pointed the wrong way (%s) for this website", 'woo-vipps'), $msn, $hook['id'], $hook['url'], $callback_compare));
4066 $this->api->delete_webhook($msn, $hook['id']); // This isn't - it's pointed the wrong way, which means we have changed name of the site or something
4067 } catch (Exception $e) {
4068 $this->log(sprintf(__("Could not delete webhook for this site with url '%2\$s' : %1\$s", 'woo-vipps'), $e->getMessage(), $noargs), 'error');
4069 }
4070 unset($hooks[$id]);
4071 $change = true;
4072 $problems = true;
4073 }
4074
4075 if ($change) {
4076 if (empty($hooks)) {
4077 unset($local_hooks[$msn]);
4078 } else {
4079 $local_hooks[$msn] = $hooks;
4080 }
4081 }
4082 }
4083
4084 if ($change) {
4085 update_option('_woo_vipps_webhooks', $local_hooks, true);
4086 }
4087
4088 if ($problems) return false;
4089 return true;
4090 }
4091
4092 // Returns the local webhooks for the given msn. If the url has changed, it will return nothing. IOK 2023-12-19
4093 public function get_local_webhook($msn) {
4094 $local_hooks = get_option('_woo_vipps_webhooks');
4095 $hooks = $local_hooks[$msn] ?? [];
4096 $callback = $this->webhook_callback_url();
4097 $callback_compare = strtok($callback, '?');
4098
4099 foreach ($hooks as $id=>$hook) {
4100 $noargs = strtok($hook['url'], '?');
4101 if ($noargs == $callback_compare) {
4102 return $hook;
4103 } else {
4104 // May want to log this somehow
4105 }
4106 }
4107 return null;
4108 }
4109
4110
4111 // This is to be used in deactivate/uninstall - it deletes all webhooks for all MSNs for this instance
4112 // Unfortunatetly, we can't delete other msn's webhooks or webhooks pointing to other URLs. IOK 2023-12-20
4113 public function delete_all_webhooks() {
4114 delete_option('_woo_vipps_webhooks');
4115 $callback = $this->webhook_callback_url();
4116 $comparandum = strtok($callback, '?');
4117 $all_hooks = $this->get_webhooks_from_vipps();
4118 foreach($all_hooks as $msn => $data) {
4119 $hooks = $data['webhooks'] ?? [];
4120 foreach ($hooks as $hook) {
4121 $id = $hook['id'];
4122 $url = $hook['url'];
4123 $noargs = strtok($url, '?');
4124 if ($noargs != $comparandum) continue; // Some other shops hook, we will ignore it
4125 $ok = $this->api->delete_webhook($msn,$id);
4126 }
4127 }
4128 }
4129
4130 // This will initalize the webhooks for this instance, for all MSNs that are configured.
4131 // Hooks that point to us that we *do not* know the secret for, have to be deleted.
4132 public function initialize_webhooks() {
4133 // IOK 2023-12-20 for the epayment api, we need to re-initialize webhooks at this point.
4134 try {
4135 return $this->initialize_webhooks_internal();
4136 } catch (Exception $e) {
4137 $this->log(sprintf(__("Could not initialize webhooks for this site: %1\$s", 'woo-vipps'), $e->getMessage()), 'error');
4138 return [];
4139 }
4140 }
4141
4142 private function initialize_webhooks_internal () {
4143 $local_hooks = get_option('_woo_vipps_webhooks');
4144 $all_hooks = $this->get_webhooks_from_vipps();
4145 $ourselves = $this->webhook_callback_url();
4146 $keysets = $this->get_keyset();
4147
4148 // Ignore any extra arguments
4149 $comparandum = strtok($ourselves, '?');
4150
4151 $change = false;
4152
4153 // We may need to delete webhooks that have been orphaned. There should be exactly one
4154 // for this sites' callback, and we need to know its secret. All others should be deleted.
4155 $delenda = [];
4156
4157
4158 foreach($all_hooks as $msn => $data) {
4159 $hooks = $data['webhooks'] ?? [];
4160 $gotit = false;
4161 $locals = $local_hooks[$msn] ?? [];
4162
4163 foreach ($hooks as $hook) {
4164 $id = $hook['id'];
4165 $url = $hook['url'];
4166 $noargs = strtok($url, '?');
4167 if ($noargs != $comparandum) {
4168 continue; // Some other shops hook, we will ignore it
4169 }
4170 $local = $locals[$id] ?? false;
4171
4172 // If we haven't gotten our hook yet, but we have a local hook now that we know a secret for, note it and continue
4173 if (!$gotit && $local && isset($local['secret'])) {
4174 $gotit = $local;
4175 continue;
4176 }
4177 // Now we have a hook for our own msn and url, but either we don't know the secret or it is a duplicate. It should be deleted.
4178 $delenda[] = $id;
4179 }
4180
4181 // Delete all the webhooks for this msn that we don't want
4182 foreach ($delenda as $wrong) {
4183 $change = true;
4184 $this->api->delete_webhook($msn,$wrong);
4185 }
4186
4187 if ($gotit) {
4188 // Now if we got a hook, then we should *just* remember that for this msn.
4189 $local_hooks[$msn] = array($gotit['id'] => $gotit);
4190 } else {
4191 // If not, we don't have a hook for this msn and site, so we need to (try to) create one
4192 // but only if the MSN is registered for the payment gateway "vipps" ! IOK 2024-12-03
4193 $keys = $keysets[$msn] ?? [];
4194 $gateway = $keys['gw'] ?? 'vipps';
4195
4196 if ($gateway == 'vipps') {
4197 $change = true;
4198 $result = $this->api->register_webhook($msn, $ourselves);
4199 if ($result) {
4200 $local_hooks[$msn] = [$result['id'] => ['id'=>$result['id'], 'url' => $ourselves, 'secret' => $result['secret']]];
4201 }
4202 }
4203 }
4204 }
4205 update_option('_woo_vipps_webhooks', $local_hooks, true);
4206
4207
4208 if ($change) $all_hooks = $this->get_webhooks_from_vipps();
4209
4210 return $all_hooks;
4211 }
4212
4213
4214 // Checks connection of the 'main' MSN IOK 2023-12-19
4215 public function check_connection ($msn = null) {
4216 if (!$msn) {
4217 $msn = $this->get_merchant_serial();
4218 }
4219 $at = $this->get_key($msn);
4220 $s = $this->get_secret($msn);
4221 $c = $this->get_clientid($msn);
4222 if ($at && $s && $c) {
4223
4224
4225
4226 try {
4227 // First, test the client id / client secret which will give us an access token
4228 $token = $this->api->get_access_token($msn,'force');
4229 if ($token) {
4230 // Then, call the webhooks api to check if the msn/sub key is ok
4231 try {
4232 $this->api->get_webhooks_raw($msn);
4233 update_option('woo-vipps-configured', 1, true);
4234 return array(true,'');
4235 } catch (Exception $e) {
4236 $msg = $e->getMessage();
4237 if ($msg == "403 Forbidden") {
4238 $msg= __("MSN or subscription key (or both) seem to be wrong: ", 'woo-vipps') . $msg;
4239 }
4240 update_option('woo-vipps-configured', 0, true);
4241 return array(false, $msg);
4242 }
4243 }
4244
4245 } catch (Exception $e) {
4246 $msg = __("Your client key or secret is wrong.", 'woo-vipps');
4247 update_option('woo-vipps-configured', 0, true);
4248 return array(false, $msg);
4249 }
4250 }
4251 return array(false, ''); // No configuration
4252 }
4253
4254 public function log ($what,$type='info') {
4255 $logger = function_exists('wc_get_logger') ? wc_get_logger() : false;
4256 if ($logger) {
4257 $context = array('source'=>'woo-vipps');
4258 $logger->log($type,$what,$context);
4259 } else {
4260 error_log("woo-vipps ($type): $what");
4261 }
4262 }
4263
4264 // Ensure chosen name gets used in the checkout page IOK 2018-09-12
4265 public function get_title() {
4266 return apply_filters('woo_vipps_payment_method_title', $this->get_payment_method_name());
4267 }
4268
4269 public function get_payment_method_name() {
4270 return $this->get_option('payment_method_name');
4271 }
4272
4273 public function payment_fields() {
4274 // Use Billing Phone if it is required, otherwise ask for a phone IOK 2018-04-24
4275 // For v2 of the api, just let Vipps ask for then umber
4276 // IOK 2019-09-12 removed dead code only used for v1 of api
4277 // This just prints a description of the payment method.
4278 print $this->get_option('description');
4279 return;
4280 }
4281 public function validate_fields() {
4282 return true;
4283 }
4284
4285
4286 }
4287
4288