9B534B8686E580E0E01768F00155B461

at path：ROOT / wp-content / plugins / tutor / ecommerce / CheckoutController.php

run：R W Run

Cart

DIR

2026-04-14 05:34:26

R W Run

PaymentGateways

DIR

2026-04-14 05:34:27

R W Run

AdminMenu.php

2.72 KB

2026-04-14 05:34:26

R W Run

BillingController.php

5.57 KB

2026-04-14 05:34:26

R W Run

CartController.php

6.78 KB

2026-04-14 05:34:26

R W Run

CheckoutController.php

38.15 KB

2026-04-14 05:34:26

R W Run

CouponController.php

24.64 KB

2026-04-14 05:34:26

R W Run

Ecommerce.php

5.37 KB

2026-04-14 05:34:27

R W Run

EmailController.php

25.54 KB

2026-04-14 05:34:27

R W Run

HooksHandler.php

17.26 KB

2026-04-14 05:34:27

R W Run

OptionKeys.php

1.81 KB

2026-04-14 05:34:27

R W Run

OrderActivitiesController.php

4.62 KB

2026-04-14 05:34:27

R W Run

OrderController.php

37.64 KB

2026-04-14 05:34:27

R W Run

PaymentHandler.php

3.96 KB

2026-04-14 05:34:27

R W Run

Settings.php

12.82 KB

2026-04-14 05:34:27

R W Run

Tax.php

6.66 KB

2026-04-14 05:34:27

R W Run

currency.php

27.67 KB

2026-04-14 05:34:26

R W Run

error_log

📄CheckoutController.php

<?php
/**
 * Manage Checkout
 *
 * @package Tutor\Ecommerce
 * @author Themeum
 * @link https://themeum.com
 * @since 3.0.0
 */

namespace Tutor\Ecommerce;

use TUTOR\Input;
use Tutor\Models\CartModel;
use Tutor\Models\OrderModel;
use Tutor\Models\CouponModel;
use Tutor\Models\CourseModel;
use Tutor\Helpers\QueryHelper;
use Tutor\Models\BillingModel;
use Tutor\Traits\JsonResponse;
use Tutor\Helpers\ValidationHelper;
use TutorPro\Ecommerce\GuestCheckout\GuestCheckout;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Checkout Controller class
 *
 * @since 3.0.0
 */
