Failed Conditions
Push — develop ( 235267...7457d1 )
by Remco
08:57 queued 03:57
created

Gateway::create_refund()   A

Complexity

Conditions 3
Paths 4

Size

Total Lines 22
Code Lines 10

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 12

Importance

Changes 1
Bugs 0 Features 0
Metric Value
cc 3
eloc 10
c 1
b 0
f 0
nc 4
nop 3
dl 0
loc 22
ccs 0
cts 10
cp 0
crap 12
rs 9.9332
1
<?php
2
/**
3
 * Mollie gateway.
4
 *
5
 * @author    Pronamic <[email protected]>
6
 * @copyright 2005-2021 Pronamic
7
 * @license   GPL-3.0-or-later
8
 * @package   Pronamic\WordPress\Pay
9
 */
10
11
namespace Pronamic\WordPress\Pay\Gateways\Mollie;
12
13
use Pronamic\WordPress\DateTime\DateTime;
14
use Pronamic\WordPress\Money\Money;
15
use Pronamic\WordPress\Pay\Banks\BankAccountDetails;
16
use Pronamic\WordPress\Pay\Banks\BankTransferDetails;
17
use Pronamic\WordPress\Pay\Core\Gateway as Core_Gateway;
18
use Pronamic\WordPress\Pay\Core\PaymentMethods;
19
use Pronamic\WordPress\Pay\Payments\FailureReason;
20
use Pronamic\WordPress\Pay\Payments\Payment;
0 ignored issues
show
Bug introduced by
This use statement conflicts with another class in this namespace, Pronamic\WordPress\Pay\Gateways\Mollie\Payment. Consider defining an alias.

Let?s assume that you have a directory layout like this:

