wp-pay-gateways / omnikassa-2

src/Gateway.php

<?php
/**
 * Gateway
 *
 * @author    Pronamic <info@pronamic.eu>
 * @copyright 2005-2019 Pronamic
 * @license   GPL-3.0-or-later
 * @package   Pronamic\WordPress\Pay\Gateways\OmniKassa2
 */

namespace Pronamic\WordPress\Pay\Gateways\OmniKassa2;

use Pronamic\WordPress\Pay\Core\Gateway as Core_Gateway;
use Pronamic\WordPress\Pay\Core\PaymentMethods;
use Pronamic\WordPress\Pay\Payments\Payment;

/**
 * Gateway
 *
 * @author  Remco Tolsma
 * @version 2.1.8
 * @since   1.0.0
 */
class Gateway extends Core_Gateway {
	/**
	 * Client.
	 *
	 * @var Client
	 */
	private $client;

	/**
	 * Constructs and initializes an OmniKassa 2.0 gateway.
	 *
	 * @param Config $config Config.
	 */
	public function __construct( Config $config ) {
		parent::__construct( $config );

		$this->set_method( self::METHOD_HTTP_REDIRECT );

		// Supported features.
		$this->supports = array(
			'webhook_log',
		);

		// Client.
		$this->client = new Client();

		$url = Client::URL_PRODUCTION;

		if ( self::MODE_TEST === $config->mode ) {
			$url = Client::URL_SANDBOX;
		}

		$this->client->set_url( $url );
		$this->client->set_refresh_token( $config->refresh_token );
		$this->client->set_signing_key( $config->signing_key );
	}

	/**
	 * Get supported payment methods.
	 *
	 * @see \Pronamic_WP_Pay_Gateway::get_supported_payment_methods()
	 * @return array<string>
	 */
	public function get_supported_payment_methods() {
		return array(
			PaymentMethods::AFTERPAY,
			PaymentMethods::BANCONTACT,
			PaymentMethods::CREDIT_CARD,
			PaymentMethods::IDEAL,
			PaymentMethods::MAESTRO,
			PaymentMethods::PAYPAL,
		);
	}

	/**
	 * Start.
	 *
	 * @see Core_Gateway::start()
	 * @param Payment $payment Payment.
	 */
	public function start( Payment $payment ) {
		// Merchant order ID.
		$merchant_order_id = $payment->format_string( $this->config->order_id );

		$payment->set_meta( 'omnikassa_2_merchant_order_id', $merchant_order_id );

		// New order.
		$merchant_return_url = $payment->get_return_url();
		$merchant_return_url = \apply_filters( 'pronamic_pay_omnikassa_2_merchant_return_url', $merchant_return_url );

		try {
			$order = new Order(
				$merchant_order_id,
				MoneyTransformer::transform( $payment->get_total_amount() ),
				$merchant_return_url
			);

			// Shipping address.
			$order->set_shipping_detail( AddressTransformer::transform( $payment->get_shipping_address() ) );

			// Billing address.
			$order->set_billing_detail( AddressTransformer::transform( $payment->get_billing_address() ) );

			// Customer information.
			$customer = $payment->get_customer();

			if ( null !== $customer ) {
				// Language.
				$language = $customer->get_language();

				if ( null !== $language ) {
					$order->set_language( \strtoupper( $language ) );
				}

				// Customer information.
				$customer_information = new CustomerInformation();

				$customer_information->set_email_address( $customer->get_email() );
				$customer_information->set_date_of_birth( $customer->get_birth_date() );
				$customer_information->set_gender( Gender::transform( $customer->get_gender() ) );
				$customer_information->set_telephone_number( $customer->get_phone() );

				$name = $customer->get_name();

				if ( null !== $name ) {
					$customer_information->set_initials( $name->get_initials() );
				}

				$order->set_customer_information( $customer_information );
			}

			// Payment brand.
			$payment_brand = PaymentBrands::transform( $payment->get_method() );

			$order->set_payment_brand( $payment_brand );

			if ( null !== $payment_brand ) {
				// Payment brand force should only be set if payment brand is not empty.
				$order->set_payment_brand_force( PaymentBrandForce::FORCE_ONCE );
			}

			// Description.
			$order->set_description( DataHelper::sanitize_an( $payment->get_description(), 35 ) );

			// Lines.
			$lines = $payment->get_lines();

			if ( null !== $lines ) {
				$order_items = $order->new_items();

				$i = 1;

				foreach ( $lines as $line ) {
					$name = \sprintf(
						/* translators: %s: item index */
						\__( 'Item %s', 'pronamic_ideal' ),
						$i++
					);

					if ( null !== $line->get_name() && '' !== $line->get_name() ) {
						$name = $line->get_name();
					}

					$item = $order_items->new_item(
						DataHelper::sanitize_an( $name, 50 ),
						$line->get_quantity(),
						// The amount in cents, including VAT, of the item each, see below for more details.
						MoneyTransformer::transform( $line->get_unit_price() ),
						ProductCategories::transform( $line->get_type() )
					);

					$item->set_id( $line->get_id() );

					// Description.
					$description = $line->get_description();

					if ( empty( $description ) && PaymentBrands::AFTERPAY === $payment_brand ) {
						/*
						 * The `OrderItem.description` field is documentated as `0..1` (optional),
						 * but for AfterPay payments it is required.
						 *
						 * @link https://github.com/wp-pay-gateways/omnikassa-2/tree/feature/post-pay/documentation#error-5024
						 */
						$description = $name;
					}

					if ( null !== $description ) {
						$description = DataHelper::sanitize_an( $description, 100 );
					}

					$item->set_description( $description );

					$tax_amount = $line->get_unit_price()->get_tax_amount();

					if ( null !== $tax_amount ) {
						// The VAT of the item each, see below for more details.
						$item->set_tax( MoneyTransformer::transform( $tax_amount ) );
					}
				}
			}
		} catch ( \Exception $e ) {
			throw new \Pronamic\WordPress\Pay\GatewayException( 'omnikassa_2', $e->getMessage() );

The type Pronamic\WordPress\Pay\GatewayException was not found. Maybe you did not declare it correctly or list all dependencies?

		}

		// Maybe update access token.
		$this->maybe_update_access_token();

		// Announce order.
		$response = $this->client->order_announce( $this->config, $order );

		if ( false === $response ) {
			return;
		}

		if ( ! $response->is_valid( $this->config->signing_key ) ) {
			return;
		}

		$payment->set_action_url( $response->get_redirect_url() );
	}