class CheckoutController {

use JsonResponse;

/**
	 * Page slug for checkout page
	 *
	 * @since 3.0.0
	 *
	 * @var string
	 */
	const PAGE_SLUG = 'checkout';

/**
	 * Page slug for checkout page
	 *
	 * @since 3.0.0
	 *
	 * @var string
	 */
	const PAGE_ID_OPTION_NAME = 'tutor_checkout_page_id';

/**
	 * Pay now error transient key
	 *
	 * @since 3.0.0
	 *
	 * @var string
	 */
	const PAY_NOW_ERROR_TRANSIENT_KEY = 'tutor_pay_now_errors_';

/**
	 * Pay now alert transient key
	 *
	 * @since 3.0.0
	 *
	 * @var string
	 */
	const PAY_NOW_ALERT_MSG_TRANSIENT_KEY = 'tutor_pay_now_alert_msg_';

/**
	 * Coupon model instance.
	 *
	 * @since 3.0.0
	 *
	 * @var CouponModel
	 */
	public $coupon_model;

/**
	 * Instance of order controller.
	 *
	 * @since 3.5.0
	 *
	 * @var OrderController
	 */
	public $order_ctrl;

/**
	 * Constructor.
	 *
	 * Initializes the Checkout class, sets the page title, and optionally registers
	 * hooks for handling AJAX requests related to cart data, bulk actions, cart updates,
	 * and cart deletions.
	 *
	 * @param bool $register_hooks Whether to register hooks for handling requests. Default is true.
	 *
	 * @since 3.0.0
	 *
	 * @return void
	 */
	public function __construct( $register_hooks = true ) {
		$this->coupon_model = new CouponModel();
		$this->order_ctrl   = new OrderController( false );

if ( $register_hooks ) {
			add_action( 'tutor_action_tutor_pay_now', array( $this, 'pay_now' ) );
			add_action( 'tutor_action_tutor_pay_incomplete_order', array( $this, 'pay_incomplete_order' ) );
			add_action( 'template_redirect', array( $this, 'restrict_checkout_page' ) );
			add_action( 'wp_ajax_tutor_get_checkout_html', array( $this, 'ajax_get_checkout_html' ) );
			add_action( 'tutor_before_checkout_order_details', array( $this, 'add_warning_alert' ) );
		}
	}

/**
	 * Get cart page url
	 *
	 * @since 3.0.0
	 *
	 * @return string
	 */
	public static function get_page_url() {
		return get_post_permalink( self::get_page_id() );
	}

/**
	 * Get cart page ID
	 *
	 * @since 3.0.0
	 *
	 * @return string
	 */
	public static function get_page_id() {
		return (int) tutor_utils()->get_option( self::PAGE_ID_OPTION_NAME );
	}

/**
	 * Create checkout page
	 *
	 * @since 3.0.0
	 *
	 * @return void
	 */
	public static function create_checkout_page() {
		$page_id = self::get_page_id();
		if ( ! $page_id ) {
			$args = array(
				'post_title'   => ucfirst( self::PAGE_SLUG ),
				'post_content' => '',
				'post_type'    => 'page',
				'post_status'  => 'publish',
			);

$page_id = wp_insert_post( $args );
			tutor_utils()->update_option( self::PAGE_ID_OPTION_NAME, $page_id );
		}
	}

/**
	 * Get checkout HTML
	 *
	 * @since 3.0.0
	 *
	 * @return void
	 */
	public function ajax_get_checkout_html() {
		tutor_utils()->check_nonce();

ob_start();
		tutor_load_template( 'ecommerce/checkout-details' );
		$content = ob_get_clean();

$this->json_response(
			__( 'Success', 'tutor' ),
			$content
		);
	}

/**
	 * Add warning alert to checkout details.
	 *
	 * @since 3.5.0
	 *
	 * @param array $course_list course list.
	 *
	 * @return void
	 */
	public function add_warning_alert( $course_list ) {
		/**
		 * Scenario: Guest checkout and buy now option enabled.
		 * Display a warning alert if the user attempts to purchase a course they are already enrolled in.
		 */
		$course_id = (int) Input::sanitize_request_data( 'course_id', 0 );
		if ( Settings::is_buy_now_enabled() && $course_id && tutor_utils()->is_enrolled( $course_id, get_current_user_id() ) ) {
			add_filter( 'tutor_checkout_enable_pay_now_btn', '__return_false' );
			?>
			<div class="tutor-alert tutor-warning tutor-d-flex tutor-gap-1">
				<span><?php esc_html_e( 'You\'re already enrolled in this course.', 'tutor' ); ?></span>
				<a href="<?php echo esc_url( get_the_permalink( $course_id ) ); ?>"><?php esc_html_e( 'Start learning!', 'tutor' ); ?></a>
			</div>
			<?php
		}

/**
		 * Scenario: user login from the checkout page with courses in the cart.
		 * Display a warning alert if the user tries to purchase a course they are already enrolled in.
		 */
		if ( ! Settings::is_buy_now_enabled() && is_array( $course_list ) && count( $course_list ) ) {
			$enrolled_courses = array();
			foreach ( $course_list as $course ) {
				if ( tutor_utils()->is_enrolled( $course->ID, get_current_user_id() ) ) {
					$enrolled_courses[] = $course;
				}
			}

if ( count( $enrolled_courses ) ) {
				add_filter( 'tutor_checkout_enable_pay_now_btn', '__return_false' );
				?>
				<div class="tutor-alert tutor-warning">
					<div>
						<p class="tutor-mb-8">
						<?php
						if ( count( $enrolled_courses ) > 1 ) {
							esc_html_e( 'You are already enrolled in the following courses. Please remove those from your cart and continue.', 'tutor' );
						} else {
							esc_html_e( 'You are already enrolled in the following course. Please remove that from your cart and continue.', 'tutor' );
						}
						?>
						<a class="tutor-text-decoration-none tutor-color-primary" href="<?php echo esc_url( CartController::get_page_url() ); ?>"><?php esc_html_e( 'View Cart', 'tutor' ); ?></a>
						</p>
						<ul>
						<?php foreach ( $enrolled_courses as $course ) : ?>
							<li><a class="tutor-text-decoration-none tutor-color-primary" href="<?php echo esc_url( get_the_permalink( $course->ID ) ); ?>"><?php echo esc_html( $course->post_title ); ?></a></li>
						<?php endforeach; ?>
						</ul>
					</div>
				</div>
				<?php
			}
		}
	}

/**
	 * Check coupon is applied on checkout item.
	 *
	 * @param array $item checkout item.
	 *
	 * @return boolean applied or not.
	 */
	private function is_coupon_applied_on_item( array $item ) {
		return isset( $item['is_coupon_applied'] ) && (bool) $item['is_coupon_applied'];
	}

/**
	 * Prepare items
	 *
	 * @since 3.0.0
	 *
	 * @param array       $item_ids items.
	 * @param string      $order_type order type.
	 * @param object|null $coupon coupon.
	 *
	 * @return array
	 */
	private function prepare_items( $item_ids, $order_type = OrderModel::TYPE_SINGLE_ORDER, $coupon = null ) {
		$items     = array();
		$plan_info = null;

foreach ( $item_ids as $item_id ) {

if ( OrderModel::TYPE_SINGLE_ORDER === $order_type ) {
				$item_name    = get_the_title( $item_id );
				$course_price = tutor_utils()->get_raw_course_price( $item_id );

$regular_price = $course_price->regular_price;
				$sale_price    = $course_price->sale_price;

$item = array(
					'item_id'           => (int) $item_id,
					'item_name'         => $item_name,
					'regular_price'     => $regular_price,
					'sale_price'        => $sale_price ? $sale_price : null,
					'is_coupon_applied' => false,
					'coupon_code'       => null,
					'tax_collection'    => CourseModel::is_tax_enabled_for_single_purchase( $item_id ),
				);
			}

if ( OrderModel::TYPE_SUBSCRIPTION === $order_type ) {
				$item = apply_filters( 'tutor_checkout_subscription_item', array(), $item_id, $coupon );
			}

$is_coupon_applicable = false;
			if ( Settings::is_coupon_usage_enabled() && is_object( $coupon ) ) {
				$is_coupon_applicable = $this->coupon_model->is_coupon_applicable( $coupon, $item_id, $order_type );
				if ( $is_coupon_applicable ) {
					$item['is_coupon_applied'] = $is_coupon_applicable;
					$item['coupon_code']       = $coupon->coupon_code;
					$item['sale_price']        = null;
				}
			}

$items[] = $item;
		}

return array( $items, $plan_info );
	}

/**
	 * Calculate discount.
	 *
	 * @since 3.0.0
	 * @since 3.6.0 refactor and inaccurate flat discount distribution.
	 *
	 * @param array  $items item array.
	 * @param string $discount_type discount type. like percentage or fixed.
	 * @param float  $discount_value value of discount.
	 *
	 * @return array
	 */
	public function calculate_discount( $items, $discount_type, $discount_value ) {
		$final                              = array();
		$coupon_applied_items               = array();
		$total_regular_price_coupon_applied = 0;

foreach ( $items as $item ) {
			if ( $this->is_coupon_applied_on_item( $item ) ) {
				$coupon_applied_items[]              = $item;
				$total_regular_price_coupon_applied += $item['regular_price'];
			} else {
				$item['discount_amount'] = 0;
				$final[]                 = $item;
			}
		}

// For flat discount calculation.
		$cumulative_discount  = 0;
		$coupon_applied_count = count( $coupon_applied_items );

foreach ( $coupon_applied_items as $index => $item ) {
			$regular_price = $item['regular_price'];

if ( 'percentage' === $discount_type ) {
				// Limit percentage value between 0 and 100.
				$percentage   = max( 0, min( 100, (float) $discount_value ) );
				$raw_discount = $regular_price * ( $percentage / 100 );
				$discount     = round( $raw_discount, 2 );

// Prevent discount from exceeding the item price.
				$discount = min( $discount, $regular_price );

$discount_price = round( $regular_price - $discount, 2 );

$item['discount_amount'] = $discount;
				$item['discount_price']  = $discount_price;

} elseif ( 'flat' === $discount_type && $total_regular_price_coupon_applied > 0 ) {
				/**
				 * Apply a proportional fixed discount
				 * based on the total applied coupon item regular price.
				 */
				$proportion = $regular_price / $total_regular_price_coupon_applied;
				$discount   = $discount_value * $proportion;

/**
				 * On last item, fix rounding error.
				 *
				 * Example: $100 discount spread over 3 items
				 * could result in $33.33 + $33.33 + $33.33 = $99.99, losing 1 cent.
				 */
				if ( $index === $coupon_applied_count - 1 ) {
					$discount = $discount_value - $cumulative_discount;
				}

// Prevent discount from exceeding the item price.
				$discount       = min( $discount, $regular_price );
				$discount_price = $regular_price - $discount;

$item['discount_amount'] = round( $discount, 2 );
				$item['discount_price']  = round( $discount_price, 2 );
				$cumulative_discount    += round( $discount, 2 );
			}

$final[] = $item;
		}

return $final;
	}

/**
	 * Prepare checkout item with applying coupon if required.
	 *
	 * @since 3.0.0
	 *
	 * @since 3.3.0 is_coupon_applicable check added
	 *
	 * @param int|array $item_ids Required, course ids or plan id.
	 * @param string    $order_type order type.
	 * @param string    $coupon_code coupon code.
	 *
	 * @return object
	 */
	public function prepare_checkout_items( $item_ids, $order_type = OrderModel::TYPE_SINGLE_ORDER, $coupon_code = null ) {
		$item_ids = is_array( $item_ids ) ? $item_ids : array( $item_ids );
		$response = array();
		$user_id  = get_current_user_id();

$coupon_type       = empty( $coupon_code ) ? 'automatic' : 'manual';
		$is_coupon_applied = false;
		$coupon_title      = '';

$total_price     = 0;
		$subtotal_price  = 0;
		$coupon_discount = 0;
		$sale_discount   = 0;

$tax_exempt_price  = 0;
		$tax_exempt_amount = 0;

$coupon                  = null;
		$is_coupon_applied       = false;
		$is_meet_min_requirement = false;
		$selected_coupon         = null;

if ( Settings::is_coupon_usage_enabled() && '-1' !== $coupon_code ) {
			$selected_coupon = $this->coupon_model->get_coupon_details_for_checkout( $coupon_code );
			if ( ! $selected_coupon ) {
				$this->coupon_model->set_apply_coupon_error( $this->coupon_model->get_coupon_failed_error_msg( 'not_found' ) );
			}
		}

$is_valid = is_object( $selected_coupon ) && $this->coupon_model->is_coupon_valid( $selected_coupon );
		if ( $is_valid ) {
			$is_meet_min_requirement = $this->coupon_model->is_coupon_requirement_meet( $item_ids, $selected_coupon, $order_type );
			if ( $is_meet_min_requirement ) {
				$coupon = $selected_coupon;
			}
		}

list( $items, $plan_info ) = $this->prepare_items( $item_ids, $order_type, $coupon );

// Iterate with each item and check if coupon is applicable @since 3.3.0.
		$is_coupon_applicable = false;
		if ( $coupon ) {
			foreach ( $items as $item ) {
				if ( ! $is_coupon_applicable ) {
					$is_coupon_applicable = $this->coupon_model->is_coupon_applicable( $coupon, $item['item_id'], $order_type );
				}
			}
			if ( $is_coupon_applicable ) {
				$is_coupon_applied = true;
			}
		}

if ( $is_coupon_applied ) {
			$items        = $this->calculate_discount( $items, $coupon->discount_type, $coupon->discount_amount );
			$coupon_title = $coupon->coupon_title;
		}

$should_calculate_tax = Tax::should_calculate_tax();
		$tax_included         = Tax::is_tax_included_in_price();
		$tax_rate             = Tax::get_user_tax_rate();

// Keep calculated price for each item.
		foreach ( $items as $item ) {
			$discount_amount        = isset( $item['discount_amount'] ) ? $item['discount_amount'] : 0;
			$has_discount_amount    = $discount_amount > 0;
			$item['discount_price'] = $has_discount_amount ? max( 0, $item['discount_price'] ) : null;

$display_price         = isset( $item['sale_price'] ) ? $item['sale_price'] : $item['regular_price'];
			$display_price         = $has_discount_amount ? $item['discount_price'] : $display_price;
			$item['display_price'] = $display_price;

$item['tax_amount']          = 0;
			$item['tax_amount_readable'] = '';

if ( $should_calculate_tax ) {
				$tax_amount = Tax::calculate_tax( $display_price, $tax_rate );
				// translators: %1$s: tax amount %2$s: included text or empty string.
				$tax_amount_readable = sprintf( __( 'Tax: %1$s%2$s', 'tutor' ), tutor_get_formatted_price( $tax_amount ), $tax_included ? __( ' included', 'tutor' ) : '' );

$item['tax_amount']          = $tax_amount;
				$item['tax_amount_readable'] = $tax_amount_readable;
			}

$sale_discount_amount         = isset( $item['sale_price'] ) ? $item['regular_price'] - $item['sale_price'] : 0;
			$item['sale_discount_amount'] = $sale_discount_amount;

$response['items'][] = (object) $item;

$subtotal_price  += $item['regular_price'];
			$coupon_discount += $discount_amount;
			$sale_discount   += $sale_discount_amount;

$additional_items = $item['additional_items'] ?? array();
			foreach ( $additional_items as $additional_item ) {
				$subtotal_price += $additional_item['regular_price'] ?? 0;
			}

if ( isset( $item['tax_collection'] ) && false === $item['tax_collection'] ) {
				$tax_exempt_price += $display_price;
				$tax_exempt_price += array_sum( array_column( $additional_items, 'regular_price' ) );
			}
		}

$total_price = $subtotal_price - ( $coupon_discount + $sale_discount );
		$tax_amount  = 0;

if ( $should_calculate_tax ) {
			$tax_amount        = Tax::calculate_tax( $total_price, $tax_rate );
			$tax_exempt_amount = Tax::calculate_tax( $tax_exempt_price, $tax_rate );
			$tax_amount        = $tax_amount - $tax_exempt_amount;
		}

$total_price_without_tax = $total_price;
		if ( ! Tax::is_tax_included_in_price() ) {
			$total_price += $tax_amount;
		}

// Total price should not negative.
		$total_price = max( 0, $total_price );

$response['plan_info'] = $plan_info;

$response['total_items']       = tutor_utils()->count( $items );
		$response['coupon_type']       = $coupon_type;
		$response['coupon_code']       = $is_coupon_applied ? $coupon->coupon_code : null;
		$response['coupon_title']      = $coupon_title;
		$response['is_coupon_applied'] = $is_coupon_applied;

$response['subtotal_price']          = $subtotal_price;
		$response['coupon_discount']         = $coupon_discount;
		$response['sale_discount']           = $sale_discount;
		$response['tax_rate']                = $tax_rate;
		$response['total_price_without_tax'] = $total_price_without_tax;
		$response['tax_exempt_amount']       = $tax_exempt_amount;
		$response['tax_amount']              = $tax_amount;
		$response['total_price']             = $total_price;
		$response['order_type']              = $order_type;

$response['formatted_total_price_without_tax'] = tutor_get_formatted_price( $total_price_without_tax );
		$response['formatted_total_price']             = tutor_get_formatted_price( $total_price );

return (object) $response;
	}

/**
	 * Pay now ajax handler
	 * Create pending order, prepare payment data & proceed to payment gateway
	 *
	 * @since 3.0.0
	 *
	 * @return void
	 */
	public function pay_now() {
		$errors = array();
		if ( ! tutor_utils()->is_nonce_verified() ) {
			array_push( $errors, tutor_utils()->error_message( 'nonce' ) );
			set_transient( self::PAY_NOW_ALERT_MSG_TRANSIENT_KEY . 'pay_now_nonce_alert', $errors );
			return;
		}

global $wpdb;
		$order_data      = null;
		$billing_model   = new BillingModel();
		$current_user_id = get_current_user_id();

$is_guest_checkout_endabled = class_exists( 'TutorPro\Ecommerce\GuestCheckout\GuestCheckout' ) && GuestCheckout::is_enable();

// Pevent invalid request.
		if ( ! $current_user_id ) {
			if ( $is_guest_checkout_endabled ) {
				// Guest user.
				$current_user_id = wp_rand(); // A random id to iniquely indentify.
			} else {
				wp_die( esc_html( tutor_utils()->error_message( 'invalid_req' ) ) );
			}
		}

$request = Input::sanitize_array( $_POST ); //phpcs:ignore --sanitized.
		$order_id = Input::get( 'order_id', 0, Input::TYPE_INT );

if ( $order_id ) {
			$order_data = OrderModel::get_valid_incomplete_order( $order_id, get_current_user_id(), true );
			if ( ! $order_data || OrderModel::TYPE_SINGLE_ORDER !== $order_data->order_type ) {
				array_push( $errors, __( 'Invalid order', 'tutor' ) );
			}
		}

$billing_fillable_fields = array_intersect_key( $request, array_flip( $billing_model->get_fillable_fields() ) );

$order_payment_fields = array(
			'object_ids',
			'coupon_code',
			'payment_method',
			'payment_type',
			'order_type',
		);

$request = array_intersect_key( $request, array_flip( $order_payment_fields ) );
		// Set required.
		foreach ( $order_payment_fields as $field ) {
			if ( ! isset( $request[ $field ] ) ) {
				$request[ $field ] = '';
			}
		}

// Validate data.
		$validate = $this->validate_pay_now_req( $request );

if ( ! $validate->success ) {
			foreach ( $validate->errors as $error ) {
				if ( is_array( $error ) ) {
					foreach ( $error as $err ) {
						array_push( $errors, $err );
					}
				} else {
					array_push( $errors, $error );
				}
			}
		}

// Return if validation failed.
		if ( ! empty( $errors ) ) {
			set_transient( self::PAY_NOW_ERROR_TRANSIENT_KEY . $current_user_id, $errors );
			return;
		}

$object_ids     = array_filter( explode( ',', $request['object_ids'] ), 'is_numeric' );
		$coupon_code    = isset( $request['coupon_code'] ) ? $request['coupon_code'] : '';
		$payment_method = $request['payment_method'];
		$payment_type   = 'free' === strtolower( $payment_method ) ? 'manual' : $request['payment_type'];
		$order_type     = $request['order_type'];

if ( empty( $object_ids ) ) {
			array_push( $errors, __( 'Invalid cart items', 'tutor' ) );
		} elseif ( OrderModel::TYPE_SINGLE_ORDER === $order_type ) {
			foreach ( $object_ids as $object_id ) {
				if ( ! in_array( get_post_type( $object_id ), array( tutor()->course_post_type, tutor()->bundle_post_type ), true ) ) {
					// translators: %s is the course title.
					array_push( $errors, sprintf( __( 'Invalid item: %s', 'tutor' ), get_the_title( $object_id ) ) );
				}
			}
		} elseif ( OrderModel::TYPE_SUBSCRIPTION === $order_type ) {
			$item_id = $object_ids[0] ?? 0;
			if ( $item_id ) {
				$plan = apply_filters( 'tutor_get_plan_info', null, $item_id );
				if ( ! $plan ) {
					array_push( $errors, __( 'Invalid plan', 'tutor' ) );
				}
			} else {
				array_push( $errors, __( 'Invalid plan', 'tutor' ) );
			}
		} else {
			array_push( $errors, __( 'Invalid order type', 'tutor' ) );
		}

if ( ! empty( $errors ) ) {
			set_transient( self::PAY_NOW_ERROR_TRANSIENT_KEY . $current_user_id, $errors );
			return;
		}

$billing_info = $billing_model->get_info( $current_user_id );
		if ( $billing_info ) {
			$update_billing = $billing_model->update( $billing_fillable_fields, array( 'user_id' => $current_user_id ) );
			if ( ! $update_billing ) {
				array_push( $errors, __( 'Billing information update failed!', 'tutor' ) );
			}
		} else {
			// Save billing info.
			$billing_fillable_fields['user_id'] = $current_user_id;

$save = $billing_model->insert( $billing_fillable_fields );
			if ( ! $save ) {
				array_push( $errors, __( 'Billing info save failed!', 'tutor' ) );
			}
		}

$checkout_data = $this->prepare_checkout_items( $object_ids, $order_type, $coupon_code );

if ( $checkout_data->total_price > 0 && 'free' === $payment_method ) {
			array_push( $errors, __( 'Select a payment method', 'tutor' ) );
		}

$items = array();
		foreach ( $checkout_data->items as $item ) {
			$items[] = array(
				'item_id'        => $item->item_id,
				'regular_price'  => $item->regular_price,
				'sale_price'     => $item->sale_price,
				'discount_price' => $item->discount_price,
				'coupon_code'    => $item->is_coupon_applied ? $item->coupon_code : null,
			);
		}

$args = apply_filters(
			'tutor_order_create_args',
			array(
				'payment_method'  => $payment_method,
				'coupon_amount'   => $checkout_data->coupon_discount,
				'discount_amount' => $checkout_data->sale_discount,
			)
		);

if ( empty( $errors ) ) {
			if ( ! is_user_logged_in() ) {
				$guest_user = apply_filters( 'tutor_guest_user_id', $current_user_id, $order_data, $billing_fillable_fields );
				if ( is_wp_error( $guest_user ) ) {
					// Delete the billing info if user registration failed.
					QueryHelper::delete( "{$wpdb->prefix}tutor_customers", array( 'user_id' => $current_user_id ) );

add_filter( 'tutor_checkout_user_id', fn () => $current_user_id );

// translators: wp error message.
					$error_msg = sprintf( esc_html_x( 'Order placement failed. %s', 'guest checkout', 'tutor' ), $guest_user->get_error_message() );
					set_transient(
						self::PAY_NOW_ERROR_TRANSIENT_KEY . $current_user_id,
						array(
							'message' => $error_msg,
						)
					);
					return;
				} else {
					$current_user_id = $guest_user;
				}
			}

if ( ! empty( $order_data ) ) {
				$order_data = $this->order_ctrl->update_order(
					$order_id,
					$current_user_id,
					$items,
					OrderModel::PAYMENT_UNPAID,
					$order_type,
					$checkout_data->coupon_code,
					$args,
					true
				);
			} else {
				$order_data = $this->order_ctrl->create_order(
					$current_user_id,
					$items,
					OrderModel::PAYMENT_UNPAID,
					$order_type,
					$checkout_data->coupon_code,
					$args,
					false
				);
			}

if ( ! empty( $order_data ) ) {
				if ( 'automate' === $payment_type ) {
					try {
						$payment_data = self::prepare_payment_data( $order_data );
						$this->proceed_to_payment( $payment_data, $payment_method, $order_type );
					} catch ( \Throwable $th ) {
						tutor_log( $th );
						tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_FAILED, $order_data['id'], $th->getMessage() );
					}
				} else {
					// Set alert message session.
					$this->set_pay_now_alert_msg( $order_data );
					tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_SUCCESS, $order_data['id'] );
				}
			} else {
				array_push( $errors, __( 'Failed to place order!', 'tutor' ) );
				set_transient( self::PAY_NOW_ERROR_TRANSIENT_KEY . $current_user_id, $errors );
				$this->set_pay_now_alert_msg( $order_data );
			}
		} else {
			set_transient( self::PAY_NOW_ERROR_TRANSIENT_KEY . $current_user_id, $errors );
			$this->set_pay_now_alert_msg( $order_data );
		}
	}

