Pronamic\WordPress\Pay\Gateways\Buckaroo\Client

Complexity

Total Complexity

58

Size/Duplication

Total Lines	689
Duplicated Lines	0 %

Test Coverage

Coverage

27.32%

Importance

Changes	3
Bugs	0	Features	0

40 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	4	1
A	get_payment_server_url()	0	2	1
A	set_amount()	0	2	1
A	set_payment_id()	0	2	1
A	get_push_url()	0	2	1
A	set_ideal_issuer()	0	2	1
A	get_return_reject_url()	0	2	1
A	set_excluded_services()	0	2	1
A	set_invoice_number()	0	2	1
A	set_website_key()	0	2	1
A	get_currency()	0	2	1
A	get_invoice_number()	0	2	1
A	set_secret_key()	0	2	1
A	get_requested_services()	0	2	1
A	get_fields()	0	30	1
A	get_return_url()	0	2	1
A	set_return_reject_url()	0	2	1
A	set_culture()	0	2	1
A	get_amount()	0	2	1
A	set_return_cancel_url()	0	2	1
A	get_excluded_services()	0	2	1
D	get_issuers()	0	86	18
A	verify_request()	0	33	2
A	get_payment_id()	0	2	1
A	add_requested_service()	0	2	1
A	get_ideal_issuer()	0	2	1
A	get_description()	0	2	1
A	set_description()	0	2	1
A	get_return_cancel_url()	0	2	1
A	set_currency()	0	2	1
A	get_culture()	0	2	1
A	set_return_error_url()	0	2	1
A	set_payment_method()	0	2	1
A	get_return_error_url()	0	2	1
A	set_push_url()	0	2	1
A	set_payment_server_url()	0	2	1
A	get_payment_method()	0	2	1
A	set_return_url()	0	2	1
A	get_secret_key()	0	2	1
A	get_website_key()	0	2	1

<?php

namespace Pronamic\WordPress\Pay\Gateways\Buckaroo;

/**
 * Title: Buckaroo client
 * Description:
 * Copyright: 2005-2021 Pronamic
 * Company: Pronamic
 *
 * @author Remco Tolsma
 * @version 2.1.1
 * @since 1.0.0
 */
class Client {
	/**
	 * Gateway URL
	 *
	 * @var string
	 */
	const GATEWAY_URL = 'https://checkout.buckaroo.nl/html/';

	/**
	 * Gateway test URL
	 *
	 * @var string
	 */
	const GATEWAY_TEST_URL = 'https://testcheckout.buckaroo.nl/html/';

	/**
	 * Gateway Name-Value-Pair URL
	 *
	 * @var string
	 */
	const GATEWAY_NVP_URL = 'https://checkout.buckaroo.nl/nvp/';

	/**
	 * Gateway Name-Value-Pair test URL
	 *
	 * @var string
	 */
	const GATEWAY_NVP_TEST_URL = 'https://testcheckout.buckaroo.nl/nvp/';

	/**
	 * Indicator for the iDEAL payment method
	 *
	 * @var string
	 */
	const PAYMENT_METHOD_IDEAL = 'ideal';

	/**
	 * The payment server URL
	 *
	 * @var string
	 */
	private $payment_server_url;

	/**
	 * The amount
	 *
	 * @var float|null
	 */
	private $amount;

	/**
	 * The website key
	 *
	 * @var string|null
	 */
	private $website_key;

	/**
	 * The secret key
	 *
	 * @var string|null
	 */
	private $secret_key;

	/**
	 * The payment method
	 *
	 * @var string|null
	 */
	private $payment_method;

	/**
	 * The iDEAL issuer
	 *
	 * @since 1.2.4
	 * @var string|null
	 */
	private $ideal_issuer;

	/**
	 * The country code (culture)
	 *
	 * @var string|null
	 */
	private $culture;

	/**
	 * The currency
	 *
	 * @var string|null
	 */
	private $currency;

	/**
	 * The invoice number
	 *
	 * @var string|null
	 */
	private $invoice_number;

	/**
	 * The description
	 *
	 * @var string|null
	 */
	private $description;

	/**
	 * The return url
	 *
	 * @var string|null
	 */
	private $return_url;

	/**
	 * The return reject url
	 *
	 * @var string|null
	 */
	private $return_reject_url;

	/**
	 * The return error url
	 *
	 * @var string|null
	 */
	private $return_error_url;

	/**
	 * The return cancel url
	 *
	 * @var string|null
	 */
	private $return_cancel_url;

	/**
	 * Push URL
	 *
	 * @var string|null
	 */
	private $push_url;

