Omnipay\Redsys\Message\PurchaseRequest

Complexity

Total Complexity

139

Size/Duplication

Total Lines	1660
Duplicated Lines	0 %

Coupling/Cohesion

Components	3
Dependencies	3

Test Coverage

Coverage

100%

Importance

Changes

0

123 Methods

Rating	Name	Duplication	Size	Complexity
A	getCardholder()	0	4	1
A	setCardholder()	0	4	1
A	getConsumerLanguage()	0	4	1
A	setConsumerLanguage()	0	13	6
A	getHmacKey()	0	4	1
A	setHmacKey()	0	4	1
A	getMerchantData()	0	4	1
A	setMerchantData()	0	4	1
A	getMerchantId()	0	4	1
A	setMerchantId()	0	4	1
A	getMerchantName()	0	4	1
A	setMerchantName()	0	4	1
A	getTerminalId()	0	4	1
A	setTerminalId()	0	4	1
A	getEmail()	0	4	1
A	setEmail()	0	4	1
A	getHomePhoneCountryPrefix()	0	4	1
A	setHomePhoneCountryPrefix()	0	4	1
A	getHomePhone()	0	4	1
A	setHomePhone()	0	4	1
A	getMobilePhoneCountryPrefix()	0	4	1
A	setMobilePhoneCountryPrefix()	0	4	1
A	getMobilePhone()	0	4	1
A	setMobilePhone()	0	4	1
A	getWorkPhoneCountryPrefix()	0	4	1
A	setWorkPhoneCountryPrefix()	0	4	1
A	getWorkPhone()	0	4	1
A	setWorkPhone()	0	4	1
A	getShippingAddress1()	0	4	1
A	setShippingAddress1()	0	4	1
A	getShippingAddress2()	0	4	1
A	setShippingAddress2()	0	4	1
A	getShippingAddress3()	0	4	1
A	setShippingAddress3()	0	4	1
A	getShippingCity()	0	4	1
A	setShippingCity()	0	4	1
A	getShippingPostcode()	0	4	1
A	setShippingPostcode()	0	4	1
A	getShippingState()	0	4	1
A	setShippingState()	0	4	1
A	getShippingCountry()	0	4	1
A	setShippingCountry()	0	4	1
A	getBillingAddress1()	0	4	1
A	setBillingAddress1()	0	4	1
A	getBillingAddress2()	0	4	1
A	setBillingAddress2()	0	4	1
A	getBillingAddress3()	0	4	1
A	setBillingAddress3()	0	4	1
A	getBillingCity()	0	4	1
A	setBillingCity()	0	4	1
A	getBillingPostcode()	0	4	1
A	setBillingPostcode()	0	4	1
A	getBillingState()	0	4	1
A	setBillingState()	0	4	1
A	getBillingCountry()	0	4	1
A	setBillingCountry()	0	4	1
A	getAddressMatch()	0	4	1
A	setAddressMatch()	0	4	1
A	getChallengeWindowSize()	0	4	1
A	setChallengeWindowSize()	0	4	1
A	getCustomerAdditionalInformation()	0	4	1
A	setCustomerAdditionalInformation()	0	4	1
A	get3DsRequestAuthenticationMethodData()	0	4	1
A	set3DsRequestAuthenticationMethodData()	0	4	1
A	get3DsRequestAuthenticationMethod()	0	4	1
A	set3DsRequestAuthenticationMethod()	0	4	1
A	get3DsRequestAuthenticationTime()	0	4	1
A	set3DsRequestAuthenticationTime()	0	4	1
A	getCustomerAccountCreationIndicator()	0	4	1
A	setCustomerAccountCreationIndicator()	0	4	1
A	getCustomerAccountCreationDate()	0	4	1
A	setCustomerAccountCreationDate()	0	4	1
A	getCustomerAccountModificationIndicator()	0	4	1
A	setCustomerAccountModificationIndicator()	0	4	1
A	getCustomerAccountModificationDate()	0	4	1
A	setCustomerAccountModificationDate()	0	4	1
A	getCustomerPasswordModificationIndicator()	0	4	1
A	setCustomerPasswordModificationIndicator()	0	4	1
A	getCustomerPasswordModificationDate()	0	4	1
A	setCustomerPasswordModificationDate()	0	4	1
A	getCustomerPurchasesInLast6Months()	0	4	1
A	setCustomerPurchasesInLast6Months()	0	4	1
A	getCustomerAccountCardProvisionsLast24Hours()	0	4	1
A	setCustomerAccountCardProvisionsLast24Hours()	0	4	1
A	getCustomerAccountTransactionsLast24Hours()	0	4	1
A	setCustomerAccountTransactionsLast24Hours()	0	4	1
A	getCustomerAccountTransactionsLast24Year()	0	4	1
A	setCustomerAccountTransactionsLast24Year()	0	4	1
A	getCustomerPaymentMethodCreationIndicator()	0	4	1
A	setCustomerPaymentMethodCreationIndicator()	0	4	1
A	getCustomerPaymentMethodCreationDate()	0	4	1
A	setCustomerPaymentMethodCreationDate()	0	4	1
A	getShippingAddressFirstUsedIndicator()	0	4	1
A	setShippingAddressFirstUsedIndicator()	0	4	1
A	getShippingAddressFirstUsedDate()	0	4	1
A	setShippingAddressFirstUsedDate()	0	4	1
A	getShippingNameCustomerNameMatch()	0	4	1
A	setShippingNameCustomerNameMatch()	0	4	1
A	getCustomerHasSuspiciousActivity()	0	4	1
A	setCustomerHasSuspiciousActivity()	0	4	1
A	getDeliveryEmail()	0	4	1
A	setDeliveryEmail()	0	4	1
A	getDeliveryTimeframeIndicator()	0	4	1
A	setDeliveryTimeframeIndicator()	0	4	1
A	getGiftCardAmount()	0	4	1
A	setGiftCardAmount()	0	4	1
A	getGiftCardCount()	0	4	1
A	setGiftCardCount()	0	4	1
A	getGiftCardCurrency()	0	4	1
A	setGiftCardCurrency()	0	4	1
A	getPurchasingPreOrder()	0	4	1
A	setPurchasingPreOrder()	0	4	1
A	getPreOrderDate()	0	4	1
A	setPreOrderDate()	0	4	1
A	getCustomerHasPurchasedProductBefore()	0	4	1
A	setCustomerHasPurchasedProductBefore()	0	4	1
A	getShippingAddressIndicator()	0	4	1
A	setShippingAddressIndicator()	0	4	1
A	setTransactionId()	0	15	3
B	getData()	0	91	7
A	sendData()	0	18	1
A	getEndpoint()	0	4	2
A	formatDateTime()	0	8	3