/**
	 * Prepare payment data
	 *
	 * @since 3.0.0
	 *
	 * @param array $order Order object.
	 *
	 * @return mixed
	 */
	public static function prepare_payment_data( array $order ) {
		$site_name     = get_bloginfo( 'name' );
		$order_id      = $order['id'];
		$order_user_id = $order['user_id'];
		$user_data     = get_userdata( $order_user_id );

$items          = array();
		$subtotal_price = $order['subtotal_price'];
		$total_price    = $order['total_price'];
		$grand_total    = $total_price;
		$order_type     = $order['order_type'];

$currency_code   = tutor_utils()->get_option( OptionKeys::CURRENCY_CODE, 'USD' );
		$currency_symbol = tutor_get_currency_symbol_by_code( $currency_code );
		$currency_info   = tutor_get_currencies_info_by_code( $currency_code );

$billing_info = ( new BillingModel() )->get_info( $order_user_id );

$country_info = tutor_get_country_info_by_name( $billing_info->billing_country );

$country = (object) array(
			'name'         => $country_info['name'],
			'numeric_code' => $country_info['numeric_code'],
			'alpha_2'      => $country_info['alpha_2'],
			'alpha_3'      => $country_info['alpha_3'],
			'phone_code'   => $country_info['phone_code'],
		);

$billing_name = $billing_info ? trim( $billing_info->billing_first_name . ' ' . $billing_info->billing_last_name ) : $user_data->display_name;

$shipping_and_billing = array(
			'name'         => $billing_name,
			'address1'     => $billing_info->billing_address ?? '',
			'address2'     => $billing_info->billing_address ?? '',
			'city'         => $billing_info->billing_city ?? '',
			'state'        => $billing_info->billing_state ?? '',
			'region'       => '',
			'postal_code'  => $billing_info->billing_zip_code ?? '',
			'country'      => $country,
			'phone_number' => $billing_info->billing_phone ?? '',
			'email'        => $billing_info->billing_email ?? '',
		);

$customer_info = $shipping_and_billing;

foreach ( $order['items'] as $item ) {
			$item    = (object) $item;
			$item_id = $item->item_id ?? $item->id;

if ( OrderModel::TYPE_SINGLE_ORDER === $order_type ) {
				$items[] = array(
					'item_id'          => $item_id,
					'item_name'        => get_the_title( $item_id ),
					'regular_price'    => $item->sale_price > 0 ? $item->sale_price : $item->regular_price,
					'quantity'         => 1,
					'discounted_price' => is_null( $item->discount_price ) || '' === $item->discount_price ? null : $item->discount_price,
				);
			}

if ( OrderModel::TYPE_SUBSCRIPTION === $order_type ) {
				$subscription_items = apply_filters( 'tutor_checkout_subscription_payment_items', array(), $item, $order_id );
				foreach ( $subscription_items as $subscription_item ) {
					$items[] = $subscription_item;
				}
			}
		}

if ( isset( $order['tax_amount'] ) && ! Tax::is_tax_included_in_price() ) {
			$grand_total += $order['tax_amount'];

/* translators: %s: tax rate */
			$tax_item = sprintf( __( 'Tax (%s)', 'tutor' ), $order['tax_rate'] . '%' );
			$items[]  = array(
				'item_id'          => 'tax',
				'item_name'        => $tax_item,
				'regular_price'    => $order['tax_amount'],
				'quantity'         => 1,
				'discounted_price' => null,
			);
		}

return (object) array(
			'items'              => (object) $items,
			'subtotal'           => floatval( $subtotal_price ),
			'total_price'        => floatval( $total_price ),
			'order_id'           => $order_id,
			'store_name'         => $site_name,
			'order_description'  => 'Tutor Order',
			'tax'                => 0,
			'currency'           => (object) array(
				'code'         => $currency_code,
				'symbol'       => $currency_symbol,
				'name'         => $currency_info['name'] ?? '',
				'locale'       => $currency_info['locale'] ?? '',
				'numeric_code' => $currency_info['numeric_code'] ?? '',
			),
			'country'            => $country,
			'shipping_charge'    => 0,
			'coupon_discount'    => 0,
			'shipping_address'   => (object) $shipping_and_billing,
			'billing_address'    => (object) $shipping_and_billing,
			'decimal_separator'  => tutor_utils()->get_option( OptionKeys::DECIMAL_SEPARATOR, '.' ),
			'thousand_separator' => tutor_utils()->get_option( OptionKeys::THOUSAND_SEPARATOR, '.' ),
			'customer'           => (object) $customer_info,
		);
	}

