Создание платёжного шлюза WooCommerce

<?php
/*
 * Plugin Name: Платёжный плагин для WooCommerce от Миши
 * Plugin URI: https://misha.agency/woocommerce/sozdanie-platjozhnogo-shljuza.html
 * Description: Принимайте оплату по картам у себя на сайте!
 * Author: Миша Рудрастых
 * Author URI: https://misha.agency
 * Version: 1.0.1
 *

/*
 * Этот фильтр-хук позволяет зарегистрировать наш PHP-класс в качестве платёжного шлюза WooCommerce
 */
add_filter( 'woocommerce_payment_gateways', 'truemisha_register_gateway_class' );
 
function truemisha_register_gateway_class( $gateways ) {
	$gateways[] = 'WC_Truemisha_Gateway'; // название вашего класса, добавляем его в общий массив
	return $gateways;
}
 
/*
 * А дальше идёт сам класс, тоже обратите внимание, что он внутри хука plugins_loaded
 */
add_action( 'plugins_loaded', 'truemisha_gateway_class' );
function truemisha_gateway_class() {
 
	class WC_Truemisha_Gateway extends WC_Payment_Gateway {
 
 		/**
 		 * Это конструктор класса, о нём мы с вами ещё поговорим в 3-м шаге урока
 		 */
 		public function __construct() {
 
		...
 
 		}
 
		/**
 		 * Опции платёжного шлюза, тоже подробнее в 3-м шаге
 		 */
 		public function init_form_fields(){
 
		...
 
	 	}
 
		/**
		 * А этот метод пригодится, если захотите добавить форму ввода данных карты прямо на сайт
		 * Подробнее об этом мы поговорим в 4-м шаге
		 */
		public function payment_fields() {
 
		...
 
		}
 
		/*
		 * Для подключения дополнительных CSS и JS, нужны также для формы ввода карт и создания токена для них
		 */
	 	public function payment_scripts() {
 
		...
 
	 	}
 
		/*
 		 * Валидация полей, подробнее в шаге 5
		 */
		public function validate_fields() {
 
		...
 
		}
 
		/*
		 * Тут мы будем обрабатывать платёж, подробнее в шаге 5
		 */
		public function process_payment( $order_id ) {
 
		...
 
	 	}
 
		/*
		 * В том случае, если нам нужен хук, к которому будет обращаться банк для передачи ответа, типа PayPal IPN
		 */
		public function truemisha_webhook() {
 
		...
 
	 	}
 	}
}

public function __construct() {
 
	$this->id = 'truemisha'; // ID платёжног шлюза
	$this->icon = ''; // URL иконки, которая будет отображаться на странице оформления заказа рядом с этим методом оплаты
	$this->has_fields = true; // если нужна собственная форма ввода полей карты
	$this->method_title = 'Платёжный шлюз от Миши';
	$this->method_description = 'Описание платёжного шлюза от Миши'; // будет отображаться в админке
 
	// платёжные плагины могут поддерживать подписки, сохранённые карты, возвраты
	// но в пределах этого урока начнём с простых платежей, хотя в виде ниже будет чуть подробнее и о другом
	$this->supports = array(
		'products'
	);
 
	// тут хранятся все поля настроек
	$this->init_form_fields();
 
	// инициализируем настройки
	$this->init_settings();
	// название шлюза
	$this->title = $this->get_option( 'title' );
	// описание
	$this->description = $this->get_option( 'description' );
	// включен или выключен
	$this->enabled = $this->get_option( 'enabled' );
	// работает в тестовом режиме (sandbox) или нет
	$this->testmode = 'yes' === $this->get_option( 'testmode' );
	// и естественно отдельные ключи для тестового и рабочего режима шлюза
	$this->private_key = $this->testmode ? $this->get_option( 'test_private_key' ) : $this->get_option( 'private_key' );
	$this->publishable_key = $this->testmode ? $this->get_option( 'test_publishable_key' ) : $this->get_option( 'publishable_key' );
 
	// Хук для сохранения всех настроек, как видите, можно еще создать собственный метод process_admin_options() и закастомить всё
	add_action( 'woocommerce_update_options_payment_gateways_' . $this->id, array( $this, 'process_admin_options' ) );
 
	// Если будет генерировать токен из данных карты, то по-любому нужно будет подключать какой-то JS
	add_action( 'wp_enqueue_scripts', array( $this, 'payment_scripts' ) );
 
	// ну и хук тоже можете тут зарегистрировать
	// add_action( 'woocommerce_api_{webhook name}', array( $this, 'truemisha_webhook' ) );
 }

