payment_gateway_datacash.inc

<?php
require_once dirname(__FILE__).'/../../payment_gateway/payment_gateway.inc';
require_once dirname(__FILE__).'/datacash_processor.inc';


class Payment_Gateway_Datacash extends Payment_Gateway
{

    
    private $_redirect_info = NULL;
    
    private $_pass_through_vars = NULL;
    
    
    function __construct($assetid=0)
    {
        parent::__construct($assetid);

    }//end constructor


    function _createAdditional(&$link)
    {
        if (!parent::_createAdditional($link)) return FALSE;

        return ($this->_createBodycopy('display_format', translate('default_bodycopy_content')) && $this->_createBodycopy('card_holder_verification', translate('card_holder_verification_bodycopy_content')));

    }//end _createAdditional()


    function _createBodycopy($link_value, $content)
    {
        $GLOBALS['SQ_SYSTEM']->am->includeAsset('bodycopy');
        $bodycopy = new Bodycopy();
        $copy_link = Array('asset' => &$this, 'link_type' => SQ_LINK_TYPE_2, 'is_dependant' => 1, 'is_exclusive' => 1, 'value' => $link_value);

        $bodycopy->setAttrValue('name', ucwords(str_replace('_',' ', $link_value)));
        $args = Array('content' => $content);
        if ($bodycopy->create($copy_link, $args)) {
            $child_bodycopy = $GLOBALS['SQ_SYSTEM']->am->getLink($bodycopy->id, SQ_LINK_TYPE_2, 'bodycopy_div');
            $GLOBALS['SQ_SYSTEM']->am->releaseLock($child_bodycopy['minorid'], 'attributes');
            return TRUE;
        }
        return FALSE;

    }//end _createBodycopy()


    function _getAllowedLinks()
    {
        $page_links = parent::_getAllowedLinks();
        $page_links[SQ_LINK_TYPE_2]['bodycopy'] = Array('card' => 2,   'exclusive' => TRUE);
        return $page_links;

    }//end _getAllowedLinks()


    function getAvailableKeywords()
    {
        $keywords = parent::getAvailableKeywords();

        $keywords['card_number'] = 'Card Number';
        $keywords['card_start_month'] = 'Card Start Month';
        $keywords['card_start_year'] = 'Card Start Year';
        $keywords['card_expiry_month'] = 'Card Expiry Month';
        $keywords['card_expiry_year'] = 'Card Expiry Year';
        $keywords['card_issue_number'] = 'Card Issue Number';
        $keywords['card_cv2'] = 'Card CV2';
        
        $keywords['street_address1'] = 'Street Address 1';
        $keywords['street_address2'] = 'Street Address 2';
        $keywords['street_address3'] = 'Street Address 3';
        $keywords['street_address4'] = 'Street Address 4';
        $keywords['postcode'] = 'Postcode';
        
        $keywords['transaction_amount'] = 'Transaction Amount';
        $keywords['transaction_currency'] = 'Transaction Currency';
        $keywords['processing_error'] = 'Processing Error (empty if no error)';
        $keywords['submit_button'] = 'Submit Button';
        $keywords['cancel_button'] = 'Cancel Button';
        $keywords['reset_button'] = 'Reset Button';
        $keywords['card_holder_verification_form'] = 'Card Holder Verification Form';
        
        return $keywords;

    }//end getAvailableKeywords()


    function onRequestKeywords(&$broadcaster, $vars=Array())
    {
        $keywords = $this->getAvailableKeywords();
        $vars['keywords'] = array_merge($vars['keywords'], $keywords);

    }//end onRequestKeywords()