/**
	 * Prepare payment data
	 *
	 * @since 3.0.0
	 *
	 * @param int $order_id Order id.
	 *
	 * @throws \Exception Throw exception if order not found.
	 *
	 * @return mixed
	 */
	public static function prepare_recurring_payment_data( int $order_id ) {
		$order_data = ( new OrderModel() )->get_order_by_id( $order_id );
		if ( ! $order_data ) {
			throw new \Exception( __( 'Order not found!', 'tutor' ) );
		}

$amount = $order_data->total_price;

$order_user_id = $order_data->student->id;
		$user_data     = get_userdata( $order_user_id );

$billing_info = ( new BillingModel() )->get_info( $order_user_id );

$country_info = tutor_get_country_info_by_name( $billing_info->billing_country );

$billing_name = $billing_info ? trim( $billing_info->billing_first_name . ' ' . $billing_info->billing_last_name ) : $user_data->display_name;

$customer_info = $shipping_and_billing;

return (object) array(
			'type'             => 'recurring',
			'previous_payload' => $order_data->payment_payloads,
			'total_amount'     => floatval( $amount ),
			'sub_total_amount' => floatval( $amount ),
			'currency'         => (object) array(
				'code'         => $currency_code,
				'symbol'       => $currency_symbol,
				'name'         => $currency_info['name'] ?? '',
				'locale'       => $currency_info['locale'] ?? '',
				'numeric_code' => $currency_info['numeric_code'] ?? '',
			),
			'order_id'         => $order_id,
			'customer'         => (object) $customer_info,
			'shipping_address' => (object) $shipping_and_billing,
		);
	}