<?php

namespace Omnipay\Redsys\Message;

use DateTime;
use Omnipay\Common\Message\AbstractRequest;

/**
 * Redsys Purchase Request
 */
class PurchaseRequest extends AbstractRequest
{
    /** @var string */
    protected $liveEndpoint = 'https://sis.redsys.es/sis/realizarPago';
    /** @var string */
    protected $testEndpoint = 'https://sis-t.redsys.es:25443/sis/realizarPago';
    /** @var array */
    protected static $consumerLanguages = array(
        'es' => '001', // Spanish
        'en' => '002', // English
        'ca' => '003', // Catalan - same as Valencian (010)
        'fr' => '004', // French
        'de' => '005', // German
        'nl' => '006', // Dutch
        'it' => '007', // Italian
        'sv' => '008', // Swedish
        'pt' => '009', // Portuguese
        'pl' => '011', // Polish
        'gl' => '012', // Galician
        'eu' => '013', // Basque
    );

    /** @var stirng 250x400 */
    const CHALLENGE_WINDOW_SIZE_250x400 = "01";
    /** @var stirng 390x400 */
    const CHALLENGE_WINDOW_SIZE_390x400 = "02";
    /** @var stirng 500x600 */
    const CHALLENGE_WINDOW_SIZE_500x600 = "03";
    /** @var stirng 600x400 */
    const CHALLENGE_WINDOW_SIZE_600x400 = "04";
    /** @var stirng Fullscreen window (default) */
    const CHALLENGE_WINDOW_SIZE_FULLSCREEN = "05";

    /** @var string No 3DS Requestor authentication occurred (i.e. cardholder logged in as guest) */
    const ACCOUNT_AUTHENTICATION_METHOD_NONE = "01";
    /** @var string Login to the cardholder account at the 3DS Requestor system using 3DS Requestor's own credentials */
    const ACCOUNT_AUTHENTICATION_METHOD_OWN_CREDENTIALS = "02";
    /** @var string Login to the cardholder account at the 3DS Requestor system using federated ID */
    const ACCOUNT_AUTHENTICATION_METHOD_FEDERATED_ID = "03";
    /** @var string Login to the cardholder account at the 3DS Requestor system using issuer credentials */
    const ACCOUNT_AUTHENTICATION_METHOD_ISSUER_CREDENTIALS = "04";
    /** @var string Login to the cardholder account at the 3DS Requestor system using third-party authentication */
    const ACCOUNT_AUTHENTICATION_METHOD_THIRD_PARTY_AUTHENTICATION = "05";
    /** @var string Login to the cardholder account at the 3DS Requestor system using FIDO Authenticator */
    const ACCOUNT_AUTHENTICATION_METHOD_FIDO = "06";

    /** @var string No account (guest check-out) */
    const CUSTOMER_ACCOUNT_CREATED_NONE = "01";
    /** @var string Created during this transaction */
    const CUSTOMER_ACCOUNT_CREATED_THIS_TRANSACTION = "02";
    /** @var string Less than 30 days */
    const CUSTOMER_ACCOUNT_CREATED_LAST_30_DAYS = "03";
    /** @var string Between 30 and 60 days */
    const CUSTOMER_ACCOUNT_CREATED_LAST_60_DAYS = "04";
    /** @var string More than 60 day */
    const CUSTOMER_ACCOUNT_CREATED_MORE_THAN_60_DAYS = "05";

    /** @var string Modified in this session */
    const CUSTOMER_ACCOUNT_MODIFIED_THIS_TRANSACTION = "01";
    /** @var string Less than 30 days */
    const CUSTOMER_ACCOUNT_MODIFIED_LAST_30_DAYS = "02";
    /** @var string Between 30 and 60 days */
    const CUSTOMER_ACCOUNT_MODIFIED_LAST_60_DAYS = "03";
    /** @var string More than 60 day */
    const CUSTOMER_ACCOUNT_MODIFIED_MORE_THAN_60_DAYS = "04";

    /** @var string Unchanged */
    const CUSTOMER_ACCOUNT_PASSWORD_MODIFIED_NONE = "01";
    /** @var string Modified in this session */
    const CUSTOMER_ACCOUNT_PASSWORD_MODIFIED_THIS_TRANSACTION = "02";
    /** @var string Less than 30 days */
    const CUSTOMER_ACCOUNT_PASSWORD_MODIFIED_LAST_30_DAYS = "03";
    /** @var string Between 30 and 60 days */
    const CUSTOMER_ACCOUNT_PASSWORD_MODIFIED_LAST_60_DAYS = "04";
    /** @var string More than 60 day */
    const CUSTOMER_ACCOUNT_PASSWORD_MODIFIED_MORE_THAN_60_DAYS = "05";

    /** @var string No account (guest check-out) */
    const PAYMENT_METHOD_CREATED_NONE = "01";
    /** @var string Created during this transaction */
    const PAYMENT_METHOD_CREATED_THIS_TRANSACTION = "02";
    /** @var string Less than 30 days */
    const PAYMENT_METHOD_CREATED_LAST_30_DAYS = "03";
    /** @var string Between 30 and 60 days */
    const PAYMENT_METHOD_CREATED_LAST_60_DAYS = "04";
    /** @var string More than 60 day */
    const PAYMENT_METHOD_CREATED_MORE_THAN_60_DAYS = "05";

    /** @var string For the first time */
    const SHIPPING_ADDRESS_USAGE_THIS_TRANSACTION = "01";
    /** @var string Less than 30 days */
    const SHIPPING_ADDRESS_USAGE_LAST_30_DAYS = "02";
    /** @var string Between 30 and 60 days */
    const SHIPPING_ADDRESS_USAGE_LAST_60_DAYS = "03";
    /** @var string More than 60 day */
    const SHIPPING_ADDRESS_USAGE_MORE_THAN_60_DAYS = "04";