	/**
	 * Requested services
	 *
	 * @var array
	 */
	private $requested_services;

	/**
	 * Excluded services
	 *
	 * @var string|null
	 */
	private $excluded_services;

	/**
	 * Pronamic payment ID
	 *
	 * @var string|null
	 */
	private $payment_id;

	/**
	 * Constructs and initialize a iDEAL kassa object
	 */
	public function __construct() {
		$this->set_payment_server_url( self::GATEWAY_URL );

		$this->requested_services = array();
	}

	/**
	 * Get the payment server URL
	 *
	 * @return string the payment server URL
	 */
	public function get_payment_server_url() {
		return $this->payment_server_url;
	}

	/**
	 * Set the payment server URL
	 *
	 * @param string $url an URL
	 * @return void
	 */
	public function set_payment_server_url( $url ) {
		$this->payment_server_url = $url;
	}

	/**
	 * Get website key.
	 *
	 * @return string|null
	 */
	public function get_website_key() {
		return $this->website_key;
	}

	/**
	 * Set website key.
	 *
	 * @param string|null $website_key Website key.
	 * @return void
	 */
	public function set_website_key( $website_key ) {
		$this->website_key = $website_key;
	}

	/**
	 * Get secret key.
	 *
	 * @return string|null
	 */
	public function get_secret_key() {
		return $this->secret_key;
	}

	/**
	 * Set secret key.
	 *
	 * @param string|null $secret_key Secret key.
	 * @return void
	 */
	public function set_secret_key( $secret_key ) {
		$this->secret_key = $secret_key;
	}

	/**
	 * Get payment method.
	 *
	 * @return string|null
	 */
	public function get_payment_method() {
		return $this->payment_method;
	}

	/**
	 * Set payment method.
	 *
	 * @param string|null $payment_method Payment method.
	 * @return void
	 */
	public function set_payment_method( $payment_method ) {
		$this->payment_method = $payment_method;
	}

	/**
	 * Get iDEAL issuer.
	 *
	 * @since 1.2.4
	 * @return string|null
	 */
	public function get_ideal_issuer() {
		return $this->ideal_issuer;
	}

	/**
	 * Set iDEAL issuer.
	 *
	 * @since 1.2.4
	 *
	 * @param string|null $issuer
	 * @return void
	 */
	public function set_ideal_issuer( $issuer ) {
		$this->ideal_issuer = $issuer;
	}

	/**
	 * Get requested services.
	 *
	 * @return array
	 */
	public function get_requested_services() {
		return $this->requested_services;
	}

	/**
	 * Add requested service.
	 *
	 * @param string $service Service.
	 * @return void
	 */
	public function add_requested_service( $service ) {
		$this->requested_services[] = $service;
	}

	/**
	 * Get excluded services.
	 *
	 * @return string|null
	 */
	public function get_excluded_services() {
		return $this->excluded_services;
	}

	/**
	 * Set excluded services.
	 *
	 * @param string|null $service Excluded services.
	 * @return void
	 */
	public function set_excluded_services( $service ) {
		$this->excluded_services = $service;
	}

	/**
	 * Get culture.
	 *
	 * @return string|null
	 */
	public function get_culture() {
		return $this->culture;
	}

	/**
	 * Set culture.
	 *
	 * @param string|null $culture Culture.
	 * @return void
	 */
	public function set_culture( $culture ) {
		$this->culture = $culture;
	}

	/**
	 * Get currency.
	 *
	 * @return string|null
	 */
	public function get_currency() {
		return $this->currency;
	}

	/**
	 * Set currency.
	 *
	 * @param string|null $currency Currency.
	 * @return void
	 */
	public function set_currency( $currency ) {
		$this->currency = $currency;
	}

	/**
	 * Get invoice number.
	 *
	 * @return string|null
	 */
	public function get_invoice_number() {
		return $this->invoice_number;
	}

	/**
	 * Set invoice number.
	 *
	 * @param string|null $invoice_number Invoice number.
	 * @return void
	 */
	public function set_invoice_number( $invoice_number ) {
		$this->invoice_number = $invoice_number;
	}

	/**
	 * Get description.
	 *
	 * @return string|null
	 */
	public function get_description() {
		return $this->description;
	}

	/**
	 * Set description.
	 *
	 * @param string|null $description Description.
	 * @return void
	 */
	public function set_description( $description ) {
		$this->description = $description;
	}

	/**
	 * Get amount.
	 *
	 * @return float|null
	 */
	public function get_amount() {
		return $this->amount;
	}