/**
	 * Proceed to payment
	 *
	 * @since 3.0.0
	 *
	 * @param mixed  $payment_data Payment data for making order.
	 * @param string $payment_method Payment method name.
	 * @param string $order_type Order type.
	 *
	 * @throws \Throwable Throw throwable if error occur.
	 * @throws \Exception Throw exception if payment gateway is invalid.
	 *
	 * @return void
	 */
	public function proceed_to_payment( $payment_data, $payment_method, $order_type ) {
		$payment_gateways = apply_filters( 'tutor_gateways_with_class', Ecommerce::payment_gateways_with_ref(), $payment_method );

$payment_gateway_class = isset( $payment_gateways[ $payment_method ] )
								? $payment_gateways[ $payment_method ]['gateway_class']
								: null;

if ( $payment_gateway_class ) {
			try {

add_filter(
					'tutor_ecommerce_webhook_url',
					function ( $url ) use ( $payment_method ) {
						$url = add_query_arg( array( 'payment_method' => $payment_method ), $url );
						return $url;
					}
				);

add_filter(
					'tutor_ecommerce_payment_success_url_args',
					function ( $args ) use ( $payment_data ) {
						$args['order_id'] = $payment_data->order_id;
						return $args;
					}
				);
				add_filter(
					'tutor_ecommerce_payment_cancelled_url_args',
					function ( $args ) use ( $payment_data ) {
						$args['order_id'] = $payment_data->order_id;
						return $args;
					}
				);

$gateway_instance = Ecommerce::get_payment_gateway_object( $payment_gateway_class );
				$gateway_instance->setup_payment_and_redirect( $payment_data );
			} catch ( \Throwable $th ) {
				throw $th;
			}
		} else {
			throw new \Exception( 'Invalid payment gateway class' );
		}
	}