    /** @var string Electronic delivery */
    const DELIVERY_TIMEFRAME_ELECTRONIC_DELIVERY = "01";
    /** @var string Same day shipping */
    const DELIVERY_TIMEFRAME_SAME_DAY = "02";
    /** @var string Next day shipping */
    const DELIVERY_TIMEFRAME_NEXT_DAY = "03";
    /** @var string Shipping in 2 or more days */
    const DELIVERY_TIMEFRAME_2_OR_MORE_DAYS = "04";

    /** @var string Ship to cardholder's billing address */
    const SHIPPING_TO_BILLING_ADDRESS = "01";
    /** @var string Ship to another verified address on file with merchant */
    const SHIPPING_TO_ANOTHER_VERIFIED_ADDRESS = "02";
    /** @var string Ship to address that is different than the cardholder's billing address */
    const SHIPPING_DIFFERENT_BILLING_ADDRESS = "03";
    /** @var string Pick-up at local store (Store address shall be populated in shipping address fields) */
    const SHIPPING_PICK_UP = "04";
    /** @var string Digital goods (includes online services, electronic gift cards and redemption codes) */
    const SHIPPING_DIGITAL = "05";
    /** @var string Travel and Event tickets, not shipped */
    const SHIPPING_TRAVEL = "06";
    /** @var string Other (for example, Gaming, digital services not shipped, emedia subscriptions, etc.) */
    const SHIPPING_OTHER = "07";

    public function getCardholder()
    {
        return $this->getParameter('cardholder');
    }

    public function setCardholder($value)
    {
        return $this->setParameter('cardholder', $value);
    }

    public function getConsumerLanguage()
    {
        return $this->getParameter('consumerLanguage');
    }

    /**
     * Set the language presented to the consumer
     *
     * @param string|int Either the ISO 639-1 code to be converted, or the gateway's own numeric language code
     */
    public function setConsumerLanguage($value)
    {
        if (is_int($value)) {
            if ($value < 0 || $value > 13) {
                $value = 1;
            }
            $value = str_pad($value, 3, '0', STR_PAD_LEFT);
        } elseif (!is_numeric($value)) {
            $value = isset(self::$consumerLanguages[$value]) ? self::$consumerLanguages[$value] : '001';
        }

        return $this->setParameter('consumerLanguage', $value);
    }

    public function getHmacKey()
    {
        return $this->getParameter('hmacKey');
    }

    public function setHmacKey($value)
    {
        return $this->setParameter('hmacKey', $value);
    }

    public function getMerchantData()
    {
        return $this->getParameter('merchantData');
    }

    public function setMerchantData($value)
    {
        return $this->setParameter('merchantData', $value);
    }

    public function getMerchantId()
    {
        return $this->getParameter('merchantId');
    }

    public function setMerchantId($value)
    {
        return $this->setParameter('merchantId', $value);
    }

    public function getMerchantName()
    {
        return $this->getParameter('merchantName');
    }

    public function setMerchantName($value)
    {
        return $this->setParameter('merchantName', $value);
    }

    public function getTerminalId()
    {
        return $this->getParameter('terminalId');
    }

    public function setTerminalId($value)
    {
        return $this->setParameter('terminalId', $value);
    }


    /**
     * Get the email field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.email field in Redsys documentation.
     *
     * @return string
     */
    public function getEmail()
    {
        return $this->getParameter('email');
    }

    /**
     * Set the email field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.email field in Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setEmail($value)
    {
        return $this->setParameter('email', $value);
    }

    /**
     * Get the homePhoneCountryPrefix field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.homePhone.cc field in Redsys documentation.
     *
     * @return string
     */
    public function getHomePhoneCountryPrefix()
    {
        return $this->getParameter('homePhoneCountryPrefix');
    }
    
    /**
     * Set the homePhoneCountryPrefix field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.homePhone.cc field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setHomePhoneCountryPrefix($value)
    {
        return $this->setParameter('homePhoneCountryPrefix', $value);
    }
    
    /**
     * Get the homePhone field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.homePhone.subscriber field in Redsys documentation.
     *
     * @return string
     */
    public function getHomePhone()
    {
        return $this->getParameter('homePhone');
    }
    
    /**
     * Set the homePhone field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.homePhone.subscriber field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setHomePhone($value)
    {
        return $this->setParameter('homePhone', $value);
    }
    
    /**
     * Get the mobilePhoneCountryPrefix field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.mobilePhone.cc field in Redsys documentation.
     *
     * @return string
     */
    public function getMobilePhoneCountryPrefix()
    {
        return $this->getParameter('mobilePhoneCountryPrefix');
    }
    
    /**
     * Set the mobilePhoneCountryPrefix field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.mobilePhone.cc field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setMobilePhoneCountryPrefix($value)
    {
        return $this->setParameter('mobilePhoneCountryPrefix', $value);
    }
    
    /**
     * Get the mobilePhone field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.mobilePhone.subscriber field in Redsys documentation.
     *
     * @return string
     */
    public function getMobilePhone()
    {
        return $this->getParameter('mobilePhone');
    }
    
    /**
     * Set the mobilePhone field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.mobilePhone.subscriber field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setMobilePhone($value)
    {
        return $this->setParameter('mobilePhone', $value);
    }
    
    /**
     * Get the workPhoneCountryPrefix field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.workPhone.cc field in Redsys documentation.
     *
     * @return string
     */
    public function getWorkPhoneCountryPrefix()
    {
        return $this->getParameter('workPhoneCountryPrefix');
    }
    
    /**
     * Set the workPhoneCountryPrefix field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.workPhone.cc field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setWorkPhoneCountryPrefix($value)
    {
        return $this->setParameter('workPhoneCountryPrefix', $value);
    }
    
    /**
     * Get the workPhone field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.workPhone.subscriber field in Redsys documentation.
     *
     * @return string
     */
    public function getWorkPhone()
    {
        return $this->getParameter('workPhone');
    }
    
    /**
     * Set the workPhone field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.workPhone.subscriber field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setWorkPhone($value)
    {
        return $this->setParameter('workPhone', $value);
    }

    /**
     * Get the shippingAddress1 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrLine1 field in the Redsys documentation.
     *
     * @return string
     */
    public function getShippingAddress1()
    {
        return $this->getParameter('shippingAddress1');
    }

    /**
     * Set the shippingAddress1 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrLine1 field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setShippingAddress1($value)
    {
        return $this->setParameter('shippingAddress1', $value);
    }

    /**
     * Get the shippingAddress2 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrLine2 field in the Redsys documentation.
     *
     * @return string
     */
    public function getShippingAddress2()
    {
        return $this->getParameter('shippingAddress2');
    }