    function printBody()
    {
        //this page is redirected to by the child iframe with unknown reference error
        if (array_get_index($_GET, 'unknown_referer', FALSE)) {
            trigger_error('Unknown caller reference');
            exit;
        }
        
        //this page is redirected to by the child iframe with an error message
        if (array_get_index($_GET, 'error_message', FALSE)) {
            $this->_setError($_GET['error_message']);
        }
        
        $success = FALSE;
        $is_in_frame = FALSE; //indicates whether this page is in the iframe after it is redirected to by the ACS
        
        if (empty($_POST['PaRes']) || empty($_POST['MD'])) {
            //THIS PAGE IS REDIRECTED TO BY DELIVERY METHOD OR FORM ECOMMERCE ASSET NOT BY THE ACS
            $amount = array_get_index($_SESSION,'SQ_ECOM_AMOUNT', 0);
            $card_info = array_get_index($_REQUEST, $this->getPrefix().'_card', FALSE);
            $action = array_get_index($_REQUEST, $this->getPrefix().'_action', FALSE);
            
            if ($action == 'Cancel') {
                $this->returnToCaller('CANCEL');
    
            } else if (empty($amount)) {
                unset($_SESSION['SQ_ECOM_AMOUNT']);
                $this->_unsetCurrency();
                //clear pass through variables
                if (isset($_SESSION['SQ_ECOM_PASS_THROUGH_VARS'])) {
                    unset($_SESSION['SQ_ECOM_PASS_THROUGH_VARS']);
                }
                
                $this->appendPendingOrderAuditLog(translate('ecom_payment_no_amount'));
                
                $this->returnToCaller('SUCCESS');
    
            } else if ($card_info) {
                $this->appendPendingOrderAuditLog(translate('ecom_payment_attempted_gateway_contacted'));

                $success = $this->processPayment($card_info);
                //if success = 2, redirect to the Access Control Server (ACS) for Card Holder Verification
                if ($success === 2) {
                    //store the Datacash reference number to authorize payment after the card holder verify himself
                    $_SESSION['SQ_ECOM_TRANSACTION_REF_NO'] = $this->_redirect_info['TRANSACTION'];
                    //print the Card Holder Verification bodycopy
                    $this->printBodycopy('card_holder_verification');
                    return;
                }
            }
            
        } else if (!empty($_SESSION['SQ_ECOM_TRANSACTION_REF_NO']) && ($_POST['MD'] == md5($_SESSION['SQ_ECOM_REF_NO']))) {
            //THIS PAGE IS REDIRECTED TO BY THE ACCESS CONTROL SERVER (ACS) OF ISSUEING BANK AFTER CARD HOLDER VERIFICATION PROCESS
            $is_in_frame = TRUE;
            $datacash_ref = $_SESSION['SQ_ECOM_TRANSACTION_REF_NO'];
            unset($_SESSION['SQ_ECOM_TRANSACTION_REF_NO']);
            $success = $this->authorizePayment($datacash_ref, $_POST['PaRes']);
            if ($success === FALSE) {
                //transaction fails, redirect the parent document of the iframe and display error
                $this->_redirectParent($this->getURL().'?error_message='.urlencode($this->_tmp['error_message'][0]));
            }
        }

        //if transaction is accepted, redirect the user to the success page
        if ($success === 1) {
            unset($_SESSION['SQ_ECOM_AMOUNT']);
            $this->_unsetCurrency();
            //clear pass through variables
            if (isset($_SESSION['SQ_ECOM_PASS_THROUGH_VARS'])) {
                unset($_SESSION['SQ_ECOM_PASS_THROUGH_VARS']);
            }
            //broadcast payment completed trigger event before return
            if (isset($_SESSION['SQ_ECOM_PAYMENT_COMPLETED_BROADCASTER_ASSETID'])) {
                $broadcaster = $GLOBALS['SQ_SYSTEM']->am->getAsset($_SESSION['SQ_ECOM_PAYMENT_COMPLETED_BROADCASTER_ASSETID']);
                if (!empty($broadcaster)) {
                    //put all returned variables in $_SESSION['SQ_ECOM_RESPONSE'] to $_POST array so that the listening trigger can use them
                    $response = array_get_index($_SESSION, 'SQ_ECOM_RESPONSE', FALSE);
                    if ($response) {
                        $_POST['transaction_reference'] = $response['TRANSACTION'];
                        $_POST['transaction_time'] = $response['TIME'];
                        $_POST['transaction_status'] = $response['STATUS'];
                        $_POST['transaction_card_number'] = $response['CARDNO'];
                        $_POST['transaction_amount'] = $response['AMOUNT'];
                        $_POST['transaction_currency'] = $response['CURRENCY'];
                    }
                    $GLOBALS['SQ_SYSTEM']->broadcastTriggerEvent('trigger_event_ecommerce_payment_completed', $broadcaster);
                }
            }
            
            $this->appendPendingOrderAuditLog(translate('ecom_payment_succeeded'));
            
            $this->returnToCaller('SUCCESS', $is_in_frame);
        } else {
            // Notify that the payment was declined
            if ($card_info) {
                $this->appendPendingOrderAuditLog(translate('ecom_payment_declined'));
            }
        }
        
        //print default bodycopy
        $this->printBodycopy('display_format');
        
    }//end printBody()