/**
	 * Restrict checkout page
	 *
	 * @return void
	 */
	public function restrict_checkout_page() {
		$page_id = self::get_page_id();
		if ( ! $page_id || ! is_page( $page_id ) ) {
			return;
		}

$cart_page_url = CartController::get_page_url();

if ( ! is_user_logged_in() && ! apply_filters( 'tutor_is_guest_checkout_enabled', false ) ) {
			wp_safe_redirect( $cart_page_url );
			exit;
		}

$user_id       = tutils()->get_user_id();
		$cart_model    = new CartModel();
		$has_cart_item = $cart_model->has_item_in_cart( $user_id );
		$buy_now       = Settings::is_buy_now_enabled();
		$plan_id       = Input::get( 'plan', 0, Input::TYPE_INT );
		$order_id      = Input::get( 'order_id', 0, Input::TYPE_INT );

if ( ! $has_cart_item && ! $buy_now && ! $plan_id && ! $order_id ) {
			wp_safe_redirect( $cart_page_url );
			exit;
		}
	}

/**
	 * Set alert message on the session based on
	 * order data
	 *
	 * @since 3.0.0
	 *
	 * @param mixed $order_data Order data or null. If order
	 * data is falsy then failed message will be set.
	 *
	 * @return void
	 */
	private function set_pay_now_alert_msg( $order_data ) {
		$user_id = $order_data ? $order_data['user_id'] : get_current_user_id();
		if ( empty( $order_data ) ) {
			set_transient(
				self::PAY_NOW_ALERT_MSG_TRANSIENT_KEY . $user_id,
				array(
					'alert'   => 'danger',
					'message' => __( 'Failed to place order!', 'tutor' ),
				),
			);
		} else {
			set_transient(
				self::PAY_NOW_ALERT_MSG_TRANSIENT_KEY . $user_id,
				array(
					'alert'   => 'success',
					'message' => __( 'Your order has been placed successfully!', 'tutor' ),
				),
			);
		}
	}