    /**
     * Set the shippingAddress2 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrLine2 field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setShippingAddress2($value)
    {
        return $this->setParameter('shippingAddress2', $value);
    }

    /**
     * Get the shippingAddress3 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrLine3 field in the Redsys documentation.
     *
     * @return string
     */
    public function getShippingAddress3()
    {
        return $this->getParameter('shippingAddress3');
    }

    /**
     * Set the shippingAddress3 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrLine3 field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setShippingAddress3($value)
    {
        return $this->setParameter('shippingAddress3', $value);
    }

    /**
     * Get the shippingCity field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrCity field in the Redsys documentation.
     *
     * @return string
     */
    public function getShippingCity()
    {
        return $this->getParameter('shippingCity');
    }

    /**
     * Set the shippingCity field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrCity field in the Redsys documentation.
     *
     * @param string $value The shipping state as an ISO3166-2 subdivision code, e.g. CA for California.
     * @return self
     */
    public function setShippingCity($value)
    {
        return $this->setParameter('shippingCity', $value);
    }

    /**
     * Get the shippingPostcode field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrPostCode field in the Redsys documentation.
     *
     * @return string
     */
    public function getShippingPostcode()
    {
        return $this->getParameter('shippingPostcode');
    }

    /**
     * Set the shippingPostcode field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrPostCode field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setShippingPostcode($value)
    {
        return $this->setParameter('shippingPostcode', $value);
    }

    /**
     * Get the shippingState field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrState field in the Redsys documentation.
     *
     * @return string The shipping state as an ISO3166-2 subdivision code, e.g. CA for California.
     */
    public function getShippingState()
    {
        return $this->getParameter('shippingState');
    }

    /**
     * Set the shippingState field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrState field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setShippingState($value)
    {
        return $this->setParameter('shippingState', $value);
    }

    /**
     * Get the shippingCountry field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrCountry field in the Redsys documentation.
     *
     * @return int The shipping country as an ISO3166 numeric code, e.g. 840 for USA.
     */
    public function getShippingCountry()
    {
        return $this->getParameter('shippingCountry');
    }

    /**
     * Set the shippingCountry field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.shipAddrCountry field in the Redsys documentation.
     *
     * @param int $value The shipping country as an ISO3166 numeric code, e.g. 840 for USA.
     * @return self
     */
    public function setShippingCountry($value)
    {
        return $this->setParameter('shippingCountry', $value);
    }
    
    /**
     * Get the billingAddress1 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrLine1 field in the Redsys documentation.
     *
     * @return string
     */
    public function getBillingAddress1()
    {
        return $this->getParameter('billingAddress1');
    }

    /**
     * Set the billingAddress1 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrLine1 field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setBillingAddress1($value)
    {
        return $this->setParameter('billingAddress1', $value);
    }

    /**
     * Get the billingAddress2 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrLine2 field in the Redsys documentation.
     *
     * @return string
     */
    public function getBillingAddress2()
    {
        return $this->getParameter('billingAddress2');
    }

    /**
     * Set the billingAddress2 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrLine2 field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setBillingAddress2($value)
    {
        return $this->setParameter('billingAddress2', $value);
    }

    /**
     * Get the billingAddress3 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrLine3 field in the Redsys documentation.
     *
     * @return string
     */
    public function getBillingAddress3()
    {
        return $this->getParameter('billingAddress3');
    }

    /**
     * Set the billingAddress3 field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrLine3 field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setBillingAddress3($value)
    {
        return $this->setParameter('billingAddress3', $value);
    }

    /**
     * Get the billingCity field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrCity field in the Redsys documentation.
     *
     * @return string
     */
    public function getBillingCity()
    {
        return $this->getParameter('billingCity');
    }

    /**
     * Set the billingCity field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrCity field in the Redsys documentation.
     *
     * @param string $value The billing state as an ISO3166-2 subdivision code, e.g. CA for California.
     * @return self
     */
    public function setBillingCity($value)
    {
        return $this->setParameter('billingCity', $value);
    }

    /**
     * Get the billingPostcode field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrPostCode field in the Redsys documentation.
     *
     * @return string
     */
    public function getBillingPostcode()
    {
        return $this->getParameter('billingPostcode');
    }

    /**
     * Set the billingPostcode field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrPostCode field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setBillingPostcode($value)
    {
        return $this->setParameter('billingPostcode', $value);
    }

    /**
     * Get the billingState field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrState field in the Redsys documentation.
     *
     * @return string The billing state as an ISO3166-2 subdivision code, e.g. CA for California.
     */
    public function getBillingState()
    {
        return $this->getParameter('billingState');
    }

    /**
     * Set the billingState field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrState field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setBillingState($value)
    {
        return $this->setParameter('billingState', $value);
    }

    /**
     * Get the billingCountry field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrCountry field in the Redsys documentation.
     *
     * @return int The billing country as an ISO3166 numeric code, e.g. 840 for USA.
     */
    public function getBillingCountry()
    {
        return $this->getParameter('billingCountry');
    }

    /**
     * Set the billingCountry field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.billAddrCountry field in the Redsys documentation.
     *
     * @param int $value The billing country as an ISO3166 numeric code, e.g. 840 for USA.
     * @return self
     */
    public function setBillingCountry($value)
    {
        return $this->setParameter('billingCountry', $value);
    }

    /**
     * Get the addressMatch field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.addrMatch field in Redsys documentation.
     *
     * @return boolean
     */
    public function getAddressMatch()
    {
        return $this->getParameter('addressMatch');
    }
    
    /**
     * Set the addressMatch field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.addrMatch field in the Redsys documentation.
     *
     * @param boolean $value
     * @return self
     */
    public function setAddressMatch($value)
    {
        return $this->setParameter('addressMatch', $value);
    }

    /**
     * Get the challengeWindowSize field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.challengeWindowSize field in Redsys documentation.
     *
     * @return int One of the self::CHALLENGE_WINDOW_SIZE_* constants
     */
    public function getChallengeWindowSize()
    {
        return $this->getParameter('challengeWindowSize');
    }
    
    /**
     * Set the challengeWindowSize field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.challengeWindowSize field in the Redsys documentation.
     *
     * @param int $value One of the self::CHALLENGE_WINDOW_SIZE_* constants
     * @return self
     */
    public function setChallengeWindowSize($value)
    {
        return $this->setParameter('challengeWindowSize', $value);
    }
    