.
|-- OtherDir
|   |-- Bar.php
|   `-- Foo.php
`-- SomeDir
    `-- Foo.php

and let?s assume the following content of Bar.php:

// Bar.php
namespace OtherDir;

use SomeDir\Foo; // This now conflicts the class OtherDir\Foo

If both files OtherDir/Foo.php and SomeDir/Foo.php are loaded in the same runtime, you will see a PHP error such as the following:

PHP Fatal error:  Cannot use SomeDir\Foo as Foo because the name is already in use in OtherDir/Foo.php

However, as OtherDir/Foo.php does not necessarily have to be loaded and the error is only triggered if it is loaded before OtherDir/Bar.php, this problem might go unnoticed for a while. In order to prevent this error from surfacing, you must import the namespace with a different alias:

// Bar.php
namespace OtherDir;

use SomeDir\Foo as SomeDirFoo; // There is no conflict anymore.
Loading history...
21
use Pronamic\WordPress\Pay\Payments\PaymentStatus;
22
use Pronamic\WordPress\Pay\Subscriptions\Subscription;
23
use Pronamic\WordPress\Pay\Subscriptions\SubscriptionStatus;
24
25
/**
26
 * Title: Mollie
27
 * Description:
28
 * Copyright: 2005-2021 Pronamic
29
 * Company: Pronamic
30
 *
31
 * @author  Remco Tolsma
32
 * @version 2.1.4
33
 * @since   1.1.0
34
 */
35
class Gateway extends Core_Gateway {
36
	/**
37
	 * Client.
38
	 *
39
	 * @var Client
40
	 */
41
	protected $client;
42
43
	/**
44
	 * Config
45
	 *
46
	 * @var Config
47
	 */
48
	protected $config;
49
50
	/**
51
	 * Profile data store.
52
	 *
53
	 * @var ProfileDataStore
54
	 */
55
	private $profile_data_store;
56
57
	/**
58
	 * Customer data store.
59
	 *
60
	 * @var CustomerDataStore
61
	 */
62
	private $customer_data_store;
63
64
	/**
65
	 * Constructs and initializes an Mollie gateway
66
	 *
67
	 * @param Config $config Config.
68
	 */
69 39
	public function __construct( Config $config ) {
70 39
		parent::__construct( $config );
71
72 39
		$this->set_method( self::METHOD_HTTP_REDIRECT );
73
74
		// Supported features.
75 39
		$this->supports = array(
76
			'payment_status_request',
77
			'recurring_direct_debit',
78
			'recurring_credit_card',
79
			'recurring',
80
			'refunds',
81
			'webhook',
82
			'webhook_log',
83
			'webhook_no_config',
84
		);
85
86
		// Client.
87 39
		$this->client = new Client( (string) $config->api_key );
88
89
		// Data Stores.
90 39
		$this->profile_data_store  = new ProfileDataStore();
91 39
		$this->customer_data_store = new CustomerDataStore();
92
93
		// Actions.
94 39
		add_action( 'pronamic_payment_status_update', array( $this, 'copy_customer_id_to_wp_user' ), 99, 1 );
95 39
	}
96
97
	/**
98
	 * Get issuers
99
	 *
100
	 * @see Core_Gateway::get_issuers()
101
	 * @return array<int, array<string, array<string>>>
102
	 */
103 3
	public function get_issuers() {
104 3
		$groups = array();
105
106
		try {
107 3
			$result = $this->client->get_issuers();
108
109
			$groups[] = array(
110
				'options' => $result,
111
			);
112 3
		} catch ( Error $e ) {
113
			// Catch Mollie error.
114 3
			$error = new \WP_Error(
115 3
				'mollie_error',
116 3
				sprintf( '%1$s (%2$s) - %3$s', $e->get_title(), $e->getCode(), $e->get_detail() )
117
			);
118
119 3
			$this->set_error( $error );
120
		} catch ( \Exception $e ) {
121
			// Catch exceptions.
122
			$error = new \WP_Error( 'mollie_error', $e->getMessage() );
123
124
			$this->set_error( $error );
125
		}
126
127 3
		return $groups;
128
	}
129
130
	/**
131
	 * Get available payment methods.
132
	 *
133
	 * @see Core_Gateway::get_available_payment_methods()
134
	 * @return array<int, string>
135
	 */
136 2
	public function get_available_payment_methods() {
137 2
		$payment_methods = array();
138
139
		// Set sequence types to get payment methods for.
140 2
		$sequence_types = array( Sequence::ONE_OFF, Sequence::RECURRING, Sequence::FIRST );
141
142 2
		$results = array();
143
144 2
		foreach ( $sequence_types as $sequence_type ) {
145
			// Get active payment methods for Mollie account.
146
			try {
147 2
				$result = $this->client->get_payment_methods( $sequence_type );
148 2
			} catch ( Error $e ) {
149
				// Catch Mollie error.
150
				$error = new \WP_Error(
151
					'mollie_error',
152
					sprintf( '%1$s (%2$s) - %3$s', $e->get_title(), $e->getCode(), $e->get_detail() )
153
				);
154
155
				$this->set_error( $error );
156
157
				break;
158 2
			} catch ( \Exception $e ) {
159
				// Catch exceptions.
160 2
				$error = new \WP_Error( 'mollie_error', $e->getMessage() );
161
162 2
				$this->set_error( $error );
163
164 2
				break;
165
			}
166
167 2
			if ( Sequence::FIRST === $sequence_type ) {
168
				foreach ( $result as $method => $title ) {
169
					unset( $result[ $method ] );
170
171
					// Get WordPress payment method for direct debit method.
172
					$method         = Methods::transform_gateway_method( $method );
173
					$payment_method = array_search( $method, PaymentMethods::get_recurring_methods(), true );
174
175
					if ( $payment_method ) {
176
						$results[ $payment_method ] = $title;
177
					}
178
				}
179
			}
180
181 2
			if ( is_array( $result ) ) {
182 2
				$results = array_merge( $results, $result );
183
			}
184
		}
185
186
		// Transform to WordPress payment methods.
187 2
		foreach ( $results as $method => $title ) {
188 2
			$method = (string) $method;
189
190 2
			$payment_method = Methods::transform_gateway_method( $method );
191
192 2
			if ( PaymentMethods::is_recurring_method( $method ) ) {
193
				$payment_method = $method;
194
			}
195
196 2
			if ( null !== $payment_method ) {
197 2
				$payment_methods[] = (string) $payment_method;
198
			}
199
		}
200
201 2
		$payment_methods = array_unique( $payment_methods );
202
203 2
		return $payment_methods;
204
	}
205
206
	/**
207
	 * Get supported payment methods
208
	 *
209
	 * @see Core_Gateway::get_supported_payment_methods()
210
	 * @return array<string>
211
	 */
212 2
	public function get_supported_payment_methods() {
213
		return array(
214 2
			PaymentMethods::APPLE_PAY,
215
			PaymentMethods::BANCONTACT,
216
			PaymentMethods::BANK_TRANSFER,
217
			PaymentMethods::BELFIUS,
218
			PaymentMethods::CREDIT_CARD,
219
			PaymentMethods::DIRECT_DEBIT,
220
			PaymentMethods::DIRECT_DEBIT_BANCONTACT,
221
			PaymentMethods::DIRECT_DEBIT_IDEAL,
222
			PaymentMethods::DIRECT_DEBIT_SOFORT,
223
			PaymentMethods::EPS,
224
			PaymentMethods::GIROPAY,
225
			PaymentMethods::IDEAL,
226
			PaymentMethods::KBC,
227
			PaymentMethods::PAYPAL,
228
			PaymentMethods::PRZELEWY24,
229
			PaymentMethods::SOFORT,
230
		);
231
	}
232
233
	/**
234
	 * Get webhook URL for Mollie.
235
	 *
236
	 * @return string|null
237
	 */
238 4
	public function get_webhook_url() {
239 4
		$url = \rest_url( Integration::REST_ROUTE_NAMESPACE . '/webhook' );
240
241 4
		$host = wp_parse_url( $url, PHP_URL_HOST );
242
243 4
		if ( is_array( $host ) ) {
244
			// Parsing failure.
245
			$host = '';
246
		}
247
248 4
		if ( 'localhost' === $host ) {
249
			// Mollie doesn't allow localhost.
250 1
			return null;
251 3
		} elseif ( '.dev' === substr( $host, -4 ) ) {
252
			// Mollie doesn't allow the .dev TLD.
253 1
			return null;
254 2
		} elseif ( '.local' === substr( $host, -6 ) ) {
255
			// Mollie doesn't allow the .local TLD.
256 1
			return null;
257 1
		} elseif ( '.test' === substr( $host, -5 ) ) {
258
			// Mollie doesn't allow the .test TLD.
259
			return null;
260
		}
261
262 1
		return $url;
263
	}
264
265
	/**
266
	 * Start
267
	 *
268
	 * @see Core_Gateway::start()
269
	 * @param Payment $payment Payment.
270
	 * @return void
271
	 * @throws \Exception Throws exception on error creating Mollie customer for payment.
272
	 */
273
	public function start( Payment $payment ) {
274
		$description = (string) $payment->get_description();
275
276
		/**
277
		 * Filters the Mollie payment description.
278
		 * 
279
		 * The maximum length of the description field differs per payment
280
		 * method, with the absolute maximum being 255 characters.
281
		 *
282
		 * @link https://docs.mollie.com/reference/v2/payments-api/create-payment#parameters
283
		 * @since 3.0.1
284
		 * @param string  $description Description.
285
		 * @param Payment $payment     Payment.
286
		 */
287
		$description = \apply_filters( 'pronamic_pay_mollie_payment_description', $description, $payment );
288
289
		$request = new PaymentRequest(
290
			AmountTransformer::transform( $payment->get_total_amount() ),
291
			$description
292
		);
293
294
		$request->redirect_url = $payment->get_return_url();
295
		$request->webhook_url  = $this->get_webhook_url();
296
297
		// Locale.
298
		$customer = $payment->get_customer();
299
300
		if ( null !== $customer ) {
301
			$request->locale = LocaleHelper::transform( $customer->get_locale() );
302
		}
303
304
		// Customer ID.
305
		$customer_id = $this->get_customer_id_for_payment( $payment );
306
307
		if ( null === $customer_id ) {
308
			$customer_id = $this->create_customer_for_payment( $payment );
309
		}
310
311
		if ( null !== $customer_id ) {
312
			$request->customer_id = $customer_id;
313
		}
314
315
		/**
316
		 * Payment method.
317
		 *
318
		 * Leap of faith if the WordPress payment method could not transform to a Mollie method?
319
		 */
320
		$payment_method = $payment->get_payment_method();
0 ignored issues
show
Bug introduced by
The method get_payment_method() does not exist on Pronamic\WordPress\Pay\Payments\Payment. ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

320
		/** @scrutinizer ignore-call */ 
321
  $payment_method = $payment->get_payment_method();

This check looks for calls to methods that do not seem to exist on a given type. It looks for the method on the type itself as well as in inherited classes or implemented interfaces.

This is most likely a typographical error or the method has been renamed.

Loading history...
321
322
		$request->set_method( Methods::transform( $payment_method, $payment_method ) );
323
324
		/**
325
		 * Sequence type.
326
		 *
327
		 * Recurring payments are created through the Payments API by providing a `sequenceType`.
328
		 */
329
		$subscriptions = $payment->get_subscriptions();
330
331
		if ( \count( $subscriptions ) > 0 ) {
332
			$request->set_method( PaymentMethods::get_first_payment_method( $payment_method ) );
333
			$request->set_sequence_type( 'first' );
334
335
			foreach ( $subscriptions as $subscription ) {
336
				$mandate_id = $subscription->get_meta( 'mollie_mandate_id' );
337
338
				if ( ! empty( $mandate_id ) ) {
339
					$request->set_method( null );
340
					$request->set_sequence_type( 'recurring' );
341
					$request->set_mandate_id( $mandate_id );
342
				}
343
			}
344
		}
345
346
		/**
347
		 * Direct Debit.
348
		 *
349
		 * Check if one-off SEPA Direct Debit can be used, otherwise short circuit payment.
350
		 */
351
		$consumer_bank_details = $payment->get_consumer_bank_details();
352
353
		if ( PaymentMethods::DIRECT_DEBIT === $payment_method && null !== $consumer_bank_details ) {
354
			$consumer_name = $consumer_bank_details->get_name();
355
			$consumer_iban = $consumer_bank_details->get_iban();
356
357
			$request->consumer_name    = $consumer_name;
358
			$request->consumer_account = $consumer_iban;
359
360
			// Check if one-off SEPA Direct Debit can be used, otherwise short circuit payment.
361
			if ( null !== $customer_id ) {
362
				// Find or create mandate.
363
				$mandate_id = $this->client->has_valid_mandate( $customer_id, PaymentMethods::DIRECT_DEBIT, $consumer_iban );
364
365
				if ( false === $mandate_id ) {
366
					$mandate = $this->client->create_mandate( $customer_id, $consumer_bank_details );
367
368
					if ( ! \property_exists( $mandate, 'id' ) ) {
369
						throw new \Exception( 'Missing mandate ID.' );
370
					}
371
372
					$mandate_id = $mandate->id;
373
				}
374
375
				// Charge immediately on-demand.
376
				$request->set_sequence_type( Sequence::RECURRING );
377
				$request->set_mandate_id( (string) $mandate_id );
378
			}
379
		}
380
381
		/**
382
		 * Metadata.
383
		 *
384
		 * Provide any data you like, for example a string or a JSON object.
385
		 * We will save the data alongside the payment. Whenever you fetch
386
		 * the payment with our API, we’ll also include the metadata. You
387
		 * can use up to approximately 1kB.
388
		 *
389
		 * @link https://docs.mollie.com/reference/v2/payments-api/create-payment
390
		 * @link https://en.wikipedia.org/wiki/Metadata
391
		 */
392
		$metadata = null;
393
394
		/**
395
		 * Filters the Mollie metadata.
396
		 *
397
		 * @since 2.2.0
398
		 *
399
		 * @param mixed   $metadata Metadata.
400
		 * @param Payment $payment  Payment.
401
		 */
402
		$metadata = \apply_filters( 'pronamic_pay_mollie_payment_metadata', $metadata, $payment );
403
404
		$request->set_metadata( $metadata );
405
406
		// Issuer.
407
		if ( Methods::IDEAL === $request->method ) {
408
			$request->issuer = $payment->get_meta( 'issuer' );
0 ignored issues
show
Documentation Bug introduced by
It seems like $payment->get_meta('issuer') can also be of type false. However, the property $issuer is declared as type null|string. Maybe add an additional type check?

Our type inference engine has found a suspicous assignment of a value to a property. This check raises an issue when a value that can be of a mixed type is assigned to a property that is type hinted more strictly.

For example, imagine you have a variable $accountId that can either hold an Id object or false (if there is no account id yet). Your code now assigns that value to the id property of an instance of the Account class. This class holds a proper account, so the id value must no longer be false.

Either this assignment is in error or a type check should be added for that assignment.

class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}
Loading history...
409
		}
410
411
		// Billing email.
412
		$billing_email = $payment->get_email();
413
414
		/**
415
		 * Filters the Mollie payment billing email used for bank transfer payment instructions.
416
		 *
417
		 * @since 2.2.0
418
		 *
419
		 * @param string|null $billing_email Billing email.
420
		 * @param Payment     $payment       Payment.
421
		 */
422
		$billing_email = \apply_filters( 'pronamic_pay_mollie_payment_billing_email', $billing_email, $payment );
423
424
		$request->set_billing_email( $billing_email );
425
426
		// Due date.
427
		if ( ! empty( $this->config->due_date_days ) ) {
428
			try {
429
				$due_date = new DateTime( sprintf( '+%s days', $this->config->due_date_days ) );
430
			} catch ( \Exception $e ) {
431
				$due_date = null;
432
			}
433
434
			$request->set_due_date( $due_date );
435
		}
436
437
		// Create payment.
438
		$result = $this->client->create_payment( $request );
439
440
		// phpcs:disable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase -- Mollie JSON object.
441
442
		// Set transaction ID.
443
		if ( isset( $result->id ) ) {
444
			$payment->set_transaction_id( $result->id );
445
		}
446
447
		// Set expiry date.
448
		if ( isset( $result->expiresAt ) ) {
449
			try {
450
				$expires_at = new DateTime( $result->expiresAt );
451
			} catch ( \Exception $e ) {
452
				$expires_at = null;
453
			}
454
455
			$payment->set_expiry_date( $expires_at );
456
		}
457
458
		// Set status.
459
		if ( isset( $result->status ) ) {
460
			$payment->set_status( Statuses::transform( $result->status ) );
461
		}
462
463
		// Set bank transfer recipient details.
464
		if ( isset( $result->details ) ) {
465
			$bank_transfer_recipient_details = $payment->get_bank_transfer_recipient_details();
466
467
			if ( null === $bank_transfer_recipient_details ) {
468
				$bank_transfer_recipient_details = new BankTransferDetails();
469
470
				$payment->set_bank_transfer_recipient_details( $bank_transfer_recipient_details );
471
			}
472
473
			$bank_details = $bank_transfer_recipient_details->get_bank_account();
474
475
			if ( null === $bank_details ) {
476
				$bank_details = new BankAccountDetails();
477
478
				$bank_transfer_recipient_details->set_bank_account( $bank_details );
479
			}
480
481
			$details = $result->details;
482
483
			if ( isset( $details->bankName ) ) {
484
				/**
485
				 * Set `bankName` as bank details name, as result "Stichting Mollie Payments"
486
				 * is not the name of a bank, but the account holder name.
487
				 */
488
				$bank_details->set_name( $details->bankName );
489
			}
490
491
			if ( isset( $details->bankAccount ) ) {
492
				$bank_details->set_iban( $details->bankAccount );
493
			}
494
495
			if ( isset( $details->bankBic ) ) {
496
				$bank_details->set_bic( $details->bankBic );
497
			}
498
499
			if ( isset( $details->transferReference ) ) {
500
				$bank_transfer_recipient_details->set_reference( $details->transferReference );
501
			}
502
		}
503
504
		// Handle links.
505
		if ( isset( $result->_links ) ) {
506
			$links = $result->_links;
507
508
			// Action URL.
509
			if ( isset( $links->checkout->href ) ) {
510
				$payment->set_action_url( $links->checkout->href );
511
			}
512
513
			// Change payment state URL.
514
			if ( isset( $links->changePaymentState->href ) ) {
515
				$payment->set_meta( 'mollie_change_payment_state_url', $links->changePaymentState->href );
516
			}
517
		}
518
519
		// phpcs:enable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase -- Mollie JSON object.
520
	}
521
522
	/**
523
	 * Update status of the specified payment
524
	 *
525
	 * @param Payment $payment Payment.
526
	 * @return void
527
	 */
528
	public function update_status( Payment $payment ) {
529
		$transaction_id = $payment->get_transaction_id();
530
531
		if ( null === $transaction_id ) {
532
			return;
533
		}
534
535
		$mollie_payment = $this->client->get_payment( $transaction_id );
536
537
		$payment->set_status( Statuses::transform( $mollie_payment->get_status() ) );
538
539
		/**
540
		 * Mollie profile.
541
		 */
542
		$mollie_profile = new Profile();
543
544
		$mollie_profile->set_id( $mollie_payment->get_profile_id() );
545
546
		$profile_internal_id = $this->profile_data_store->get_or_insert_profile( $mollie_profile );
547
548
		/**
549
		 * If the Mollie payment contains a customer ID we will try to connect
550
		 * this Mollie customer ID the WordPress user and subscription.
551
		 * This can be useful in case when a WordPress user is created after
552
		 * a successful payment.
553
		 *
554
		 * @link https://www.gravityforms.com/add-ons/user-registration/
555
		 */
556
		$mollie_customer_id = $mollie_payment->get_customer_id();
557
558
		if ( null !== $mollie_customer_id ) {
559
			$mollie_customer = new Customer( $mollie_customer_id );
560
561
			$customer_internal_id = $this->customer_data_store->get_or_insert_customer(
0 ignored issues
show
Unused Code introduced by
The assignment to $customer_internal_id is dead and can be removed.
Loading history...
562
				$mollie_customer,
563
				array(
564
					'profile_id' => $profile_internal_id,
565
				),
566
				array(
567
					'profile_id' => '%s',
568
				)
569
			);
570
571
			// Customer.
572
			$customer = $payment->get_customer();
573
574
			if ( null !== $customer ) {
575
				// Connect to user.
576
				$user_id = $customer->get_user_id();
577
578
				if ( null !== $user_id ) {
579
					$user = \get_user_by( 'id', $user_id );
580
581
					if ( false !== $user ) {
582
						$this->customer_data_store->connect_mollie_customer_to_wp_user( $mollie_customer, $user );
583
					}
584
				}
585
			}
586
		}
587
588
		/**
589
		 * Customer ID.
590
		 */
591
		$mollie_customer_id = $mollie_payment->get_customer_id();
592
593
		if ( null !== $mollie_customer_id ) {
594
			$customer_id = $payment->get_meta( 'mollie_customer_id' );
595
596
			if ( empty( $customer_id ) ) {
597
				$payment->set_meta( 'mollie_customer_id', $mollie_customer_id );
598
			}
599
600
			foreach ( $payment->get_subscriptions() as $subscription ) {
601
				$customer_id = $subscription->get_meta( 'mollie_customer_id' );
602
603
				if ( empty( $customer_id ) ) {
604
					$subscription->set_meta( 'mollie_customer_id', $mollie_customer_id );
605
				}
606
			}
607
		}
608
609
		/**
610
		 * Mandate ID.
611
		 */
612
		$mollie_mandate_id = $mollie_payment->get_mandate_id();
613
614
		if ( null !== $mollie_mandate_id ) {
615
			$mandate_id = $payment->get_meta( 'mollie_mandate_id' );
616
617
			if ( empty( $mandate_id ) ) {
618
				$payment->set_meta( 'mollie_mandate_id', $mollie_mandate_id );
619
			}
620
621
			foreach ( $payment->get_subscriptions() as $subscription ) {
622
				$mandate_id = $subscription->get_meta( 'mollie_mandate_id' );
623
624
				if ( empty( $mandate_id ) ) {
625
					$subscription->set_meta( 'mollie_mandate_id', $mollie_mandate_id );
626
				}
627
			}
628
		}
629
630
		// phpcs:disable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase -- Mollie JSON object.
631
		$mollie_payment_details = $mollie_payment->get_details();
632
633
		if ( null !== $mollie_payment_details ) {
634
			$consumer_bank_details = $payment->get_consumer_bank_details();
635
636
			if ( null === $consumer_bank_details ) {
637
				$consumer_bank_details = new BankAccountDetails();
638
639
				$payment->set_consumer_bank_details( $consumer_bank_details );
640
			}
641
642
			if ( isset( $mollie_payment_details->consumerName ) ) {
643
				$consumer_bank_details->set_name( $mollie_payment_details->consumerName );
644
			}
645
646
			if ( isset( $mollie_payment_details->cardHolder ) ) {
647
				$consumer_bank_details->set_name( $mollie_payment_details->cardHolder );
648
			}
649
650
			if ( isset( $mollie_payment_details->cardNumber ) ) {
651
				// The last four digits of the card number.
652
				$consumer_bank_details->set_account_number( $mollie_payment_details->cardNumber );
653
			}
654
655
			if ( isset( $mollie_payment_details->cardCountryCode ) ) {
656
				// The ISO 3166-1 alpha-2 country code of the country the card was issued in.
657
				$consumer_bank_details->set_country( $mollie_payment_details->cardCountryCode );
658
			}
659
660
			if ( isset( $mollie_payment_details->consumerAccount ) ) {
661
				switch ( $mollie_payment->get_method() ) {
662
					case Methods::BELFIUS:
663
					case Methods::DIRECT_DEBIT:
664
					case Methods::IDEAL:
665
					case Methods::KBC:
666
					case Methods::SOFORT:
667
						$consumer_bank_details->set_iban( $mollie_payment_details->consumerAccount );
668
669
						break;
670
					case Methods::BANCONTACT:
671
					case Methods::BANKTRANSFER:
672
					case Methods::PAYPAL:
673
					default:
674
						$consumer_bank_details->set_account_number( $mollie_payment_details->consumerAccount );
675
676
						break;
677
				}
678
			}
679
680
			if ( isset( $mollie_payment_details->consumerBic ) ) {
681
				$consumer_bank_details->set_bic( $mollie_payment_details->consumerBic );
682
			}
683
684
			/*
685
			 * Failure reason.
686
			 */
687
			$failure_reason = $payment->get_failure_reason();
688
689
			if ( null === $failure_reason ) {
690
				$failure_reason = new FailureReason();
691
			}
692
693
			// SEPA Direct Debit.
694
			if ( isset( $mollie_payment_details->bankReasonCode ) ) {
695
				$failure_reason->set_code( $mollie_payment_details->bankReasonCode );
696
			}
697
698
			if ( isset( $mollie_payment_details->bankReason ) ) {
699
				$failure_reason->set_message( $mollie_payment_details->bankReason );
700
			}
701
702
			// Credit card.
703
			if ( isset( $mollie_payment_details->failureReason ) ) {
704
				$failure_reason->set_code( $mollie_payment_details->failureReason );
705
			}
706
707
			if ( isset( $mollie_payment_details->failureMessage ) ) {
708
				$failure_reason->set_message( $mollie_payment_details->failureMessage );
709
			}
710
711
			$failure_code    = $failure_reason->get_code();
712
			$failure_message = $failure_reason->get_message();
713
714
			if ( ! empty( $failure_code ) || ! empty( $failure_message ) ) {
715
				$payment->set_failure_reason( $failure_reason );
716
			}
717
		}
718
719
		$links = $mollie_payment->get_links();
720
721
		// Change payment state URL.
722
		if ( \property_exists( $links, 'changePaymentState' ) ) {
723
			$payment->set_meta( 'mollie_change_payment_state_url', $links->changePaymentState->href );
724
		}
725
726
		// phpcs:enable WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase -- Mollie JSON object.
727
728
		if ( $mollie_payment->has_chargebacks() ) {
729
			$mollie_chargebacks = $this->client->get_payment_chargebacks(
730
				$mollie_payment->get_id(),
731
				array( 'limit' => 1 )
732
			);
733
734
			$mollie_chargeback = \reset( $mollie_chargebacks );
735
736
			if ( false !== $mollie_chargeback ) {
737
				$subscriptions = array_filter(
738
					$payment->get_subscriptions(),
739
					function ( $subscription ) {
740
						return SubscriptionStatus::ACTIVE === $subscription->get_status();
741
					}
742
				);
743
744
				foreach ( $subscriptions as $subscription ) {
745
					if ( $mollie_chargeback->get_created_at() > $subscription->get_activated_at() ) {
746
						$subscription->set_status( SubscriptionStatus::ON_HOLD );
747
748
						$subscription->add_note(
749
							\sprintf(
750
								/* translators: 1: Mollie chargeback ID, 2: Mollie payment ID */
751
								\__( 'Subscription put on hold due to chargeback `%1$s` of payment `%2$s`.', 'pronamic_ideal' ),
752
								\esc_html( $mollie_chargeback->get_id() ),
753
								\esc_html( $mollie_payment->get_id() )
754
							)
755
						);
756
					}
757
				}
758
			}
759
		}
760
761
		// Refunds.
762
		$amount_refunded = $mollie_payment->get_amount_refunded();
763
764
		if ( null !== $amount_refunded ) {
765
			$refunded_amount = new Money( $amount_refunded->get_value(), $amount_refunded->get_currency() );
766
767
			$payment->set_refunded_amount( $refunded_amount->get_value() > 0 ? $refunded_amount : null );
768
		}
769
770
		// Save.
771
		$payment->save();
772
773
		foreach ( $payment->get_subscriptions() as $subscription ) {
774
			$subscription->save();
775
		}
776
	}
777
778
	/**
779
	 * Update subscription mandate.
780
	 *
781
	 * @param Subscription $subscription   Subscription.
782
	 * @param string       $mandate_id     Mollie mandate ID.
783
	 * @param string|null  $payment_method Payment method.
784
	 * @return void
785
	 * @throws \Exception Throws exception if subscription note could not be added.
786
	 */
787
	public function update_subscription_mandate( Subscription $subscription, $mandate_id, $payment_method = null ) {
788
		$customer_id = (string) $subscription->get_meta( 'mollie_customer_id' );
789
790
		$mandate = $this->client->get_mandate( $mandate_id, $customer_id );
791
792
		if ( ! \is_object( $mandate ) ) {
793
			return;
794
		}
795
796
		// Update mandate.
797
		$old_mandate_id = $subscription->get_meta( 'mollie_mandate_id' );
798
799
		$subscription->set_meta( 'mollie_mandate_id', $mandate_id );
800
801
		if ( ! empty( $old_mandate_id ) && $old_mandate_id !== $mandate_id ) {
802
			$note = \sprintf(
803
			/* translators: 1: old mandate ID, 2: new mandate ID */
804
				\__( 'Mandate for subscription changed from "%1$s" to "%2$s".', 'pronamic_ideal' ),
805
				\esc_html( $old_mandate_id ),
806
				\esc_html( $mandate_id )
807
			);
808
809
			$subscription->add_note( $note );
810
		}
811
812
		// Update payment method.
813
		$old_method = $subscription->get_payment_method();
0 ignored issues
show
Bug introduced by
The method get_payment_method() does not exist on Pronamic\WordPress\Pay\Subscriptions\Subscription. Did you maybe mean get_payments()? ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

813
		/** @scrutinizer ignore-call */ 
814
  $old_method = $subscription->get_payment_method();

This check looks for calls to methods that do not seem to exist on a given type. It looks for the method on the type itself as well as in inherited classes or implemented interfaces.

This is most likely a typographical error or the method has been renamed.

Loading history...
814
		$new_method = ( null === $payment_method && \property_exists( $mandate, 'method' ) ? Methods::transform_gateway_method( $mandate->method ) : $payment_method );
815
816
		// `Direct Debit` is not a recurring method, use `Direct Debit (mandate via ...)` instead.
817
		if ( PaymentMethods::DIRECT_DEBIT === $new_method ) {
818
			$new_method = PaymentMethods::DIRECT_DEBIT_IDEAL;
819
820
			// Use `Direct Debit (mandate via Bancontact)` if consumer account starts with `BE`.
821
			if ( \property_exists( $mandate, 'details' ) && 'BE' === \substr( $mandate->details->consumerAccount, 0, 2 ) ) {
822
				$new_method = PaymentMethods::DIRECT_DEBIT_BANCONTACT;
823
			}
824
		}
825
826
		if ( ! empty( $old_method ) && $old_method !== $new_method ) {
827
			$subscription->set_payment_method( $new_method );
0 ignored issues
show
Bug introduced by
The method set_payment_method() does not exist on Pronamic\WordPress\Pay\Subscriptions\Subscription. ( Ignorable by Annotation )

If this is a false-positive, you can also ignore this issue in your code via the ignore-call  annotation

827
			$subscription->/** @scrutinizer ignore-call */ 
828
                  set_payment_method( $new_method );

This check looks for calls to methods that do not seem to exist on a given type. It looks for the method on the type itself as well as in inherited classes or implemented interfaces.

This is most likely a typographical error or the method has been renamed.

Loading history...
828
829
			// Add note.
830
			$note = \sprintf(
831
				/* translators: 1: old payment method, 2: new payment method */
832
				\__( 'Payment method for subscription changed from "%1$s" to "%2$s".', 'pronamic_ideal' ),
833
				\esc_html( (string) PaymentMethods::get_name( $old_method ) ),
834
				\esc_html( (string) PaymentMethods::get_name( $new_method ) )
835
			);
836
837
			$subscription->add_note( $note );
838
		}
839
840
		$subscription->save();
841
	}
842
843
	/**
844
	 * Create refund.
845
	 *
846
	 * @param string $transaction_id Transaction ID.
847
	 * @param Money  $amount         Amount to refund.
848
	 * @param string $description    Refund reason.
849
	 * @return string
850
	 */
851
	public function create_refund( $transaction_id, Money $amount, $description = null ) {
852
		$request = new RefundRequest( AmountTransformer::transform( $amount ) );
853
854
		// Metadata payment ID.
855
		$payment = \get_pronamic_payment_by_transaction_id( $transaction_id );
856
857
		if ( null !== $payment ) {
858
			$request->set_metadata(
859
				array(
860
					'pronamic_payment_id' => $payment->get_id(),
861
				)
862
			);
863
		}
864
865
		// Description.
866
		if ( ! empty( $description ) ) {
867
			$request->set_description( $description );
868
		}
869
870
		$refund = $this->client->create_refund( $transaction_id, $request );
871
872
		return $refund->get_id();
873
	}
874
875
	/**
876
	 * Get Mollie customer ID for payment.
877
	 *
878
	 * @param Payment $payment Payment.
879
	 * @return string|null
880
	 */
881 10
	public function get_customer_id_for_payment( Payment $payment ) {
882 10
		$customer_ids = $this->get_customer_ids_for_payment( $payment );
883
884 10
		$customer_id = $this->get_first_existing_customer_id( $customer_ids );
885
886 10
		return $customer_id;
887
	}
888
889
	/**
890
	 * Get Mollie customers for the specified payment.
891
	 *
892
	 * @param Payment $payment Payment.
893
	 * @return array<string>
894
	 */
895 10
	private function get_customer_ids_for_payment( Payment $payment ) {
896 10
		$customer_ids = array();
897
898
		// Customer ID from subscription meta.
899 10
		$subscription = $payment->get_subscription();
900
901 10
		if ( null !== $subscription ) {
902 10
			$customer_id = $this->get_customer_id_for_subscription( $subscription );
903
904 10
			if ( null !== $customer_id ) {
905 4
				$customer_ids[] = $customer_id;
906
			}
907
		}
908
909
		// Customer ID from WordPress user.
910 10
		$customer = $payment->get_customer();
911
912 10
		if ( null !== $customer ) {
913 10
			$user_id = $customer->get_user_id();
914
915 10
			if ( ! empty( $user_id ) ) {
916 7
				$user_customer_ids = $this->get_customer_ids_for_user( $user_id );
917
918 7
				$customer_ids = \array_merge( $customer_ids, $user_customer_ids );
919
			}
920
		}
921
922 10
		return $customer_ids;
923
	}
924
925
	/**
926
	 * Get Mollie customers for the specified WordPress user ID.
927
	 *
928
	 * @param int $user_id WordPress user ID.
929
	 * @return array<string>
930
	 */
931 24
	public function get_customer_ids_for_user( $user_id ) {
932 24
		$customer_query = new CustomerQuery(
933
			array(
934 24
				'user_id' => $user_id,
935
			)
936
		);
937
938 24
		$customers = $customer_query->get_customers();
939
940 24
		$customer_ids = wp_list_pluck( $customers, 'mollie_id' );
941
942 24
		return $customer_ids;
943
	}
944
945
	/**
946
	 * Get customer ID for subscription.
947
	 *
948
	 * @param Subscription $subscription Subscription.
949
	 * @return string|null
950
	 */
951 10
	private function get_customer_id_for_subscription( Subscription $subscription ) {
952 10
		$customer_id = $subscription->get_meta( 'mollie_customer_id' );
953
954 10
		if ( empty( $customer_id ) ) {
955
			// Try to get (legacy) customer ID from first payment.
956 7
			$first_payment = $subscription->get_first_payment();
957
958 7
			if ( null !== $first_payment ) {
959 7
				$customer_id = $first_payment->get_meta( 'mollie_customer_id' );
960
			}
961
		}
962
963 10
		if ( empty( $customer_id ) ) {
964 6
			return null;
965
		}
966
967 4
		return $customer_id;
968
	}
969
970
	/**
971
	 * Get first existing customer from customers list.
972
	 *
973
	 * @param array<string> $customer_ids Customers.
974
	 * @return string|null
975
	 * @throws Error Throws error on Mollie error.
976
	 */
977 10
	private function get_first_existing_customer_id( $customer_ids ) {
978 10
		$customer_ids = \array_filter( $customer_ids );
979
980 10
		$customer_ids = \array_unique( $customer_ids );
981
982 10
		foreach ( $customer_ids as $customer_id ) {
983
			try {
984 4
				$customer = $this->client->get_customer( $customer_id );
985
			} catch ( Error $error ) {
986
				// Check for status 410 ("Gone - The customer is no longer available").
987
				if ( 410 === $error->get_status() ) {
988
					continue;
989
				}
990
991
				throw $error;
992
			}
993
994 4
			if ( null !== $customer ) {
995 4
				return $customer_id;
996
			}
997
		}
998
999 6
		return null;
1000
	}
1001
1002
	/**
1003
	 * Create customer for payment.
1004
	 *
1005
	 * @param Payment $payment Payment.
1006
	 * @return string|null
1007
	 * @throws Error Throws Error when Mollie error occurs.
1008
	 * @throws \Exception Throws exception when error in customer data store occurs.
1009
	 */
1010
	private function create_customer_for_payment( Payment $payment ) {
1011
		$mollie_customer = new Customer();
1012
		$mollie_customer->set_mode( $this->config->is_test_mode() ? 'test' : 'live' );
1013
		$mollie_customer->set_email( $payment->get_email() );
1014
1015
		$pronamic_customer = $payment->get_customer();
1016
1017
		if ( null !== $pronamic_customer ) {
1018
			// Name.
1019
			$name = (string) $pronamic_customer->get_name();
1020
1021
			if ( '' !== $name ) {
1022
				$mollie_customer->set_name( $name );
1023
			}
1024
1025
			// Locale.
1026
			$locale = $pronamic_customer->get_locale();
1027
1028
			if ( null !== $locale ) {
1029
				$mollie_customer->set_locale( LocaleHelper::transform( $locale ) );
1030
			}
1031
		}
1032
1033
		// Try to get name from consumer bank details.
1034
		$consumer_bank_details = $payment->get_consumer_bank_details();
1035
1036
		if ( null === $mollie_customer->get_name() && null !== $consumer_bank_details ) {
1037
			$name = $consumer_bank_details->get_name();
1038
1039
			if ( null !== $name ) {
1040
				$mollie_customer->set_name( $name );
1041
			}
1042
		}
1043
1044
		// Create customer.
1045
		$mollie_customer = $this->client->create_customer( $mollie_customer );
1046
1047
		$customer_id = $this->customer_data_store->insert_customer( $mollie_customer );
0 ignored issues
show
Unused Code introduced by
The assignment to $customer_id is dead and can be removed.
Loading history...
1048
1049
		// Connect to user.
1050
		if ( null !== $pronamic_customer ) {
1051
			$user_id = $pronamic_customer->get_user_id();
1052
1053
			if ( null !== $user_id ) {
1054
				$user = \get_user_by( 'id', $user_id );
1055
1056
				if ( false !== $user ) {
1057
					$this->customer_data_store->connect_mollie_customer_to_wp_user( $mollie_customer, $user );
1058
				}
1059
			}
1060
		}
1061
1062
		// Store customer ID in subscription meta.
1063
		$subscription = $payment->get_subscription();
1064
1065
		if ( null !== $subscription ) {
1066
			$subscription->set_meta( 'mollie_customer_id', $mollie_customer->get_id() );
1067
		}
1068
1069
		return $mollie_customer->get_id();
1070
	}
1071
1072
	/**
1073
	 * Copy Mollie customer ID from subscription meta to WordPress user meta.
1074
	 *
1075
	 * @param Payment $payment Payment.
1076
	 * @return void
1077
	 */
1078 27
	public function copy_customer_id_to_wp_user( Payment $payment ) {
1079 27
		if ( $this->config->id !== $payment->config_id ) {
1080 1
			return;
1081
		}
1082
1083
		// Subscription.
1084 26
		$subscription = $payment->get_subscription();
1085
1086
		// Customer.
1087 26
		$customer = $payment->get_customer();
1088
1089 26
		if ( null === $customer && null !== $subscription ) {
1090 16
			$customer = $subscription->get_customer();
1091
		}
1092
1093 26
		if ( null === $customer ) {
1094
			return;
1095
		}
1096
1097
		// WordPress user.
1098 26
		$user_id = $customer->get_user_id();
1099
1100 26
		if ( null === $user_id ) {
1101 3
			return;
1102
		}
1103
1104 23
		$user = \get_user_by( 'id', $user_id );
1105
1106 23
		if ( false === $user ) {
1107 12
			return;
1108
		}
1109
1110
		// Customer IDs.
1111 11
		$customer_ids = array();
1112
1113
		// Payment.
1114 11
		$customer_ids[] = $payment->get_meta( 'mollie_customer_id' );
1115
1116
		// Subscription.
1117 11
		if ( null !== $subscription ) {
1118 11
			$customer_ids[] = $subscription->get_meta( 'mollie_customer_id' );
1119
		}
1120
1121
		// Connect.
1122 11
		$customer_ids = \array_filter( $customer_ids );
1123 11
		$customer_ids = \array_unique( $customer_ids );
1124
1125 11
		foreach ( $customer_ids as $customer_id ) {
1126 2
			$customer = new Customer( $customer_id );
1127
1128 2
			$this->customer_data_store->get_or_insert_customer( $customer );
1129
1130 2
			$this->customer_data_store->connect_mollie_customer_to_wp_user( $customer, $user );
1131
		}
1132 11
	}
1133
}
1134