	/**
	 * Set amount.
	 *
	 * @param float|null $amount Amount.
	 * @return void
	 */
	public function set_amount( $amount ) {
		$this->amount = $amount;
	}

	/**
	 * Get return URL
	 *
	 * @return string|null
	 */
	public function get_return_url() {
		return $this->return_url;
	}

	/**
	 * Set return URL
	 *
	 * @param string|null $url Return URL.
	 * @return void
	 */
	public function set_return_url( $url ) {
		$this->return_url = $url;
	}

	/**
	 * Get return reject URL
	 *
	 * @return string|null
	 */
	public function get_return_reject_url() {
		return $this->return_reject_url;
	}

	/**
	 * Set return reject URL
	 *
	 * @param string|null $url Return reject URL.
	 * @return void
	 */
	public function set_return_reject_url( $url ) {
		$this->return_reject_url = $url;
	}

	/**
	 * Get return error URL
	 *
	 * @return string|null
	 */
	public function get_return_error_url() {
		return $this->return_error_url;
	}

	/**
	 * Set return error URL
	 *
	 * @param string|null $url Return error URL.
	 * @return void
	 */
	public function set_return_error_url( $url ) {
		$this->return_error_url = $url;
	}

	/**
	 * Get return cancel URL
	 *
	 * @return string|null
	 */
	public function get_return_cancel_url() {
		return $this->return_cancel_url;
	}

	/**
	 * Set return cancel URL
	 *
	 * @param string|null $url Return cancel URL.
	 * @return void
	 */
	public function set_return_cancel_url( $url ) {
		$this->return_cancel_url = $url;
	}

	/**
	 * Get push URL
	 *
	 * @return string|null
	 */
	public function get_push_url() {
		return $this->push_url;
	}

	/**
	 * Set push URL
	 *
	 * @param string|null $url Push URL.
	 * @return void
	 */
	public function set_push_url( $url ) {
		$this->push_url = $url;
	}

	/**
	 * Get Pronamic payment ID
	 *
	 * @return string|null
	 */
	public function get_payment_id() {
		return $this->payment_id;
	}

	/**
	 * Set Pronamic payment ID
	 *
	 * @param string|null $payment_id Payment ID.
	 * @return void
	 */
	public function set_payment_id( $payment_id ) {
		$this->payment_id = $payment_id;
	}

	/**
	 * Get issuers
	 *
	 * @since 1.2.4
	 * @link http://support.buckaroo.nl/index.php/Service_iDEAL#iDEAL_banken_lijst_opvragen
	 * @return array
	 */
	public function get_issuers() {
		$issuers = array();

		$url = add_query_arg( 'op', 'TransactionRequestSpecification', self::GATEWAY_NVP_TEST_URL );

		$data = array(
			'brq_websitekey'        => $this->get_website_key(),
			'brq_services'          => 'ideal',
			'brq_latestversiononly' => 'True',
		);

		$signature = Security::create_signature( $data, (string) $this->get_secret_key() );

		$data[ Parameters::SIGNATURE ] = $signature;

		$result = wp_remote_post(
			$url,
			array(
				'body' => http_build_query( $data ),
			)
		);

		$body = wp_remote_retrieve_body( $result );

		wp_parse_str( $body, $data );

		$data = Util::transform_flat_response( $data );

		$error_msg = __( 'Unable to retrieve issuers from Buckaroo.', 'pronamic_ideal' );

		if ( 200 !== wp_remote_retrieve_response_code( $result ) ) {
			throw new \Exception( $error_msg );
		}

		if ( isset( $data['BRQ_APIRESULT'] ) && 'Fail' === $data['BRQ_APIRESULT'] ) {
			if ( isset( $data['BRQ_APIERRORMESSAGE'] ) && is_string( $data['BRQ_APIERRORMESSAGE'] ) ) {
				$error_msg = sprintf( '%s %s', $error_msg, $data['BRQ_APIERRORMESSAGE'] );
			}

			throw new \Exception( $error_msg );
		}

		if ( ! isset( $data['BRQ_SERVICES'] ) ) {
			return $issuers;
		}

		if ( \is_array( $data['BRQ_SERVICES'] ) ) {
			foreach ( $data['BRQ_SERVICES'] as $service ) {
				if ( ! isset( $service['NAME'], $service['VERSION'], $service['ACTIONDESCRIPTION'] ) ) {
					return $issuers;
				}

				if ( PaymentMethods::IDEAL !== $service['NAME'] ) {
					continue;
				}

				foreach ( $service['ACTIONDESCRIPTION'] as $action ) {
					if ( ! isset( $action['NAME'], $action['REQUESTPARAMETERS'] ) ) {
						return $issuers;
					}

					if ( 'Pay' !== $action['NAME'] ) {
						continue;
					}

					foreach ( $action['REQUESTPARAMETERS'] as $parameter ) {

						if ( ! isset( $parameter['NAME'], $parameter['LISTITEMDESCRIPTION'] ) ) {
							return $issuers;
						}

						if ( 'issuer' !== $parameter['NAME'] ) {
							continue;
						}

						foreach ( $parameter['LISTITEMDESCRIPTION'] as $issuer ) {
							$issuers[ $issuer['VALUE'] ] = $issuer['DESCRIPTION'];
						}

						break;
					}
				}
			}
		}

		return $issuers;
	}