	/**
	 * Update status of the specified payment.
	 *
	 * @param Payment $payment Payment.
	 */
	public function update_status( Payment $payment ) {
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( ! ReturnParameters::contains( $_GET ) ) {
			return;
		}

		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$parameters = ReturnParameters::from_array( $_GET );

		// Note.
		$note_values = array(
			'order_id'  => $parameters->get_order_id(),
			'status'    => $parameters->get_status(),
			'signature' => $parameters->get_signature(),
			'valid'     => $parameters->is_valid( $this->config->signing_key ) ? 'true' : 'false',
		);

		$note = '';

		$note .= '<p>';
		$note .= \__( 'OmniKassa 2.0 return URL requested:', 'pronamic_ideal' );
		$note .= '</p>';

		$note .= '<dl>';

		foreach ( $note_values as $key => $value ) {
			$note .= \sprintf( '<dt>%s</dt>', \esc_html( $key ) );
			$note .= \sprintf( '<dd>%s</dd>', \esc_html( $value ) );
		}

		$note .= '</dl>';

		$payment->add_note( $note );

		// Validate.
		if ( ! $parameters->is_valid( $this->config->signing_key ) ) {
			return;
		}

		// Status.
		$pronamic_status = Statuses::transform( $parameters->get_status() );

		if ( null !== $pronamic_status ) {
			$payment->set_status( $pronamic_status );
		}
	}

	/**
	 * Handle notification.
	 *
	 * @param Notification $notification Notification.
	 * @return void
	 */
	public function handle_notification( Notification $notification ) {
		if ( ! $notification->is_valid( $this->config->signing_key ) ) {
			return;
		}

		switch ( $notification->get_event_name() ) {
			case 'merchant.order.status.changed':
				$this->handle_merchant_order_status_changed( $notification );
		}
	}

	/**
	 * Handle `merchant.order.status.changed` event.
	 *
	 * @param Notification $notification Notification.
	 * @return void
	 */
	private function handle_merchant_order_status_changed( Notification $notification ) {
		do {
			$order_results = $this->client->get_order_results( $notification->get_authentication() );

			if ( false === $order_results ) {
				return;
			}

			if ( ! $order_results->is_valid( $this->config->signing_key ) ) {
				return;
			}

			foreach ( $order_results as $order_result ) {
				$payment = \get_pronamic_payment_by_meta( '_pronamic_payment_omnikassa_2_merchant_order_id', $order_result->get_merchant_order_id() );

				// Log webhook request.
				\do_action( 'pronamic_pay_webhook_log_payment', $payment );

				if ( empty( $payment ) ) {
					continue;
				}

				$payment->set_transaction_id( $order_result->get_omnikassa_order_id() );

				$pronamic_status = Statuses::transform( $order_result->get_order_status() );

				if ( null !== $pronamic_status ) {
					$payment->set_status( $pronamic_status );
				}

				// Note.
				$note = '';

				$note .= '<p>';
				$note .= \__( 'OmniKassa 2.0 webhook URL requested:', 'pronamic_ideal' );
				$note .= '</p>';
				$note .= '<pre>';
				$note .= \wp_json_encode( $order_result->get_json(), \JSON_PRETTY_PRINT );
				$note .= '</pre>';

				$payment->add_note( $note );

				$payment->save();
			}
		} while ( $order_results->more_available() );
	}

	/**
	 * Maybe update access token.
	 *
	 * @return void
	 */
	private function maybe_update_access_token() {
		if ( $this->config->is_access_token_valid() ) {
			return;
		}

		$data = $this->client->get_access_token_data();

		if ( ! \is_object( $data ) ) {
			return;
		}

		if ( isset( $data->token ) ) {
			$this->config->access_token = $data->token;

			\update_post_meta( $this->config->post_id, '_pronamic_gateway_omnikassa_2_access_token', $data->token );
		}

		/*
		 * @codingStandardsIgnoreStart
		 *
		 * Ignore coding standards because of sniff WordPress.NamingConventions.ValidVariableName.NotSnakeCaseMemberVar
		 */
		if ( isset( $data->validUntil ) ) {
			$this->config->access_token_valid_until = $data->validUntil;

			\update_post_meta(
				$this->config->post_id,
				'_pronamic_gateway_omnikassa_2_access_token_valid_until',
				$data->validUntil
			);
		}
		// @codingStandardsIgnoreEnd
	}
}