    /**
     * Get the customerAdditionalInformation field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctID field in Redsys documentation.
     *
     * @return string
     */
    public function getCustomerAdditionalInformation()
    {
        return $this->getParameter('customerAdditionalInformation');
    }
    
    /**
     * Set the customerAdditionalInformation field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctID field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setCustomerAdditionalInformation($value)
    {
        return $this->setParameter('customerAdditionalInformation', $value);
    }
    
    /**
     * Get the 3DsRequestAuthenticationMethodData field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.threeDSRequestorAuthenticationInfo.threeDSReqAuthData field in Redsys documentation.
     *
     * @return string
     */
    public function get3DsRequestAuthenticationMethodData()
    {
        return $this->getParameter('3DsRequestAuthenticationMethodData');
    }
    
    /**
     * Set the 3DsRequestAuthenticationMethodData field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.threeDSRequestorAuthenticationInfo.threeDSReqAuthData field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function set3DsRequestAuthenticationMethodData($value)
    {
        return $this->setParameter('3DsRequestAuthenticationMethodData', $value);
    }
    
    /**
     * Get the 3DsRequestAuthenticationMethod field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.threeDSRequestorAuthenticationInfo.threeDSReqAuthMethod field in Redsys documentation.
     *
     * @return int One of the self::ACCOUNT_AUTHENTICATION_METHOD_* constants.
     */
    public function get3DsRequestAuthenticationMethod()
    {
        return $this->getParameter('3DsRequestAuthenticationMethod');
    }
    
    /**
     * Set the 3DsRequestAuthenticationMethod field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.threeDSRequestorAuthenticationInfo.threeDSReqAuthMethod field in the Redsys documentation.
     *
     * @param int $value One of the self::ACCOUNT_AUTHENTICATION_METHOD_* constants.
     * @return self
     */
    public function set3DsRequestAuthenticationMethod($value)
    {
        return $this->setParameter('3DsRequestAuthenticationMethod', $value);
    }
    
    /**
     * Get the 3DsRequestAuthenticationTime field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.threeDSRequestorAuthenticationInfo.threeDSReqAuthTimestamp field in Redsys documentation.
     *
     * @return DateTime|int
     */
    public function get3DsRequestAuthenticationTime()
    {
        return $this->getParameter('3DsRequestAuthenticationTime');
    }
    
    /**
     * Set the 3DsRequestAuthenticationTime field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.threeDSRequestorAuthenticationInfo.threeDSReqAuthTimestamp field in the Redsys documentation.
     *
     * @param DateTime|int $value
     * @return self
     */
    public function set3DsRequestAuthenticationTime($value)
    {
        return $this->setParameter('3DsRequestAuthenticationTime', $value);
    }
    
    /**
     * Get the customerAccountCreationIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccAgeInd field in Redsys documentation.
     *
     * @return int CUSTOMER_ACCOUNT_CREATED_*
     */
    public function getCustomerAccountCreationIndicator()
    {
        return $this->getParameter('customerAccountCreationIndicator');
    }
    
    /**
     * Set the customerAccountCreationIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccAgeInd field in the Redsys documentation.
     *
     * @param int $value CUSTOMER_ACCOUNT_CREATED_*
     * @return self
     */
    public function setCustomerAccountCreationIndicator($value)
    {
        return $this->setParameter('customerAccountCreationIndicator', $value);
    }
    
    /**
     * Get the customerAccountCreationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccDate field in Redsys documentation.
     *
     * @return DateTime|int
     */
    public function getCustomerAccountCreationDate()
    {
        return $this->getParameter('customerAccountCreationDate');
    }
    
    /**
     * Set the customerAccountCreationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccDate field in the Redsys documentation.
     *
     * @param DateTime|int $value
     * @return self
     */
    public function setCustomerAccountCreationDate($value)
    {
        return $this->setParameter('customerAccountCreationDate', $value);
    }
    
    /**
     * Get the customerAccountModificationIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccChangeInd field in Redsys documentation.
     *
     * @return int CUSTOMER_ACCOUNT_MODIFIED_*
     */
    public function getCustomerAccountModificationIndicator()
    {
        return $this->getParameter('customerAccountModificationIndicator');
    }
    
    /**
     * Set the customerAccountModificationIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccChangeInd field in the Redsys documentation.
     *
     * @param int $value CUSTOMER_ACCOUNT_MODIFIED_*
     * @return self
     */
    public function setCustomerAccountModificationIndicator($value)
    {
        return $this->setParameter('customerAccountModificationIndicator', $value);
    }

    /**
     * Get the customerAccountModificationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccChange field in Redsys documentation.
     *
     * @return DateTime|int
     */
    public function getCustomerAccountModificationDate()
    {
        return $this->getParameter('customerAccountModificationDate');
    }
    
    /**
     * Set the customerAccountModificationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccChange field in the Redsys documentation.
     *
     * @param DateTime|int $value
     * @return self
     */
    public function setCustomerAccountModificationDate($value)
    {
        return $this->setParameter('customerAccountModificationDate', $value);
    }
    
    /**
     * Get the customerPasswordAgeIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccPwChangeInd field in Redsys documentation.
     *
     * @return int CUSTOMER_ACCOUNT_PASSWORD_MODIFIED_*
     */
    public function getCustomerPasswordModificationIndicator()
    {
        return $this->getParameter('customerPasswordAgeIndicator');
    }
    
    /**
     * Set the customerPasswordAgeIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccPwChangeInd field in the Redsys documentation.
     *
     * @param int $value CUSTOMER_ACCOUNT_PASSWORD_MODIFIED_*
     * @return self
     */
    public function setCustomerPasswordModificationIndicator($value)
    {
        return $this->setParameter('customerPasswordAgeIndicator', $value);
    }

    /**
     * Get the customerPasswordModificationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccPwChange field in Redsys documentation.
     *
     * @return DateTime|int
     */
    public function getCustomerPasswordModificationDate()
    {
        return $this->getParameter('customerPasswordModificationDate');
    }
    
    /**
     * Set the customerPasswordModificationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.chAccPwChange field in the Redsys documentation.
     *
     * @param DateTime|int $value
     * @return self
     */
    public function setCustomerPasswordModificationDate($value)
    {
        return $this->setParameter('customerPasswordModificationDate', $value);
    }
    