	/**
	 * Get HTML fields
	 *
	 * @since 1.1.1
	 * @return array<string, array|float|int|string|null>
	 */
	public function get_fields() {
		// Description with HTML entities such as `&#038;` decoded into `&`, to prevent invalid signature.
		$description = html_entity_decode( (string) $this->get_description() );

		// Data.
		$data = array(
			Parameters::ADD_PRONAMIC_PAYMENT_ID => $this->get_payment_id(),
			Parameters::WEBSITE_KEY             => $this->get_website_key(),
			Parameters::INVOICE_NUMBER          => $this->get_invoice_number(),
			Parameters::AMOUNT                  => number_format( floatval( $this->get_amount() ), 2, '.', '' ),
			Parameters::CURRENCY                => $this->get_currency(),
			Parameters::CULTURE                 => $this->get_culture(),
			Parameters::DESCRIPTION             => $description,
			Parameters::PAYMENT_METHOD          => $this->get_payment_method(),
			Parameters::RETURN_URL              => $this->get_return_url(),
			Parameters::RETURN_REJECT_URL       => $this->get_return_reject_url(),
			Parameters::RETURN_ERROR_URL        => $this->get_return_error_url(),
			Parameters::RETURN_CANCEL_URL       => $this->get_return_cancel_url(),
			Parameters::PUSH_URL                => $this->get_push_url(),
			Parameters::PUSH_FAILURE_URL        => $this->get_push_url(),
			Parameters::REQUESTED_SERVICES      => implode( ',', $this->get_requested_services() ),
			Parameters::EXCLUDED_SERVICES       => $this->get_excluded_services(),
			Parameters::IDEAL_ISSUER            => $this->get_ideal_issuer(),
		);

		$signature = Security::create_signature( $data, (string) $this->get_secret_key() );

		$data[ Parameters::SIGNATURE ] = $signature;

		return $data;
	}

	/**
	 * Verify request Buckaroo
	 *
	 * @param array $data Data.
	 * @return false|array<string, float|int|string>
	 */
	public function verify_request( $data ) {
		$result = false;

		$signature = (string) Security::get_signature( $data );

		$signature_check = Security::create_signature( $data, (string) $this->get_secret_key() );

		if ( 0 === strcasecmp( $signature, $signature_check ) ) {
			$data = array_change_key_case( $data, CASE_LOWER );

			$result = filter_var_array(
				$data,
				array(
					Parameters::ADD_PRONAMIC_PAYMENT_ID    => FILTER_SANITIZE_STRING,
					Parameters::PAYMENT                    => FILTER_SANITIZE_STRING,
					Parameters::PAYMENT_METHOD             => FILTER_SANITIZE_STRING,
					Parameters::STATUS_CODE                => FILTER_VALIDATE_INT,
					Parameters::STATUS_CODE_DETAIL         => FILTER_SANITIZE_STRING,
					Parameters::STATUS_MESSAGE             => FILTER_SANITIZE_STRING,
					Parameters::INVOICE_NUMBER             => FILTER_SANITIZE_STRING,
					Parameters::AMOUNT                     => FILTER_VALIDATE_FLOAT,
					Parameters::CURRENCY                   => FILTER_SANITIZE_STRING,
					Parameters::TIMESTAMP                  => FILTER_SANITIZE_STRING,
					Parameters::SERVICE_IDEAL_CONSUMER_ISSUER => FILTER_SANITIZE_STRING,
					Parameters::SERVICE_IDEAL_CONSUMER_NAME => FILTER_SANITIZE_STRING,
					Parameters::SERVICE_IDEAL_CONSUMER_IBAN => FILTER_SANITIZE_STRING,
					Parameters::SERVICE_IDEAL_CONSUMER_BIC => FILTER_SANITIZE_STRING,
					Parameters::TRANSACTIONS               => FILTER_SANITIZE_STRING,
				)
			);
		}

		return $result;
	}
}