Log exceptions during the payment process

changelog/woopmnt-5541-add-notes-or-logging-for-failed-orders

@@ -0,0 +1,4 @@
+Significance: minor
+Type: dev
+
+Log exceptions during the payment process.

includes/class-logger.php

@@ -7,6 +7,7 @@
 
 namespace WCPay;
 
+use Throwable;
 use WCPay\Internal\Logger as InternalLogger;
 
 defined( 'ABSPATH' ) || exit; // block direct access.
@@ -82,13 +83,35 @@ public static function critical( $message, $context = [] ) {
 	/**
 	 * Creates a log entry of type error
 	 *
-	 * @param string               $message To send to the log file.
-	 * @param array<string, mixed> $context Context data.
+	 * @param string               $message to send to the log file.
+	 * @param array<string, mixed> $context context data.
 	 */
 	public static function error( $message, $context = [] ) {
 		self::log( $message, 'error', $context );
 	}
 
+	/**
+	 * Creates a log entry for exception
+	 *
+	 * @param string               $message message to prepend to an exception.
+	 * @param Throwable            $e       exception to log.
+	 * @param array<string, mixed> $context context data.
+	 */
+	public static function exception( $message, $e, $context = [] ) {
+		self::error(
+			$message,
+			array_merge(
+				[
+					'exception' => get_class( $e ),
+					'message'   => $e->getMessage(),
+					'code'      => $e->getCode(),
+					'trace'     => $e->getTraceAsString(),
+				],
+				$context
+			)
+		);
+	}
+
 	/**
 	 * Creates a log entry of type warning
 	 *

includes/class-wc-payment-gateway-wcpay.php

@@ -1169,6 +1169,9 @@ public function process_payment( $order_id ) {
 			$payment_information = $this->prepare_payment_information( $order );
 			return $this->process_payment_for_order( WC()->cart, $payment_information );
 		} catch ( Exception $e ) {
+			// Log the exception.
+			Logger::exception( 'Error occurred during the payment process.', $e );
+
 			// We set this variable to be used in following checks.
 			$blocked_by_fraud_rules = $this->is_blocked_by_fraud_rules( $e );
 
@@ -2045,7 +2048,7 @@ public function process_redirect_payment( $order, $intent_id, $save_payment_meth
 				}
 			}
 		} catch ( Exception $e ) {
-			Logger::log( 'Error: ' . $e->getMessage() );
+			Logger::exception( 'Error occured during the redirect payment process.', $e );
 
 			$is_order_id_mismatched_exception =
 				$e instanceof Process_Payment_Exception