/**
	 * Pay for the incomplete order
	 *
	 * Redirect to the payment gateway to complete the order
	 * After completing the process it will redirect user to
	 * order placement page
	 *
	 * @since 3.0.0
	 *
	 * @return void
	 */
	public function pay_incomplete_order() {

// Authentication check.
		if ( ! is_user_logged_in() ) {
			tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_FAILED, 0, __( 'Please log in first', 'tutor' ) );
		}

$order_id       = Input::post( 'order_id', 0, Input::TYPE_INT );
		$payment_method = Input::post( 'payment_method', '' );
		$request        = Input::sanitize_array( $_POST ); //phpcs:ignore -- $POST sanitized

$billing_model           = new BillingModel();
		$billing_fillable_fields = array_intersect_key( $request, array_flip( $billing_model->get_fillable_fields() ) );

if ( ! tutor_utils()->is_nonce_verified() ) {
			tutor_utils()->redirect_to( tutor_utils()->tutor_dashboard_url( 'purchase_history' ), tutor_utils()->error_message( 'nonce' ), 'error' );
			exit;
		}

if ( $order_id ) {
			$order_model = new OrderModel();
			$order_data  = $order_model->get_order_by_id( $order_id );
			if ( $order_data && get_current_user_id() === (int) $order_data->user_id ) {
				try {

if ( ! empty( $payment_method ) && OrderModel::PAYMENT_METHOD_MANUAL === $order_data->payment_method ) {
						$billing_info = $billing_model->get_info( $order_data->user_id );
						if ( $billing_info ) {
							$update_billing = $billing_model->update( $billing_fillable_fields, array( 'user_id' => $order_data->user_id ) );

if ( ! $update_billing ) {
								tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_FAILED, $order_data->id, __( 'Billing information update failed!', 'tutor' ) );
							}
						} else {
							// Save billing info.
							$billing_fillable_fields['user_id'] = $order_data->user_id;

$save = $billing_model->insert( $billing_fillable_fields );

if ( ! $save ) {
								tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_FAILED, $order_data->id, __( 'Billing info save failed!', 'tutor' ) );
							}
						}

$update_order_data                   = $order_model->get_recalculated_order_tax_data( $order_id );
						$update_order_data['payment_method'] = $payment_method;

$updated = $order_model->update_order( $order_data->id, $update_order_data );

if ( $updated ) {
							$order_data = $order_model->get_order_by_id( $order_id );
						}
					}

$payment_data = $this->prepare_payment_data( (array) $order_data, $payment_method ? $payment_method : $order_data->payment_method, $order_data->order_type );
					$this->proceed_to_payment( $payment_data, $payment_method ? $payment_method : $order_data->payment_method, $order_data->order_type );
				} catch ( \Throwable $th ) {
					tutor_log( $th );
					tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_FAILED, $order_data->id, $th->getMessage() );
				}
			} else {
				$error_msg = __( 'Order not found!', 'tutor' );
				tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_FAILED, $order_id, $error_msg );
			}
		} else {
			$error_msg = __( 'Invalid order ID!', 'tutor' );
			tutor_redirect_after_payment( OrderModel::ORDER_PLACEMENT_FAILED, $order_id, $error_msg );
		}
	}