    /**
     * Get the customerPurchasesInLast6Months field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.nbPurchaseAccount field in Redsys documentation.
     *
     * @return int
     */
    public function getCustomerPurchasesInLast6Months()
    {
        return $this->getParameter('customerPurchasesInLast6Months');
    }
    
    /**
     * Set the customerPurchasesInLast6Months field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.nbPurchaseAccount field in the Redsys documentation.
     *
     * @param int $value
     * @return self
     */
    public function setCustomerPurchasesInLast6Months($value)
    {
        return $this->setParameter('customerPurchasesInLast6Months', $value);
    }
    
    /**
     * Get the customerAccountCardProvisionsLast24Hours field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.provisionAttemptsDay field in Redsys documentation.
     *
     * @return int
     */
    public function getCustomerAccountCardProvisionsLast24Hours()
    {
        return $this->getParameter('customerAccountCardProvisionsLast24Hours');
    }
    
    /**
     * Set the customerAccountCardProvisionsLast24Hours field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.provisionAttemptsDay field in the Redsys documentation.
     *
     * @param int $value
     * @return self
     */
    public function setCustomerAccountCardProvisionsLast24Hours($value)
    {
        return $this->setParameter('customerAccountCardProvisionsLast24Hours', $value);
    }
    
    /**
     * Get the customerAccountTransactionsLast24Hours field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.txnActivityDay field in Redsys documentation.
     *
     * @return int
     */
    public function getCustomerAccountTransactionsLast24Hours()
    {
        return $this->getParameter('customerAccountTransactionsLast24Hours');
    }
    
    /**
     * Set the customerAccountTransactionsLast24Hours field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.txnActivityDay field in the Redsys documentation.
     *
     * @param int $value
     * @return self
     */
    public function setCustomerAccountTransactionsLast24Hours($value)
    {
        return $this->setParameter('customerAccountTransactionsLast24Hours', $value);
    }
    
    /**
     * Get the customerAccountTransactionsLast24Year field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.txnActivityYear field in Redsys documentation.
     *
     * @return int
     */
    public function getCustomerAccountTransactionsLast24Year()
    {
        return $this->getParameter('customerAccountTransactionsLast24Year');
    }
    
    /**
     * Set the customerAccountTransactionsLast24Year field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.txnActivityYear field in the Redsys documentation.
     *
     * @param int $value
     * @return self
     */
    public function setCustomerAccountTransactionsLast24Year($value)
    {
        return $this->setParameter('customerAccountTransactionsLast24Year', $value);
    }
    
    /**
     * Get the customerPaymentMethodCreationIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.paymentAccInd field in Redsys documentation.
     *
     * @return int PAYMENT_METHOD_CREATED_*
     */
    public function getCustomerPaymentMethodCreationIndicator()
    {
        return $this->getParameter('customerPaymentMethodCreationIndicator');
    }
    
    /**
     * Set the customerPaymentMethodCreationIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.paymentAccInd field in the Redsys documentation.
     *
     * @param int PAYMENT_METHOD_CREATED_* $value
     * @return self
     */
    public function setCustomerPaymentMethodCreationIndicator($value)
    {
        return $this->setParameter('customerPaymentMethodCreationIndicator', $value);
    }
    
    /**
     * Get the customerPaymentMethodCreationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.paymentAccAge field in Redsys documentation.
     *
     * @return DateTime|int
     */
    public function getCustomerPaymentMethodCreationDate()
    {
        return $this->getParameter('customerPaymentMethodCreationDate');
    }
    
    /**
     * Set the customerPaymentMethodCreationDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.paymentAccAge field in the Redsys documentation.
     *
     * @param DateTime|int $value
     * @return self
     */
    public function setCustomerPaymentMethodCreationDate($value)
    {
        return $this->setParameter('customerPaymentMethodCreationDate', $value);
    }
    
    /**
     * Get the shippingAddressFirstUsedIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.shipAddressUsageInd field in Redsys documentation.
     *
     * @return int SHIPPING_ADDRESS_USAGE_*
     */
    public function getShippingAddressFirstUsedIndicator()
    {
        return $this->getParameter('shippingAddressFirstUsedIndicator');
    }
    
    /**
     * Set the shippingAddressFirstUsedIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.shipAddressUsageInd field in the Redsys documentation.
     *
     * @param int $value SHIPPING_ADDRESS_USAGE_*
     * @return self
     */
    public function setShippingAddressFirstUsedIndicator($value)
    {
        return $this->setParameter('shippingAddressFirstUsedIndicator', $value);
    }
    
    /**
     * Get the shippingAddressFirstUsedDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.shipAddressUsage field in Redsys documentation.
     *
     * @return DateTime|int
     */
    public function getShippingAddressFirstUsedDate()
    {
        return $this->getParameter('shippingAddressFirstUsedDate');
    }
    
    /**
     * Set the shippingAddressFirstUsedDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.shipAddressUsage field in the Redsys documentation.
     *
     * @param DateTime|int $value
     * @return self
     */
    public function setShippingAddressFirstUsedDate($value)
    {
        return $this->setParameter('shippingAddressFirstUsedDate', $value);
    }
    
    /**
     * Get the shippingNameCustomerNameMatch field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.shipNameIndicator field in Redsys documentation.
     *
     * @return boolean
     */
    public function getShippingNameCustomerNameMatch()
    {
        return $this->getParameter('shippingNameCustomerNameMatch');
    }
    
    /**
     * Set the shippingNameCustomerNameMatch field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.shipNameIndicator field in the Redsys documentation.
     *
     * @param boolean $value
     * @return self
     */
    public function setShippingNameCustomerNameMatch($value)
    {
        return $this->setParameter('shippingNameCustomerNameMatch', $value);
    }
    
    /**
     * Get the customerHasSuspiciousActivity field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.suspiciousAccActivity field in Redsys documentation.
     *
     * @return boolean
     */
    public function getCustomerHasSuspiciousActivity()
    {
        return $this->getParameter('customerHasSuspiciousActivity');
    }
    
    /**
     * Set the customerHasSuspiciousActivity field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.acctInfo.suspiciousAccActivity field in the Redsys documentation.
     *
     * @param boolean $value
     * @return self
     */
    public function setCustomerHasSuspiciousActivity($value)
    {
        return $this->setParameter('customerHasSuspiciousActivity', $value);
    }
    