public function init_form_fields(){
 
	$this->form_fields = array(
		'enabled' => array(
			'title'       => 'Включен/Выключен',
			'label'       => 'Включить Мишин платёжный плагин',
			'type'        => 'checkbox',
			'description' => '',
			'default'     => 'no'
		),
		'title' => array(
			'title'       => 'Заголовок',
			'type'        => 'text',
			'description' => 'Это то, что пользователь увидит как название метода оплаты на странице оформления заказа.',
			'default'     => 'Оплатить картой',
			'desc_tip'    => true,
		),
		'description' => array(
			'title'       => 'Описание',
			'type'        => 'textarea',
			'description' => 'Описание этого метода оплаты, которое будет отображаться пользователю на странице оформления заказа.',
			'default'     => 'Оплатите при помощи карты легко и быстро.',
		),
		'testmode' => array(
			'title'       => 'Тестовый режим',
			'label'       => 'Включить тестовый режим',
			'type'        => 'checkbox',
			'description' => 'Хотите сначала протестировать с тестовыми ключами API?',
			'default'     => 'yes',
			'desc_tip'    => true,
		),
		'test_publishable_key' => array(
			'title'       => 'Тестовый публичный ключ',
			'type'        => 'text'
		),
		'test_private_key' => array(
			'title'       => 'Тестовый приватный ключ',
			'type'        => 'password',
		),
		'publishable_key' => array(
			'title'       => 'Публичный ключ',
			'type'        => 'text'
		),
		'private_key' => array(
			'title'       => 'Приватный ключ',
			'type'        => 'password'
		)
	);
}

public function payment_scripts() {
 
	// выходим, если находимся не на странице оформления заказа
	if ( ! is_cart() && ! is_checkout() && ! isset( $_GET['pay_for_order'] ) ) {
		return;
	}
 
	// наш платёжный плагин отключен? ничего не делаем
	if ( 'no' === $this->enabled ) {
		return;
	}
 
	// также нет смысла подключать JS, если плагин не настроен, не указаны API ключи
	if ( empty( $this->private_key ) || empty( $this->publishable_key ) ) {
		return;
	}
 
	// проверяем также ssl, если плагин работает не в тестовом режиме
	if ( ! $this->testmode && ! is_ssl() ) {
		return;
	}
 
	// предположим, что это какой-то JS банка для обработки данных карт
	wp_enqueue_script( 'bank_js', 'https://урл-какого-то-банка/api/token.js' );
 
	// а это наш произвольный JavaScript, дополняющий token.js
	wp_register_script( 'woocommerce_truemisha', plugins_url( 'truemisha.js', __FILE__ ), array( 'jquery', 'bank_js' ) );
 
	// допустим, что нам в JavaScript коде понадобится публичный API ключ, передаём его вот так
	wp_localize_script( 'woocommerce_truemisha', 'truemisha_params', array(
		'publishableKey' => $this->publishable_key
	) );
 
	wp_enqueue_script( 'woocommerce_truemisha' );
 
}

// функция, срабатывающая при успешном получении токена
var successCallback = function(data) {
 
	var checkout_form = $( 'form.woocommerce-checkout' );
 
	// добавляем токен в скрытое поле в форме <input tyoe="hidden" id="truemisha_token" ...
	// console.log(data) тоже помогает
	checkout_form.find( '#truemisha_token' ).val( data.token );
 
	// снимаем функцию tokenRequest с события отправки формы
	checkout_form.off( 'checkout_place_order', tokenRequest );
 
	// отправляем форму
	checkout_form.submit();
 
};
 
// функция, срабатывающая, если при получении токена что-то пошло не так
var errorCallback = function( data ) {
	console.log( data );
};
 
var tokenRequest = function() {
 
	// тут будет какая-то функция вашей платёжный системы или банка, которая соберёт все данные формы и отправит их
	// возможно тут вам понадобится публичный API ключ, который у нас уже лежит тут truemisha_params.publishableKey
	// ну и срабатывает successCallback() при успехе, или errorCallback() если что-то пошло не так
	return false;
 
};
 