    function printBodycopy($link_value)
    {
        $bodycopy = $this->getBodycopy($link_value);
        if (is_null($bodycopy)) return;

        $keywords = $bodycopy->getKeywords();
        $replacements = Array();
        foreach ($keywords as $word) {
            $replacements[$word] = $this->getKeywordReplacement($word);
        }
        $bodycopy->setKeywordReplacements($replacements);

        //OUTPUT HERE
        if ($link_value == 'display_format') {
            //the default body copy with card input
            $datapath = sq_web_path('data').'/asset_types/payment_gateway_datacash/files';
            $card = $this->getPrefix().'_card';
    
            if ($this->attr('test_mode')) {
                echo '<h2 class="gateway-test-mode" style="color: white; background-color: #C00; padding: 5px">TEST MODE</h2>';
            }
    
            ?>
            <script src="<?php echo $datapath; ?>/loader.js"></script>
            <script>
                var Loader = new Loader('<?php echo $card; ?>','#FFFFFF','Processing Transaction...','<?php echo $datapath; ?>/loader.gif');
                Loader.print();
            </script>
            <form method="post" action="<?php echo $this->getURL(); ?>" onsubmit="Loader.show();">
            <?php
            $bodycopy->printBody();
            echo '</form>';
        } else {
            //the card holder verification bodycopy
            $bodycopy->printBody();
        }

    }//end printBodycopy()


    function getBodycopy($link_value)
    {
        $link = $GLOBALS['SQ_SYSTEM']->am->getLink($this->id, SQ_LINK_TYPE_2, 'bodycopy', TRUE, $link_value);
        if (empty($link)) return NULL;
        $bodycopy = $GLOBALS['SQ_SYSTEM']->am->getAsset($link['minorid'], $link['minor_type_code']);
        return $bodycopy;

    }//end getBodycopy()