    /**
     * Get the deliveryEmail field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.deliveryEmailAddress field in Redsys documentation.
     *
     * @return string
     */
    public function getDeliveryEmail()
    {
        return $this->getParameter('deliveryEmail');
    }
    
    /**
     * Set the deliveryEmail field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.deliveryEmailAddress field in the Redsys documentation.
     *
     * @param string $value
     * @return self
     */
    public function setDeliveryEmail($value)
    {
        return $this->setParameter('deliveryEmail', $value);
    }
    
    /**
     * Get the deliveryTimeframeIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.deliveryTimeframe field in Redsys documentation.
     *
     * @return int DELIVERY_TIMEFRAME_*
     */
    public function getDeliveryTimeframeIndicator()
    {
        return $this->getParameter('deliveryTimeframeIndicator');
    }
    
    /**
     * Set the deliveryTimeframeIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.deliveryTimeframe field in the Redsys documentation.
     *
     * @param int $value DELIVERY_TIMEFRAME_*
     * @return self
     */
    public function setDeliveryTimeframeIndicator($value)
    {
        return $this->setParameter('deliveryTimeframeIndicator', $value);
    }
    
    /**
     * Get the giftCardAmount field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.giftCardAmount field in Redsys documentation.
     *
     * @return int
     */
    public function getGiftCardAmount()
    {
        return $this->getParameter('giftCardAmount');
    }
    
    /**
     * Set the giftCardAmount field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.giftCardAmount field in the Redsys documentation.
     *
     * @param int $value
     * @return self
     */
    public function setGiftCardAmount($value)
    {
        return $this->setParameter('giftCardAmount', $value);
    }
    
    /**
     * Get the giftCardCount field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.giftCardCount field in Redsys documentation.
     *
     * @return int
     */
    public function getGiftCardCount()
    {
        return $this->getParameter('giftCardCount');
    }
    
    /**
     * Set the giftCardCount field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.giftCardCount field in the Redsys documentation.
     *
     * @param int $value
     * @return self
     */
    public function setGiftCardCount($value)
    {
        return $this->setParameter('giftCardCount', $value);
    }
    
    /**
     * Get the giftCardCurrency field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.giftCardCurr field in Redsys documentation.
     *
     * @return string ISO-4217 currency code
     */
    public function getGiftCardCurrency()
    {
        return $this->getParameter('giftCardCurrency');
    }
    
    /**
     * Set the giftCardCurrency field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.giftCardCurr field in the Redsys documentation.
     *
     * @param string $value ISO-4217 currency code
     * @return self
     */
    public function setGiftCardCurrency($value)
    {
        return $this->setParameter('giftCardCurrency', $value);
    }
    
    /**
     * Get the purchasingPreOrder field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.preOrderPurchaseInd field in Redsys documentation.
     *
     * @return boolean True if the customer is purchasing a preorder
     */
    public function getPurchasingPreOrder()
    {
        return $this->getParameter('purchasingPreOrder');
    }
    
    /**
     * Set the purchasingPreOrder field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.preOrderPurchaseInd field in the Redsys documentation.
     *
     * @param boolean $value True if the customer is purchasing a preorder
     * @return self
     */
    public function setPurchasingPreOrder($value)
    {
        return $this->setParameter('purchasingPreOrder', $value);
    }
    
    /**
     * Get the preOrderDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.preOrderDate field in Redsys documentation.
     *
     * @return DateTime|int
     */
    public function getPreOrderDate()
    {
        return $this->getParameter('preOrderDate');
    }
    
    /**
     * Set the preOrderDate field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.preOrderDate field in the Redsys documentation.
     *
     * @param DateTime|int $value
     * @return self
     */
    public function setPreOrderDate($value)
    {
        return $this->setParameter('preOrderDate', $value);
    }
    
    /**
     * Get the customerHasPurchasedProductBefore field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.reorderItemsInd field in Redsys documentation.
     *
     * @return boolean
     */
    public function getCustomerHasPurchasedProductBefore()
    {
        return $this->getParameter('customerHasPurchasedProductBefore');
    }
    
    /**
     * Set the customerHasPurchasedProductBefore field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.reorderItemsInd field in the Redsys documentation.
     *
     * @param boolean $value
     * @return self
     */
    public function setCustomerHasPurchasedProductBefore($value)
    {
        return $this->setParameter('customerHasPurchasedProductBefore', $value);
    }
    
    /**
     * Get the shippingAddressIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.shipIndicator field in Redsys documentation.
     *
     * @return int SHIPPING_*
     */
    public function getShippingAddressIndicator()
    {
        return $this->getParameter('shippingAddressIndicator');
    }
    
    /**
     * Set the shippingAddressIndicator field
     *
     * Corresponds to the Ds_Merchant_Emv3Ds.MerchantRiskIndicator.shipIndicator field in the Redsys documentation.
     *
     * @param int $value SHIPPING_*
     * @return self
     */
    public function setShippingAddressIndicator($value)
    {
        return $this->setParameter('shippingAddressIndicator', $value);
    }

    /**
     * Override the abstract method to add requirement that it must start with 4 numeric characters
     *
     * @param string|int $value The transaction ID (merchant order) to set for the transaction
     */
    public function setTransactionId($value)
    {
        $start = substr($value, 0, 4);
        $numerics = 0;
        foreach (str_split($start) as $char) {
            if (is_numeric($char)) {
                $numerics++;
            } else {
                break;
            }
        }
        $value = str_pad(substr($start, 0, $numerics), 4, 0, STR_PAD_LEFT).substr($value, $numerics);

        parent::setTransactionId($value);
    }