/**
	 * Validate pay now request
	 *
	 * @since 3.0.0
	 *
	 * @param array $data The data array to validate.
	 *
	 * @return object The validation result. It returns validation object.
	 */
	protected function validate_pay_now_req( array $data ) {

$order_types = array(
			OrderModel::TYPE_SINGLE_ORDER,
			OrderModel::TYPE_SUBSCRIPTION,
			OrderModel::TYPE_RENEWAL,
		);

$order_types = implode( ',', $order_types );

$validation_rules = array(
			'object_ids'     => 'required',
			'order_type'     => "required|match_string:{$order_types}",
			'payment_method' => 'required',
		);

// Skip validation rules for not available fields in data.
		foreach ( $validation_rules as $key => $value ) {
			if ( ! array_key_exists( $key, $data ) ) {
				unset( $validation_rules[ $key ] );
			}
		}

return ValidationHelper::validate( $validation_rules, $data );
	}

/**
	 * Retrieve course data for a given set of order items.
	 *
	 * @since 3.9.0
	 *
	 * @param array $order_items Array of order item objects.
	 * @return array{
	 *     courses: array{
	 *         total_count: int,
	 *         results: \WP_Post[]
	 *     }
	 * }
	 */
	public function get_courses_data_by_order_items( $order_items ): array {

$results = array();

foreach ( $order_items as $item ) {

$course = get_post( $item->id );

if ( $course instanceof \WP_Post ) {
				$results[] = $course;
			}
		}

return array(
			'courses' => array(
				'total_count' => count( $results ),
				'results'     => $results,
			),
		);
	}
}

Exploring Learning Landscapes in Academic