    function processPayment($card_info)
    {
        if (!$card_info) return FALSE;

        $amount = $_SESSION['SQ_ECOM_AMOUNT'];

        $processor = new Datacash_Processor($this->attr('client'), $this->attr('password'), $this->attr('datacash_api_path'), $this->attr('cardinfo_dir_path'), $this->attr('timeout'), $this->attr('test_mode'));

        //SET AMOUNT
        if (empty($amount)) {
            $this->_setError(translate('datacash_amount_not_specified'));
        } else {
            $processor->setAmount($amount, $this->_getCurrency());
        }
        
        //SET MERCHANT REFERENCE
        //merchant reference number should be generated here instead of inside default_delivery_method.inc or form_ecommerce.inc
        //because the customer can try to pay many times until his card is accepted. So each time a payment transaction
        //is sent to Datacash, a new merchant reference number should be used because using the old reference number can
        //cause the "duplicate reference" error. We can see that Datacash reference number is different in every response
        $processor->setMerchantReference(md5(session_id().time()));
        //get the merchant reference number back, it was changed because Datacash requires that merchant reference number length must be between 6 and 30 alphanumeric characters
        $_SESSION['SQ_ECOM_REF_NO'] = $processor->getMerchantReference();
        
        //store the merchant reference number to the pending order asset before processing
        $this->setPendingOrderMerchantReference($_SESSION['SQ_ECOM_REF_NO']);
        
        //SET CARD NUMBER
        if (empty($card_info['number'])) {
            $this->_setError(translate('datacash_card_number_not_specified'));
        } else {
            $card_info['number'] = str_replace(Array(' ', "\t"), '', $card_info['number']);
            $processor->setCardNumber($card_info['number']);
        }
        
        //SET CARD EXPIRY DATE
        if ($this->_isValidDate(array_get_index($card_info, 'expiry_month', ''), array_get_index($card_info, 'expiry_year', ''))) {
            $processor->setCardExpiryDate($card_info['expiry_month'], $card_info['expiry_year']);
        } else {
            $this->_setError(translate('datacash_expiry_date_invalid'));
        }
        
        //SET CARD START DATE IF SPECIFIED BECAUSE START DATE IS ONLY REQUIRED FOR SOME CARD TYPES, E.G. SOLO
        if (!empty($card_info['start_month']) || !empty($card_info['start_year'])) {
            if ($this->_isValidDate(array_get_index($card_info, 'start_month', ''), array_get_index($card_info, 'start_year', ''))) {
                $processor->setCardStartDate($card_info['start_month'], $card_info['start_year']);
            } else {
                $this->_setError(translate('datacash_start_date_invalid'));
            }
        }
        
        //SET CARD ISSUE NUMBER, IF SPECIFIED
        if (!empty($card_info['issue_number'])) {
            if ($this->_isValidIssueNumber($card_info['issue_number'])) {
                $processor->setCardIssueNumber($card_info['issue_number']);
            } else {
                $this->_setError(translate('datacash_issue_number_invalid'));
            }
        }
        
        //SET CARD CV2, IF SPECIFIED
        if (!empty($card_info['cv2'])) {
            if ($this->_isValidCV2($card_info['cv2'])) {
                $processor->setCardCV2($card_info['cv2']);
            } else {
                $this->_setError(translate('datacash_card_cv2_invalid'));
            }
        }
        
        $addr = '';
        //SET STREET ADDRESS (1 - 4)
        for ($i = 1; $i < 5; $i++) {
            if (!empty($card_info['street_address'.$i])) {
                $addr .= $card_info['street_address'.$i]."\n";
                $processor->setStreetAddress($i, $card_info['street_address'.$i]);
            }
        }
        
        //SET POSTCODE
        if (!empty($card_info['postcode'])) {
            $addr .= $card_info['postcode']."\n";
            $processor->setPostcode($card_info['postcode']);
        }
        
        //SET TRANSACTION TYPE AS "AUTH" (ONE STAGE PROCESSING)
        $processor->setTransactionTypeAuth();
        
        //SET 3-D SECURE PARAMETERS
        $nonthreed_card_types = $this->attr('nonthreed_card_types');
        $processor->setThreeDSecureParams($this->attr('merchant_url'), $this->attr('purchase_desc'), time(), empty($nonthreed_card_types)? Array() : explode('|', $nonthreed_card_types));

        //SET AVS/CV2
        $policy = $this->attr('avscv2_standard_policy');
        if ($policy != 0) {
            $processor->setStandardPolicy($policy);
            
            if (($policy == 2) || ($policy == 3) || ($policy == 6) || ($policy == 7)) {
                if (empty($card_info['cv2'])) {
                    $this->_setError(translate('datacash_card_cv2_not_specified'));
                }
            }
            
            if (($policy == 1) || ($policy == 3) || ($policy == 5) || ($policy == 7)) {
                if (empty($card_info['street_address1']) && empty($card_info['street_address2']) && empty($card_info['street_address3']) && empty($card_info['street_address4'])) {
                    $this->_setError(translate('datacash_street_address_not_specified'));
                }
                
                if (empty($card_info['postcode'])) {
                    $this->_setError(translate('datacash_postcode_not_specified'));
                }
            }
            
        }
        
        //CHECK IF THERE IS ERROR BEFORE SENDING DATA TO DATACASH SERVER, RETURN FALSE
        if ($this->isError()) {
            return FALSE;
        }
        
        $success = $processor->process();

        //GET RESPONSE
        $response = $processor->getResponse();
        
        //if success is 1 (payment is accepted) or 2 (redirect)
        if ($success) {
            //store the last 4 digits of card number to display it later in Form Ecommerce or Delivery Method through the Session variable SQ_ECOM_RESPONSE
            $_SESSION['SQ_ECOM_FORMATTED_CARD_NUMBER'] = $this->_getFormattedCardNumber($card_info['number']);
            //store the billing address to store in the Order asset of Form Ecommerce
            $_SESSION['SQ_ECOM_ORDER_BILLING_ADDR'] = $addr;
        }
        
        //if $success = 2, redirect user for card holder verification
        if ($success === 2) {
            $this->_redirect_info = $response;
        } else {
            //success = 1 or FALSE
            $this->_setTransactionResult($success, $response);
        }

        return $success;

    }//end processPayment()
    
    
    function authorizePayment($datacash_ref, $pares)
    {
        $processor = new Datacash_Processor($this->attr('client'), $this->attr('password'), $this->attr('datacash_api_path'), $this->attr('cardinfo_dir_path'), $this->attr('timeout'), $this->attr('test_mode'));
        
        $success = $processor->authorize($datacash_ref, $pares);

        //get response
        $response = $processor->getResponse();
        
        $this->_setTransactionResult($success, $response);
        
        return $success;
        
    }//end authorizePayment()
    
    
    private function _setTransactionResult($success, $response)
    {
        if ($success === FALSE) {
            $this->_setError($response['STATUS']);
        } else { //success = 1
            if ($this->attr('test_mode')) {
                $response['STATUS'] = '!!!ATTENTION!!! TEST MODE (transaction not performed) -- '.$response['STATUS'];
            }

            $card_no = '';
            if (isset($_SESSION['SQ_ECOM_FORMATTED_CARD_NUMBER'])) {
                $card_no = $_SESSION['SQ_ECOM_FORMATTED_CARD_NUMBER'];
                unset($_SESSION['SQ_ECOM_FORMATTED_CARD_NUMBER']);
            }
            
            $response['CARDNO'] = $card_no;
            $response['AMOUNT'] = $_SESSION['SQ_ECOM_AMOUNT'];
            $response['CURRENCY'] = $this->_getCurrency();
            
            $billing_addr = '';
            if (isset($_SESSION['SQ_ECOM_ORDER_BILLING_ADDR'])) {
                $billing_addr = $_SESSION['SQ_ECOM_ORDER_BILLING_ADDR'];
                unset($_SESSION['SQ_ECOM_ORDER_BILLING_ADDR']);
            }
            $response['BILLING_ADDR'] = $billing_addr;
            
            $_SESSION['SQ_ECOM_RESPONSE']   = $response;
        }
        
    }//end _setTransactionResult()
    