    public function getData()
    {
        $this->validate('merchantId', 'terminalId', 'amount', 'currency');

        return array(
            // mandatory fields
            'Ds_Merchant_MerchantCode'       => $this->getMerchantId(),
            'Ds_Merchant_Terminal'           => $this->getTerminalId(),
            'Ds_Merchant_TransactionType'    => '0',                          // Authorisation
            'Ds_Merchant_Amount'             => $this->getAmountInteger(),
            'Ds_Merchant_Currency'           => $this->getCurrencyNumeric(),  // uses ISO-4217 codes
            'Ds_Merchant_Order'              => $this->getTransactionId(),
            'Ds_Merchant_MerchantUrl'        => $this->getNotifyUrl(),
            // optional fields
            'Ds_Merchant_ProductDescription' => $this->getDescription(),
            'Ds_Merchant_Cardholder'         => $this->getCardholder(),
            'Ds_Merchant_UrlOK'              => $this->getReturnUrl(),
            'Ds_Merchant_UrlKO'              => $this->getReturnUrl(),
            'Ds_Merchant_MerchantName'       => $this->getMerchantName(),
            'Ds_Merchant_ConsumerLanguage'   => $this->getConsumerLanguage(),
            'Ds_Merchant_MerchantData'       => $this->getMerchantData(),
            // 3DS EMV fields
            'Ds_Merchant_Emv3Ds'             => [
                'cardholderName'   => $this->getCardholder(),
                'email'            => $this->getEmail(),
                'homePhone' => [
                    'cc'         => $this->getHomePhoneCountryPrefix(),
                    'subscriber' => $this->getHomePhone(),
                ],
                'mobilePhone' => [
                    'cc'         => $this->getMobilePhoneCountryPrefix(),
                    'subscriber' => $this->getMobilePhone(),
                ],
                'workPhone' => [
                    'cc'         => $this->getWorkPhoneCountryPrefix(),
                    'subscriber' => $this->getWorkPhone(),
                ],
                'shipAddrLine1'                      => $this->getShippingAddress1(),
                'shipAddrLine2'                      => $this->getShippingAddress2(),
                'shipAddrLine3'                      => $this->getShippingAddress3(),
                'shipAddrCity'                       => $this->getShippingCity(),
                'shipAddrPostCode'                   => $this->getShippingPostcode(),
                'shipAddrState'                      => $this->getShippingState(),
                'shipAddrCountry'                    => $this->getShippingCountry(),
                'addrMatch'                          => $this->getAddressMatch() ? "Y" : "N",
                'billAddrLine1'                      => $this->getBillingAddress1(),
                'billAddrLine2'                      => $this->getBillingAddress2(),
                'billAddrLine3'                      => $this->getBillingAddress3(),
                'billAddrCity'                       => $this->getBillingCity(),
                'billAddrPostCode'                   => $this->getBillingPostcode(),
                'billAddrState'                      => $this->getBillingState(),
                'billAddrCountry'                    => $this->getBillingCountry(),
                'challengeWindowSize'                => $this->getChallengeWindowSize(),
                'acctID'                             => $this->getCustomerAdditionalInformation(),
                'threeDSRequestorAuthenticationInfo' => [
                    'threeDSReqAuthData'      => $this->get3DsRequestAuthenticationMethodData(),
                    'threeDSReqAuthMethod'    => $this->get3DsRequestAuthenticationMethod(),
                    'threeDSReqAuthTimestamp' => $this->formatDateTime($this->get3DsRequestAuthenticationTime(), "YmdHi"),
                ],
                'acctInfo'                           => [
                    'chAccAgeInd'           => $this->getCustomerAccountCreationIndicator(),
                    'chAccDate'             => $this->formatDateTime($this->getCustomerAccountCreationDate(), "Ymd"),
                    'chAccChangeInd'        => $this->getCustomerAccountModificationIndicator(),
                    'chAccChange'           => $this->formatDateTime($this->getCustomerAccountModificationDate(), "Ymd"),
                    'chAccPwChangeInd'      => $this->getCustomerPasswordModificationIndicator(),
                    'chAccPwChange'         => $this->formatDateTime($this->getCustomerPasswordModificationDate(), "Ymd"),
                    'nbPurchaseAccount'     => $this->getCustomerPurchasesInLast6Months(),
                    'provisionAttemptsDay'  => $this->getCustomerAccountCardProvisionsLast24Hours(),
                    'txnActivityDay'        => $this->getCustomerAccountTransactionsLast24Hours(),
                    'txnActivityYear'       => $this->getCustomerAccountTransactionsLast24Year(),
                    'paymentAccInd'         => $this->getCustomerPaymentMethodCreationIndicator(),
                    'paymentAccAge'         => $this->formatDateTime($this->getCustomerPaymentMethodCreationDate(), "Ymd"),
                    'shipAddressUsageInd'   => $this->getShippingAddressFirstUsedIndicator(),
                    'shipAddressUsage'      => $this->formatDateTime($this->getShippingAddressFirstUsedDate(), "Ymd"),
                    'shipNameIndicator'     => $this->getShippingNameCustomerNameMatch() ? "01" : "02",
                    'suspiciousAccActivity' => $this->getCustomerHasSuspiciousActivity() ? "02" : "01",
                ],
                'merchantRiskIndicator'              => [
                    'deliveryEmailAddress' => $this->getDeliveryEmail(),
                    'deliveryTimeframe'    => $this->getDeliveryTimeframeIndicator(),
                    'giftCardAmount'       => $this->getGiftCardAmount() === null ? null : (int) $this->getGiftCardAmount(),
                    'giftCardCount'        => $this->getGiftCardCount(),
                    'giftCardCurr'         => $this->getGiftCardCurrency(),
                    'preOrderPurchaseInd'  => $this->getPurchasingPreOrder() ? "02" : "01",
                    'preOrderDate'         => $this->formatDateTime($this->getPreOrderDate(), "Ymd"),
                    'reorderItemsInd'      => $this->getCustomerHasPurchasedProductBefore() ? "02" : "01",
                    'shipIndicator'        => $this->getShippingAddressIndicator(),
                ],
            ],
        );
    }

    public function sendData($data)
    {
        $security = new Security;

        $encoded_data = $security->encodeMerchantParameters($data);

        $response_data = array(
            'Ds_SignatureVersion'   => Security::VERSION,
            'Ds_MerchantParameters' => $encoded_data,
            'Ds_Signature'          => $security->createSignature(
                $encoded_data,
                $data['Ds_Merchant_Order'],
                $this->getHmacKey()
            ),
        );

        return $this->response = new PurchaseResponse($this, $response_data);
    }

    public function getEndpoint()
    {
        return $this->getTestMode() ? $this->testEndpoint : $this->liveEndpoint;
    }
    
    /**
     * Convert a DateTime or timestamp to a formatted date.
     *
     * @param DateTime|int $date The date to format.
     * @param string $format The format to use.
     *
     * @return string|null The formatted date, or null if date isn't a timestamp or DateTime object.
     */
    protected static function formatDateTime($date, $format) {
        if (is_int($date)) {
            return date($format, $date);
        }
        else if ($date instanceof DateTime) {
            return $date->format($format);
        }
    }
}