jQuery(function($){
 
	var checkout_form = $( 'form.woocommerce-checkout' );
	checkout_form.on( 'checkout_place_order', tokenRequest );
 
});

public function payment_fields() {
 
	// окей, давайте выведем описание, если оно заполнено
	if ( $this->description ) {
		// отдельные инструкции для тестового режима
		if ( $this->testmode ) {
			$this->description .= ' ТЕСТОВЫЙ РЕЖИМ АКТИВИРОВАН. В тестовом режиме вы можете использовать тестовые данные карт, указанные в <a href="#" target="_blank">документации</a>.';
			$this->description  = trim( $this->description );
		}
		// описание закидываем в теги <p>
		echo wpautop( wp_kses_post( $this->description ) );
	}
 
	// я использую функцию echo(), но по сути можете закрыть тег PHP и выводить прямо как HTML
	echo '<fieldset id="wc-' . $this->id . '-cc-form" class="wc-credit-card-form wc-payment-form" style="background:transparent;">';
 
	// чтобы разработчики плагинов могли сюда что-то добавить, но не обязательно
	do_action( 'woocommerce_credit_card_form_start', $this->id );
 
	// I recommend to use inique IDs, because other gateways could already use #ccNo, #expdate, #cvc
	echo '<div class="form-row form-row-wide"><label>Номер карты <span class="required">*</span></label>
		<input id="truemisha_ccNo" type="text" autocomplete="off">
		</div>
		<div class="form-row form-row-first">
			<label>Срок действия <span class="required">*</span></label>
			<input id="truemisha_expdate" type="text" autocomplete="off" placeholder="MM / ГГ">
		</div>
		<div class="form-row form-row-last">
			<label>Код (CVC) <span class="required">*</span></label>
			<input id="truemisha_cvv" type="password" autocomplete="off" placeholder="CVC">
		</div>
		<div class="clear"></div>';
 
	// чтобы разработчики плагинов могли сюда что-то добавить, но не обязательно
	do_action( 'woocommerce_credit_card_form_end', $this->id );
 
	echo '<div class="clear"></div></fieldset>';
 
}

public function validate_fields(){
 
	if( empty( $_POST[ 'billing_first_name' ]) ) {
		wc_add_notice(  'Имя обязательно для заполнения!', 'error' );
		return false;
	}
	return true;
 
}

public function process_payment( $order_id ) {
 
	// вот тут мы получаем объект заказа
	$order = wc_get_order( $order_id );
 
 
	/*
 	 * Массив с параметрами для взаимодействия с API
	 */
	$args = array(
 
		...
 
	);
 
	/*
	 * Взаимодействие с API можно построить при помощи функции wp_remote_post()
 	 */
	$response = wp_remote_post( '{payment processor endpoint}', $args );
 
	// если нет ошибки при подключении
	if( ! is_wp_error( $response ) ) {
 
		$body = json_decode( $response['body'], true );
 
		// в зависимости от банка коды ответа могут быть разные конечно же
		if ( $body['response']['responseCode'] == 'APPROVED' ) {
 
		// получили платёж
		$order->payment_complete();
 
		// может быть добавим немного заметок для пользователя?
		// измените второй параметр на false, чтобы заметка была для админа
		$order->add_order_note( 'Заказ оплачен, спасибочки!', true );
 
		// очищаем корзину
		WC()->cart->empty_cart();
 
		// редиректим на страницу спасибо
		return array(
			'result' => 'success',
			'redirect' => $this->get_return_url( $order )
		);
 
		} else {
			wc_add_notice(  'Попробуйте ещё раз, оплата не прошла.', 'error' );
			return;
		}
 
	} else {
		wc_add_notice(  'Ошибка с подключением к API.', 'error' );
		return;
	}
 
}

add_action( 'woocommerce_api_truemisha', array( $this, 'truemisha_webhook' ) );
// add_action( 'woocommerce_api_{название вебхука}', array( $this, 'метод обработчик' ) );

public function truemisha_webhook() {
 
	$order = wc_get_order( $_GET[ 'id' ] ); // типо ID заказа приходят нам из банка
	$order->payment_complete(); // платёж совершён
	$order->reduce_order_stock(); // уменьшаем количество товаров в запасах
 
	update_option( 'webhook_debug', $_GET ); // чисто чтобы посмотреть, что в $_GET
}