    private function _getFormattedCardNumber($card_number)
    {
        $card_no = $card_number;
        $card_len = strlen($card_no);
        if ($card_len == 16) {
            $card_no = '****-****-****-'.substr($card_no, -4);
        } else {
            $card_no = str_pad(substr($card_no, -4), $card_len, '*', STR_PAD_LEFT);
        }
        
        return $card_no;
        
    }//end _getFormattedCardNumber()

    
    function returnToCaller($state='SUCCESS', $is_in_frame = FALSE)
    {
        $back_url = NULL;

        if ($state == 'SUCCESS') {
            $back_url = array_get_index($_SESSION, 'SQ_ECOM_SUCCESS_URL');
        } else if ($state == 'CANCEL') {
            $back_url = array_get_index($_SESSION, 'SQ_ECOM_CANCEL_URL');
        }

        unset($_SESSION['SQ_ECOM_SUCCESS_URL']);
        unset($_SESSION['SQ_ECOM_CANCEL_URL']);
            
        if (is_null($back_url)) {
            if ($is_in_frame) {
                $this->_redirectParent($this->getURL().'?unknown_referer=1');
            } else {
                trigger_error('Unknown caller reference');
                exit;
            }
        } else {
            if ($is_in_frame) {
                $this->_redirectParent($back_url);
            }else {
                header('Location: '.$back_url);
                exit;
            }
        }
        
    }//end returnToCaller()
    
    
    private function _redirectParent($url)
    {
        $string = <<<HEREDOC
<script type="text/javascript">
    if (parent != self) {
        parent.location = "{$url}";
    }
</script>
HEREDOC;
                
        echo $string;
        exit;
        
    }//end _redirectParent()


    function getCardNumberKeywordReplacement()
    {
        $prefix = $this->getPrefix();
        $card = $prefix.'_card';

        // set variables for test mode
        if ($this->attr('test_mode')) {
            $test_card_numbers = Datacash_Processor::getTestCardNumbers();
            $card_number = '<select name="'.$card.'[number]">';
            foreach ($test_card_numbers as $number => $label) {
                $card_number .= '<option value="'.$number.'" >'.$label.'</option>';
            }
            $card_number .= '</select>';
        } else {
            $card_number = '<input name="'.$card.'[number]" autocomplete="off" />';
        }

        return $card_number;

    }//end getCardNumberKeywordReplacement()


    function getCardStartMonthKeywordReplacement()
    {
        $card = $this->getPrefix().'_card';

        $string = '<input name="'.$card.'[start_month]" size="2" autocomplete="off" />';
        
        return $string;

    }//end getCardStartMonthKeywordReplacement()


