Add filter to payment status

[devbanana]

Issue: PCP-582

Ticket:

Slack Thread:

---

Description

Adds a filter for the status of authorized payments.

Steps to Test

Documentation

• This PR needs documentation (has the "Documentation" label).

Changelog Entry

Enter a summary of all changes on this Pull Request. This will appear in the changelog if accepted.

[AlexP11223]

Most of the filters in this plugin use woocommerce_paypal_payments_ prefix.

[AlexP11223]

We check statuses in several places. Something could be broken here if someone changes the status via this filter. Maybe in some of these places we simply need to add this filter.

woocommerce-paypal-payments/modules/ppcp-wc-gateway/src/WCGatewayModule.php

Lines 247 to 257 in 8118da2

	if ( ! is_a( $wc_order, WC_Order::class ) || $wc_order->get_status() !== 'on-hold' ) {
	return;
	}
	if ( $order_status->name() !== OrderStatus::COMPLETED ) {
	$message = __(
	'Could not process WC order because PAYMENT.CAPTURE.COMPLETED webhook not received.',
	'woocommerce-paypal-payments'
	);
	$logger->error( $message );
	$wc_order->update_status( 'failed', $message );

woocommerce-paypal-payments/modules/ppcp-webhooks/src/Handler/CheckoutOrderCompleted.php

Lines 139 to 142 in 8118da2

	if ( ! in_array( $wc_order->get_status(), array( 'pending', 'on-hold' ), true ) ) {
	continue;
	}
	$wc_order->payment_complete();

woocommerce-paypal-payments/modules/ppcp-webhooks/src/Handler/CheckoutOrderApproved.php

Lines 196 to 206 in 8118da2

	if ( ! in_array( $wc_order->get_status(), array( 'pending', 'on-hold' ), true ) ) {
	continue;
	}
	if ( $order->intent() === 'CAPTURE' ) {
	$wc_order->payment_complete();
	} else {
	$wc_order->update_status(
	'on-hold',
	__( 'Payment can be captured.', 'woocommerce-paypal-payments' )
	);
	}

woocommerce-paypal-payments/modules/ppcp-webhooks/src/Handler/PaymentCaptureCompleted.php

Lines 122 to 131 in 8118da2

	if ( $wc_order->get_status() !== 'on-hold' ) {
	$response['success'] = true;
	return new WP_REST_Response( $response );
	}
	$wc_order->add_order_note(
	__( 'Payment successfully captured.', 'woocommerce-paypal-payments' )
	);
	$wc_order->payment_complete();
	$wc_order->update_meta_data( AuthorizedPaymentsProcessor::CAPTURED_META_KEY, 'true' );

woocommerce-paypal-payments/modules/ppcp-vaulting/src/PaymentTokenChecker.php

Lines 113 to 115 in 125150a

	if ( $wc_order->get_status() === 'processing' || 'capture' !== $intent ) {
	return;
	}

woocommerce-paypal-payments/modules/ppcp-wc-gateway/src/Processor/AuthorizedPaymentsProcessor.php

Lines 181 to 188 in 635236c

	if ( self::ALREADY_CAPTURED === $result_status ) {
	if ( $wc_order->get_status() === 'on-hold' ) {
	$wc_order->add_order_note(
	__( 'Payment successfully captured.', 'woocommerce-paypal-payments' )
	);
	}
	$wc_order->update_meta_data( self::CAPTURED_META_KEY, 'true' );