<?php
/**
 * Result code
 *
 * @author    Pronamic <info@pronamic.eu>
 * @copyright 2005-2026 Pronamic
 * @license   GPL-3.0-or-later
 * @package   Pronamic\WordPress\Pay\Gateways\Adyen
 */

namespace Pronamic\WordPress\Pay\Gateways\Adyen;

use Pronamic\WordPress\Pay\Payments\PaymentStatus;

/**
 * Result code class
 *
 * @link https://docs.adyen.com/developers/checkout/payment-result-codes
 */
class ResultCode {
	/**
	 * Authorized.
	 *
	 * The payment was successfully authorised.
	 *
	 * @var string
	 */
	const AUTHORIZED = 'Authorised';

	/**
	 * Cancelled.
	 *
	 * The payment was cancelled (by either the shopper or
	 * your own system) before processing was completed.
	 *
	 * @var string
	 */
	const CANCELLED = 'Cancelled';

	/**
	 * Error.
	 *
	 * There was an error when the payment was being processed.
	 *
	 * @var string
	 */
	const ERROR = 'Error';

	/**
	 * Pending.
	 *
	 * It's not possible to obtain the final status of the payment at this time.
	 * This is common for payments with an asynchronous flow, such as Boleto, iDEAL, or Klarna.
	 *
	 * @var string
	 */
	const PENDING = 'Pending';

	/**
	 * Received.
	 *
	 * This is part of the standard payment flow for methods such as SEPA Direct Debit,
	 * where it can take some time before the final status of the payment is known.
	 *
	 * @var string
	 */
	const RECEIVED = 'Received';

	/**
	 * Redirect shopper.
	 *
	 * The shopper needs to be redirected to an external web page or app to complete the payment.
	 *
	 * @var string
	 */
	const REDIRECT_SHOPPER = 'RedirectShopper';

	/**
	 * Refused.
	 *
	 * The payment was refused.
	 *
	 * @var string
	 */
	const REFUSED = 'Refused';

	/**
	 * Transform Adyen result code to WordPress payment status.
	 *
	 * @param string|null $result_code Adyen result code.
	 * @return string|null WordPress payment status.
	 */
	public static function transform( $result_code ) {
		switch ( $result_code ) {
			case self::PENDING:
			case self::RECEIVED:
			case self::REDIRECT_SHOPPER:
				return PaymentStatus::OPEN;
			case self::CANCELLED:
				return PaymentStatus::CANCELLED;
			case self::ERROR:
			case self::REFUSED:
				return PaymentStatus::FAILURE;
			case self::AUTHORIZED:
				return PaymentStatus::SUCCESS;
		}

		return null;
	}
}