    function getCardStartYearKeywordReplacement()
    {
        $card = $this->getPrefix().'_card';

        $string = '<input name="'.$card.'[start_year]" size="2" autocomplete="off" />';
        
        return $string;

    }//end getCardStartYearKeywordReplacement()


    function getCardExpiryMonthKeywordReplacement()
    {
        $card = $this->getPrefix().'_card';

        $string = '<input name="'.$card.'[expiry_month]" size="2" autocomplete="off" />';
        
        return $string;

    }//end getCardExpiryMonthKeywordReplacement()


    function getCardExpiryYearKeywordReplacement()
    {
        $card = $this->getPrefix().'_card';

        $string = '<input name="'.$card.'[expiry_year]" size="2" autocomplete="off" />';
        
        return $string;

    }//end getCardExpiryYearKeywordReplacement()


    function getCardIssueNumberKeywordReplacement()
    {
        $card = $this->getPrefix().'_card';

        $string = '<input name="'.$card.'[issue_number]" size="4" autocomplete="off" />';
        
        return $string;

    }//end getCardIssueNumberKeywordReplacement()


    function getCardCv2KeywordReplacement()
    {
        $card = $this->getPrefix().'_card';

        $string = '<input name="'.$card.'[cv2]" size="4" autocomplete="off" />';
        
        return $string;

    }//end getCardCv2KeywordReplacement()
    
    
    function getStreetAddress1KeywordReplacement()
    {
        ob_start();
        $card = $this->getPrefix().'_card';
        text_box($card.'[street_address1]', $this->_getDefaultInputFromPassThroughAttribute('addr1_var_name'));
        
        return ob_get_clean();

    }//end getStreetAddress1KeywordReplacement()

    
    function getStreetAddress2KeywordReplacement()
    {
        ob_start();
        $card = $this->getPrefix().'_card';
        text_box($card.'[street_address2]', $this->_getDefaultInputFromPassThroughAttribute('addr2_var_name'));
        
        return ob_get_clean();

    }//end getStreetAddress2KeywordReplacement()
    

    function getStreetAddress3KeywordReplacement()
    {
        ob_start();
        $card = $this->getPrefix().'_card';
        text_box($card.'[street_address3]', $this->_getDefaultInputFromPassThroughAttribute('addr3_var_name'));
        
        return ob_get_clean();

    }//end getStreetAddress3KeywordReplacement()
    

    function getStreetAddress4KeywordReplacement()
    {
        ob_start();
        $card = $this->getPrefix().'_card';
        text_box($card.'[street_address4]', $this->_getDefaultInputFromPassThroughAttribute('addr4_var_name'));
        
        return ob_get_clean();

    }//end getStreetAddress4KeywordReplacement()
    
    
    function getPostcodeKeywordReplacement()
    {
        ob_start();
        $card = $this->getPrefix().'_card';
        text_box($card.'[postcode]', $this->_getDefaultInputFromPassThroughAttribute('postcode_var_name'));
        
        return ob_get_clean();

    }//end getPostcodeKeywordReplacement()
    
    
    function getTransactionAmountKeywordReplacement()
    {
        $amount = array_get_index($_SESSION,'SQ_ECOM_AMOUNT', 0);

        return $amount;

    }//end getTransactionAmountKeywordReplacement()


    function getTransactionCurrencyKeywordReplacement()
    {
        return $this->_getCurrency();

    }//end getTransactionAmountKeywordReplacement()
    
    
    function getProcessingErrorKeywordReplacement()
    {
        if ($this->isError()) {
            return '<span class="payment-gateway-transaction-error">'.$this->getErrorMessage().'</span>';
        }

        return '';

    }//end getProcessingErrorKeywordReplacement()


    function getSubmitButtonKeywordReplacement()
    {
        $button_text = $this->attr('submit_text');
        if (empty($button_text)) $button_text = 'Submit';
        
        return '<input type="submit" value="'.$button_text.'" />';

    }//end getSubmitButtonKeywordReplacement()


    function getResetButtonKeywordReplacement()
    {
        $button_text = $this->attr('reset_text');
        if (empty($button_text)) $button_text = 'Reset';
        
        return '<input type="reset" value="'.$button_text.'" />';

    }//end getResetButtonKeywordReplacement()


    function getCancelButtonKeywordReplacement()
    {
        $button_text = $this->attr('cancel_text');
        if (empty($button_text)) $button_text = 'Cancel';
        
        return '<input type="submit" name="'.$this->getPrefix().'_action" value="'.$button_text.'" />';

    }//end getCancelButtonKeywordReplacement()
    

    function getCardHolderVerificationFormKeywordReplacement()
    {
        $md = md5($_SESSION['SQ_ECOM_REF_NO']);
        
        $string = <<<HEREDOC
<form name="PARequestForm" action="{$this->_redirect_info['ACS_URL']}" method="POST">
    <input type="hidden" name="PaReq" value="{$this->_redirect_info['PAREQ_MESSAGE']}">
    <input type="hidden" name="TermUrl" value="{$this->getURL()}">
    <input type="hidden" name="MD" value="{$md}">
</form>
<iframe name="ACSframe" width="390" height="400" frameborder="0">
    <b>Your browser does not support iframes</b>
</iframe>
<script type="text/javascript">
    window.onload = function()
    {
        document.PARequestForm.target = "ACSframe";
        document.PARequestForm.submit();
    }
</script>
HEREDOC;
        
        return $string;

    }//end getCardHolderVerificationFormKeywordReplacement()
    
    
    private function _setError($err_message)
    {
        $this->_tmp['is_error'] = TRUE;
        $this->_tmp['error_message'][] = $err_message;
        
    }//end _setError()
    
    
    private function _isValidDate($month, $year)
    {
        $valid = FALSE;
        
        $two_digits_pattern = '/^\d{2}$/';
        //month and year must have 2 digit pattern mm/yy
        if (preg_match($two_digits_pattern, $month) && preg_match($two_digits_pattern, $year)) {
            //month must be in 1 and 12
            if ((0 < $month) && ($month < 13)) {
                $valid = TRUE;
            }
        }
        
        return $valid;
        
    }//end _isValidDate()
    
    
    private function _isValidIssueNumber($issue_no)
    {
        $valid = FALSE;
        
        $pattern = '/^\d{1,2}$/';
        //issue number must be one or two digits long
        if (preg_match($pattern, $issue_no)) {
            $valid = TRUE;
        }
        
        return $valid;
        
    }//end _isValidIssueNumber()
    

    private function _isValidCV2($cv2)
    {
        $valid = FALSE;
        
        $pattern = '/^\d{3,4}$/';
        //cv2 must be three or four (AMEX card only) digits long
        if (preg_match($pattern, $cv2)) {
            $valid = TRUE;
        }
        
        return $valid;
        
    }//end _isValidCV2()
    
    
    private function _getPassThroughVariable($var_name, $default)
    {
        if (is_null($this->_pass_through_vars)) {
            $this->_pass_through_vars = array_get_index($_SESSION, 'SQ_ECOM_PASS_THROUGH_VARS', Array());
        }
        
        return array_get_index($this->_pass_through_vars, $var_name, $default);
        
    }//end _getPassThroughVariable()
    
    
    private function _getDefaultInputFromPassThroughAttribute($attr_name)
    {
        $result = '';
        $var_name = $this->attr($attr_name);
        if (!empty($var_name)) {
            $result = $this->_getPassThroughVariable($var_name, '');
        }
        
        return $result;
        
    }//end _getDefaultInputFromPassThroughAttribute()
    
    
    private function _getCurrency()
    {
        return isset($_SESSION['SQ_ECOM_CURRENCY'])? $_SESSION['SQ_ECOM_CURRENCY'] : $this->attr('currency');
        
    }//end _getCurrency()
    
    
    private function _unsetCurrency()
    {
        if (isset($_SESSION['SQ_ECOM_CURRENCY'])) {
            unset($_SESSION['SQ_ECOM_CURRENCY']);
        }
        
    }//end _unsetCurrency()
    
    
    public function isError()
    {
        return array_get_index($this->_tmp, 'is_error', FALSE);
        
    }//end isError()
    
    
    public function getErrorMessage()
    {
        $err_message = '';
        $errors = array_get_index($this->_tmp, 'error_message', Array());
        foreach ($errors as $error) {
            $err_message .= "<li>$error </li>";
        }
        
        return '<ul>'.$err_message.'</ul>';
        
    }//end getErrorMessage()
    

}//end class

?>