recca0120 / payum-ecpay

sdk/ECPay.Payment.Integration.php

<?php

/**
 * 付款方式。
 */
abstract class ECPay_PaymentMethod
{
    /**
     * 不指定付款方式。
     */
    const ALL = 'ALL';

    /**
     * 信用卡付費。
     */
    const Credit = 'Credit';

    /**
     * 網路 ATM。
     */
    const WebATM = 'WebATM';

    /**
     * 自動櫃員機。
     */
    const ATM = 'ATM';

    /**
     * 超商代碼。
     */
    const CVS = 'CVS';

    /**
     * 超商條碼。
     */
    const BARCODE = 'BARCODE';
}

/**
 * 付款方式子項目。
 */
abstract class ECPay_PaymentMethodItem
{
    /**
     * 不指定。
     */
    const None = '';
    // WebATM 類(001~100)
    /**
     * 台新銀行。
     */
    const WebATM_TAISHIN = 'TAISHIN';

    /**
     * 玉山銀行。
     */
    const WebATM_ESUN = 'ESUN';

    /**
     * 華南銀行。
     */
    const WebATM_HUANAN = 'HUANAN';

    /**
     * 台灣銀行。
     */
    const WebATM_BOT = 'BOT';

    /**
     * 台北富邦。
     */
    const WebATM_FUBON = 'FUBON';

    /**
     * 中國信託。
     */
    const WebATM_CHINATRUST = 'CHINATRUST';

    /**
     * 第一銀行。
     */
    const WebATM_FIRST = 'FIRST';

    /**
     * 國泰世華。
     */
    const WebATM_CATHAY = 'CATHAY';

    /**
     * 兆豐銀行。
     */
    const WebATM_MEGA = 'MEGA';

    /**
     * 元大銀行。
     */
    const WebATM_YUANTA = 'YUANTA';

    /**
     * 土地銀行。
     */
    const WebATM_LAND = 'LAND';
    // ATM 類(101~200)
    /**
     * 台新銀行。
     */
    const ATM_TAISHIN = 'TAISHIN';

    /**
     * 玉山銀行。
     */
    const ATM_ESUN = 'ESUN';

    /**
     * 華南銀行。
     */
    const ATM_HUANAN = 'HUANAN';

    /**
     * 台灣銀行。
     */
    const ATM_BOT = 'BOT';

    /**
     * 台北富邦。
     */
    const ATM_FUBON = 'FUBON';

    /**
     * 中國信託。
     */
    const ATM_CHINATRUST = 'CHINATRUST';

    /**
     * 土地銀行。
     */
    const ATM_LAND = 'LAND';

    /**
     * 國泰世華銀行。
     */
    const ATM_CATHAY = 'CATHAY';

    /**
     * 大眾銀行。
     */
    const ATM_Tachong = 'Tachong';

    /**
     * 永豐銀行。
     */
    const ATM_Sinopac = 'Sinopac';

    /**
     * 彰化銀行。
     */
    const ATM_CHB = 'CHB';

    /**
     * 第一銀行。
     */
    const ATM_FIRST = 'FIRST';

    // 超商類(201~300)
    /**
     * 超商代碼繳款。
     */
    const CVS = 'CVS';

    /**
     * OK超商代碼繳款。
     */
    const CVS_OK = 'OK';

    /**
     * 全家超商代碼繳款。
     */
    const CVS_FAMILY = 'FAMILY';

    /**
     * 萊爾富超商代碼繳款。
     */
    const CVS_HILIFE = 'HILIFE';

    /**
     * 7-11 ibon代碼繳款。
     */
    const CVS_IBON = 'IBON';

    // 其他類(901~999)
    /**
     * 超商條碼繳款。
     */
    const BARCODE = 'BARCODE';

    /**
     * 信用卡(MasterCard/JCB/VISA)。
     */
    const Credit = 'Credit';

    /**
     * 貨到付款。
     */
    const COD = 'COD';
}

/**
 * 額外付款資訊。
 */
abstract class ECPay_ExtraPaymentInfo
{
    /**
     * 需要額外付款資訊。
     */
    const Yes = 'Y';

    /**
     * 不需要額外付款資訊。
     */
    const No = 'N';
}

/**
 * 額外付款資訊。
 */
abstract class ECPay_DeviceType
{
    /**
     * 桌機版付費頁面。
     */
    const PC = 'P';

    /**
     * 行動裝置版付費頁面。
     */
    const Mobile = 'M';
}

/**
 * 信用卡訂單處理動作資訊。
 */
abstract class ECPay_ActionType
{
    /**
     * 關帳.
     */
    const C = 'C';

    /**
     * 退刷.
     */
    const R = 'R';

    /**
     * 取消.
     */
    const E = 'E';

    /**
     * 放棄.
     */
    const N = 'N';
}

/**
 * 定期定額的週期種類。
 */
abstract class ECPay_PeriodType
{
    /**
     * 無
     */
    const None = '';

    /**
     * 年.
     */
    const Year = 'Y';

    /**
     * 月.
     */
    const Month = 'M';

    /**
     * 日.
     */
    const Day = 'D';
}

/**
 * 電子發票開立註記。
 */
abstract class ECPay_InvoiceState
{
    /**
     * 需要開立電子發票。
     */
    const Yes = 'Y';

    /**
     * 不需要開立電子發票。
     */
    const No = '';
}

/**
 * 電子發票載具類別.
 */
abstract class ECPay_CarrierType
{
    // 無載具
    const None = '';

    // 會員載具
    const Member = '1';

    // 買受人自然人憑證
    const Citizen = '2';

    // 買受人手機條碼
    const Cellphone = '3';
}

/**
 * 電子發票列印註記.
 */
abstract class ECPay_PrintMark
{
    // 不列印
    const No = '0';

    // 列印
    const Yes = '1';
}

/**
 * 電子發票捐贈註記.
 */
abstract class ECPay_Donation
{
    // 捐贈
    const Yes = '1';

    // 不捐贈
    const No = '2';
}

/**
 * 通關方式.
 */
abstract class ECPay_ClearanceMark
{
    // 經海關出口
    const Yes = '1';

    // 非經海關出口
    const No = '2';
}

/**
 * 課稅類別.
 */
abstract class ECPay_TaxType
{
    // 應稅
    const Dutiable = '1';

    // 零稅率
    const Zero = '2';

    // 免稅
    const Free = '3';

    // 應稅與免稅混合(限收銀機發票無法分辦時使用，且需通過申請核可)
    const Mix = '9';
}

/**
 * 字軌類別.
 */
abstract class ECPay_InvType
{
    // 一般稅額
    const General = '07';

    // 特種稅額
    const Special = '08';
}

abstract class ECPay_EncryptType
{
    // MD5(預設)
    const ENC_MD5 = 0;

    // SHA256
    const ENC_SHA256 = 1;
}

/**
 * AllInOne short summary.
 *
 * AllInOne description.
 *
 * @version 1.1.0818
 * @author charlie
 */
class ECPay_AllInOne
{
    public $ServiceURL = 'ServiceURL';
    public $ServiceMethod = 'ServiceMethod';
    public $HashKey = 'HashKey';
    public $HashIV = 'HashIV';
    public $MerchantID = 'MerchantID';
    public $PaymentType = 'PaymentType';
    public $Send = 'Send';
    public $SendExtend = 'SendExtend';
    public $Query = 'Query';
    public $Action = 'Action';
    public $EncryptType = ECPay_EncryptType::ENC_MD5;

    public function __construct()
    {
        $this->PaymentType = 'aio';
        $this->Send = [
            'ReturnURL' => '',
            'ClientBackURL' => '',
            'OrderResultURL' => '',
            'MerchantTradeNo' => '',
            'MerchantTradeDate' => '',
            'PaymentType' => 'aio',
            'TotalAmount' => '',
            'TradeDesc' => '',
            'ChoosePayment' => ECPay_PaymentMethod::ALL,
            'Remark' => '',
            'ChooseSubPayment' => ECPay_PaymentMethodItem::None,
            'NeedExtraPaidInfo' => ECPay_ExtraPaymentInfo::No,
            'DeviceSource' => '',
            'IgnorePayment' => '',
            'PlatformID' => '',
            'InvoiceMark' => ECPay_InvoiceState::No,
            'Items' => [],
            'EncryptType' => ECPay_EncryptType::ENC_MD5,
        ];

        $this->SendExtend = [];

        $this->Query = [
            'MerchantTradeNo' => '', 'TimeStamp' => '',
        ];
        $this->Action = [
            'MerchantTradeNo' => '', 'TradeNo' => '', 'Action' => ECPay_ActionType::C, 'TotalAmount' => 0,
        ];
        $this->Capture = [];
    }

    //產生訂單
    public function CheckOut($target = '_self')
    {
        $arParameters = array_merge(['MerchantID' => $this->MerchantID], $this->Send);
        ECPay_Send::CheckOut($target, $arParameters, $this->SendExtend, $this->HashKey, $this->HashIV, $this->ServiceURL);
    }

    //產生訂單html code
    public function CheckOutString($paymentButton = null, $target = '_self')
    {
        $arParameters = array_merge(['MerchantID' => $this->MerchantID], $this->Send);

        return ECPay_Send::CheckOutString($paymentButton, $target = '_self', $arParameters, $this->SendExtend, $this->HashKey, $this->HashIV, $this->ServiceURL);
    }

    //取得付款結果通知的方法
    public function CheckOutFeedback()
    {
        return $arFeedback = ECPay_CheckOutFeedback::CheckOut($_POST, $this->HashKey, $this->HashIV, 0);
    }

    //訂單查詢作業
    public function QueryTradeInfo()
    {
        return $arFeedback = ECPay_QueryTradeInfo::CheckOut(array_merge($this->Query, ['MerchantID' => $this->MerchantID]), $this->HashKey, $this->HashIV, $this->ServiceURL);
    }

    //信用卡定期定額訂單查詢的方法
    public function QueryPeriodCreditCardTradeInfo()
    {
        return $arFeedback = ECPay_QueryPeriodCreditCardTradeInfo::CheckOut(array_merge($this->Query, ['MerchantID' => $this->MerchantID]), $this->HashKey, $this->HashIV, $this->ServiceURL);
    }

    //信用卡關帳/退刷/取消/放棄的方法
    public function DoAction()
    {
        return $arFeedback = ECPay_DoAction::CheckOut(array_merge($this->Action, ['MerchantID' => $this->MerchantID]), $this->HashKey, $this->HashIV, $this->ServiceURL);
    }

    //合作特店申請撥款
    public function AioCapture()
    {
        return $arFeedback = ECPay_AioCapture::Capture(array_merge($this->Capture, ['MerchantID' => $this->MerchantID]), $this->HashKey, $this->HashIV, $this->ServiceURL);
    }
}

/**
 * 抽象類.
 */
abstract class ECPay_Aio
{
    protected static function ServerPost($parameters, $ServiceURL)
    {
        $ch = curl_init();

        if (false === $ch) {
            throw new Exception('curl failed to initialize');
        }

        curl_setopt($ch, CURLOPT_URL, $ServiceURL);
        curl_setopt($ch, CURLOPT_HEADER, false);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($parameters));
        $rs = curl_exec($ch);

        if (false === $rs) {
            throw new Exception(curl_error($ch), curl_errno($ch));
        }

        curl_close($ch);

        return $rs;
    }
}

/**
 *  產生訂單.
 */
class ECPay_Send extends ECPay_Aio
{
    //付款方式物件
    public static $PaymentObj;

    public static function CheckOut($target = '_self', $arParameters = [], $arExtend = [], $HashKey = '', $HashIV = '', $ServiceURL = '')
    {
        $arParameters = self::process($arParameters, $arExtend);
        //產生檢查碼
        $szCheckMacValue = ECPay_CheckMacValue::generate($arParameters, $HashKey, $HashIV, $arParameters['EncryptType']);

        //生成表單，自動送出
        $szHtml = '<!DOCTYPE html>';
        $szHtml .= '<html>';
        $szHtml .= '<head>';
        $szHtml .= '<meta charset="utf-8">';
        $szHtml .= '</head>';
        $szHtml .= '<body>';
        $szHtml .= "<form id=\"__ecpayForm\" method=\"post\" target=\"{$target}\" action=\"{$ServiceURL}\">";

        foreach ($arParameters as $keys => $value) {
            $szHtml .= "<input type=\"hidden\" name=\"{$keys}\" value='{$value}' />";
        }

        $szHtml .= "<input type=\"hidden\" name=\"CheckMacValue\" value=\"{$szCheckMacValue}\" />";
        $szHtml .= '</form>';
        $szHtml .= '<script type="text/javascript">document.getElementById("__ecpayForm").submit();</script>';
        $szHtml .= '</body>';
        $szHtml .= '</html>';

        echo $szHtml;
        exit;
    }

    public static function CheckOutString($paymentButton, $target = '_self', $arParameters = [], $arExtend = [], $HashKey = '', $HashIV = '', $ServiceURL = '')
    {
        $arParameters = self::process($arParameters, $arExtend);
        //產生檢查碼
        $szCheckMacValue = ECPay_CheckMacValue::generate($arParameters, $HashKey, $HashIV, $arParameters['EncryptType']);

        $szHtml = '<!DOCTYPE html>';
        $szHtml .= '<html>';
        $szHtml .= '<head>';
        $szHtml .= '<meta charset="utf-8">';
        $szHtml .= '</head>';
        $szHtml .= '<body>';
        $szHtml .= "<form id=\"__ecpayForm\" method=\"post\" target=\"{$target}\" action=\"{$ServiceURL}\">";

        foreach ($arParameters as $keys => $value) {
            $szHtml .= "<input type=\"hidden\" name=\"{$keys}\" value='{$value}' />";
        }

        $szHtml .= "<input type=\"hidden\" name=\"CheckMacValue\" value=\"{$szCheckMacValue}\" />";
        $szHtml .= "<input type=\"submit\" id=\"__paymentButton\" value=\"{$paymentButton}\" />";
        $szHtml .= '</form>';
        $szHtml .= '</body>';
        $szHtml .= '</html>';

        return  $szHtml;
    }

    protected static function process($arParameters = [], $arExtend = [])
    {
        //宣告付款方式物件
        $PaymentMethod = 'ECPay_'.$arParameters['ChoosePayment'];
        self::$PaymentObj = new $PaymentMethod;

        //檢查參數
        $arParameters = self::$PaymentObj->check_string($arParameters);

        //檢查商品
        $arParameters = self::$PaymentObj->check_goods($arParameters);

        //檢查各付款方式的額外參數&電子發票參數
        $arExtend = self::$PaymentObj->check_extend_string($arExtend, $arParameters['InvoiceMark']);

        //過濾
        $arExtend = self::$PaymentObj->filter_string($arExtend, $arParameters['InvoiceMark']);

        //合併共同參數及延伸參數
        return array_merge($arParameters, $arExtend);
    }
}

class ECPay_CheckOutFeedback extends ECPay_Aio
{
    public static function CheckOut($arParameters = [], $HashKey = '', $HashIV = '')
    {
        // 變數宣告。
        $arErrors = [];
        $arFeedback = [];
        $szCheckMacValue = '';
        // 重新整理回傳參數。
        foreach ($arParameters as $keys => $value) {
            if ($keys != 'CheckMacValue') {
                if ($keys == 'PaymentType') {
                    $value = str_replace('_CVS', '', $value);
                    $value = str_replace('_BARCODE', '', $value);
                    $value = str_replace('_CreditCard', '', $value);
                }
                if ($keys == 'PeriodType') {
                    $value = str_replace('Y', 'Year', $value);
                    $value = str_replace('M', 'Month', $value);
                    $value = str_replace('D', 'Day', $value);
                }
                $arFeedback[$keys] = $value;
            }
        }

        $CheckMacValue = ECPay_CheckMacValue::generate($arParameters, $HashKey, $HashIV, 0);

        if ($CheckMacValue != $arParameters['CheckMacValue']) {
            array_push($arErrors, 'CheckMacValue verify fail.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('- ', $arErrors));
        }

        return $arFeedback;
    }
}

class ECPay_QueryTradeInfo extends ECPay_Aio
{
    public static function CheckOut($arParameters = [], $HashKey = '', $HashIV = '', $ServiceURL = '')
    {
        $arErrors = [];
        $arParameters['TimeStamp'] = time();
        $arFeedback = [];
        $arConfirmArgs = [];
        // 呼叫查詢。
        if (count($arErrors) == 0) {
            $arParameters['CheckMacValue'] = ECPay_CheckMacValue::generate($arParameters, $HashKey, $HashIV, 0);
            // 送出查詢並取回結果。
            $szResult = parent::ServerPost($arParameters, $ServiceURL);
            $szResult = str_replace(' ', '%20', $szResult);
            $szResult = str_replace('+', '%2B', $szResult);

            // 轉結果為陣列。
            parse_str($szResult, $arParameters);
            // 重新整理回傳參數。
            foreach ($arParameters as $keys => $value) {
                if ($keys == 'CheckMacValue') {
                    $szCheckMacValue = $value;
                } else {
                    $arFeedback[$keys] = $value;
                    $arConfirmArgs[$keys] = $value;
                }
            }

            // 驗證檢查碼。
            if (count($arFeedback) > 0) {
                $szConfirmMacValue = ECPay_CheckMacValue::generate($arConfirmArgs, $HashKey, $HashIV, 0);
                if ($szCheckMacValue != $szConfirmMacValue) {
                    array_push($arErrors, 'CheckMacValue verify fail.');
                }
            }
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('- ', $arErrors));
        }

        return $arFeedback;
    }
}

class ECPay_QueryPeriodCreditCardTradeInfo extends ECPay_Aio
{
    public static function CheckOut($arParameters = [], $HashKey = '', $HashIV = '', $ServiceURL = '')
    {
        $arErrors = [];
        $arParameters['TimeStamp'] = time();
        $arFeedback = [];
        $arConfirmArgs = [];
        // 呼叫查詢。
        if (count($arErrors) == 0) {
            $arParameters['CheckMacValue'] = ECPay_CheckMacValue::generate($arParameters, $HashKey, $HashIV, 0);
            // 送出查詢並取回結果。
            $szResult = parent::ServerPost($arParameters, $ServiceURL);
            $szResult = str_replace(' ', '%20', $szResult);
            $szResult = str_replace('+', '%2B', $szResult);

            // 轉結果為陣列。
            $arParameters = json_decode($szResult, true);
            // 重新整理回傳參數。
            foreach ($arParameters as $keys => $value) {
                $arFeedback[$keys] = $value;
            }
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('- ', $arErrors));
        }

        return $arFeedback;
    }
}

class ECPay_DoAction extends ECPay_Aio
{
    public static function CheckOut($arParameters = [], $HashKey = '', $HashIV = '', $ServiceURL = '')
    {
        // 變數宣告。
        $arErrors = [];
        $arFeedback = [];

        //產生驗證碼
        $szCheckMacValue = ECPay_CheckMacValue::generate($arParameters, $HashKey, $HashIV, 0);
        $arParameters['CheckMacValue'] = $szCheckMacValue;
        // 送出查詢並取回結果。
        $szResult = self::ServerPost($arParameters, $ServiceURL);
        // 轉結果為陣列。
        parse_str($szResult, $arParameters);
        // 重新整理回傳參數。
        foreach ($arParameters as $keys => $value) {
            if ($keys == 'CheckMacValue') {
                $szCheckMacValue = $value;
            } else {
                $arFeedback[$keys] = $value;
            }
        }

        if (array_key_exists('RtnCode', $arFeedback) && $arFeedback['RtnCode'] != '1') {
            array_push($arErrors, vsprintf('#%s: %s', [$arFeedback['RtnCode'], $arFeedback['RtnMsg']]));
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('- ', $arErrors));
        }

        return $arFeedback;
    }
}

class ECPay_AioCapture extends ECPay_Aio
{
    public static function Capture($arParameters = [], $HashKey = '', $HashIV = '', $ServiceURL = '')
    {
        $arErrors = [];
        $arFeedback = [];

        $szCheckMacValue = ECPay_CheckMacValue::generate($arParameters, $HashKey, $HashIV, 0);
        $arParameters['CheckMacValue'] = $szCheckMacValue;

        // 送出查詢並取回結果。
        $szResult = self::ServerPost($arParameters, $ServiceURL);

        // 轉結果為陣列。
        parse_str($szResult, $arParameters);

        // 重新整理回傳參數。
        foreach ($arParameters as $keys => $value) {
            $arFeedback[$keys] = $value;
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('- ', $arErrors));
        }

        return $arFeedback;
    }
}

abstract class ECPay_Verification
{
    // 電子發票延伸參數。
    public $arInvoice = [
            'RelateNumber',
            'CustomerIdentifier',
            'CarrierType',
            'CustomerID',
            'Donation',
            'Print',
            'TaxType',
            'CustomerName',
            'CustomerAddr',
            'CustomerPhone',
            'CustomerEmail',
            'ClearanceMark',
            'CarrierNum',
            'LoveCode',
            'InvoiceRemark',
            'DelayDay',
            'InvoiceItemName',
            'InvoiceItemCount',
            'InvoiceItemWord',
            'InvoiceItemPrice',
            'InvoiceItemTaxType',
            'InvType',
        ];

    abstract public function check_goods($arParameters = []);

    abstract public function filter_string($arExtend = [], $InvoiceMark = '');

    abstract public function check_extend_string($arExtend = [], $InvoiceMark = '');

    //檢查共同參數
    public function check_string($arParameters = [])
    {
        $arErrors = [];
        if (strlen($arParameters['MerchantID']) == 0) {
            array_push($arErrors, 'MerchantID is required.');
        }
        if (strlen($arParameters['MerchantID']) > 10) {
            array_push($arErrors, 'MerchantID max langth as 10.');
        }

        if (strlen($arParameters['ReturnURL']) == 0) {
            array_push($arErrors, 'ReturnURL is required.');
        }
        if (strlen($arParameters['ClientBackURL']) > 200) {
            array_push($arErrors, 'ClientBackURL max langth as 200.');
        }
        if (strlen($arParameters['OrderResultURL']) > 200) {
            array_push($arErrors, 'OrderResultURL max langth as 200.');
        }

        if (strlen($arParameters['MerchantTradeNo']) == 0) {
            array_push($arErrors, 'MerchantTradeNo is required.');
        }
        if (strlen($arParameters['MerchantTradeNo']) > 20) {
            array_push($arErrors, 'MerchantTradeNo max langth as 20.');
        }
        if (strlen($arParameters['MerchantTradeDate']) == 0) {
            array_push($arErrors, 'MerchantTradeDate is required.');
        }
        if (strlen($arParameters['TotalAmount']) == 0) {
            array_push($arErrors, 'TotalAmount is required.');
        }
        if (strlen($arParameters['TradeDesc']) == 0) {
            array_push($arErrors, 'TradeDesc is required.');
        }
        if (strlen($arParameters['TradeDesc']) > 200) {
            array_push($arErrors, 'TradeDesc max langth as 200.');
        }
        if (strlen($arParameters['ChoosePayment']) == 0) {
            array_push($arErrors, 'ChoosePayment is required.');
        }
        if (strlen($arParameters['NeedExtraPaidInfo']) == 0) {
            array_push($arErrors, 'NeedExtraPaidInfo is required.');
        }
        if (count($arParameters['Items']) == 0) {
            array_push($arErrors, 'Items is required.');
        }

        // 檢查CheckMacValue加密方式
        if (strlen($arParameters['EncryptType']) > 1) {
            array_push($arErrors, 'EncryptType max langth as 1.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }
    }

    //檢查電子發票參數
    public function check_invoiceString($arExtend = [])
    {
        $arErrors = [];

        // 廠商自訂編號RelateNumber(不可為空)
        if (! array_key_exists('RelateNumber', $arExtend)) {

This code seems to be duplicated across your project.

            array_push($arErrors, 'RelateNumber is required.');
        } else {
            if (strlen($arExtend['RelateNumber']) > 30) {
                array_push($arErrors, 'RelateNumber max length as 30.');
            }
        }

        // 統一編號CustomerIdentifier(預設為空字串)
        if (! array_key_exists('CustomerIdentifier', $arExtend)) {

This code seems to be duplicated across your project.

            $arExtend['CustomerIdentifier'] = '';
        } else {
            //統編長度只能為8
            if (strlen($arExtend['CustomerIdentifier']) != 8) {
                array_push($arErrors, 'CustomerIdentifier length should be 8.');
            }
        }

        // 載具類別CarrierType(預設為None)
        if (! array_key_exists('CarrierType', $arExtend)) {
            $arExtend['CarrierType'] = ECPay_CarrierType::None;
        } else {

This code seems to be duplicated across your project.

            //有設定統一編號的話，載具參數必須是空字串
            if (strlen($arExtend['CustomerIdentifier']) > 0 && $arExtend['CarrierType'] != ECPay_CarrierType::None) {
                array_push($arErrors, 'CarrierType should be None.');
            }
        }

        // 客戶代號CustomerID(預設為空字串)
        if (! array_key_exists('CustomerID', $arExtend)) {
            $arExtend['CustomerID'] = '';
        } else {

This code seems to be duplicated across your project.

            if ($arExtend['CarrierType'] == ECPay_CarrierType::Member && strlen($arExtend['CustomerID'] == 0)) {
                array_push($arErrors, 'CustomerID is required.');
            }
        }
        // 捐贈註記 Donation(預設為No)
        if (! array_key_exists('Donation', $arExtend)) {

This code seems to be duplicated across your project.

            $arExtend['Donation'] = ECPay_Donation::No;
        } else {
            //若有帶統一編號，不可捐贈
            if (strlen($arExtend['CustomerIdentifier']) > 0 && $arExtend['Donation'] != ECPay_Donation::No) {
                array_push($arErrors, 'Donation should be No.');
            }
        }

        // 列印註記Print(預設為No)
        if (! array_key_exists('Print', $arExtend)) {
            $arExtend['Print'] = ECPay_PrintMark::No;
        } else {
            //捐贈註記為捐贈(Yes)時，請設定不列印(No)
            if ($arExtend['Donation'] == ECPay_Donation::Yes && $arExtend['Print'] != ECPay_PrintMark::No) {
                array_push($arErrors, 'Print should be No.');
            }
            // 統一編號不為空字串時，請設定列印(Yes)
            if (strlen($arExtend['CustomerIdentifier']) > 0 && $arExtend['Print'] != ECPay_PrintMark::Yes) {
                array_push($arErrors, 'Print should be Yes.');
            }
            // 載具類別為會員載具(Member)、買受人自然人憑證(Citizen)、買受人手機條碼(Cellphone)時，請設定不列印(No)
            $notPrint = [ECPay_CarrierType::Member, ECPay_CarrierType::Citizen, ECPay_CarrierType::Cellphone];
            if (in_array($arExtend['CarrierType'], $notPrint) and $arExtend['Print'] == ECPay_PrintMark::Yes) {
                array_push($arErrors, 'Print should be No.');
            }
        }
        // 客戶名稱CustomerName(UrlEncode, 預設為空字串)
        if (! array_key_exists('CustomerName', $arExtend)) {

This code seems to be duplicated across your project.

            $arExtend['CustomerName'] = '';
        } else {
            if (mb_strlen($arExtend['CustomerName'], 'UTF-8') > 20) {
                array_push($arErrors, 'CustomerName max length as 20.');
            }
            // 列印註記為列印(Yes)時，此參數不可為空字串
            if ($arExtend['Print'] == ECPay_PrintMark::Yes && strlen($arExtend['CustomerName']) == 0) {
                array_push($arErrors, 'CustomerName is required.');
            }
        }

        // 客戶地址CustomerAddr(UrlEncode, 預設為空字串)
        if (! array_key_exists('CustomerAddr', $arExtend)) {

This code seems to be duplicated across your project.

            $arExtend['CustomerAddr'] = '';
        } else {
            if (mb_strlen($arExtend['CustomerAddr'], 'UTF-8') > 200) {
                array_push($arErrors, 'CustomerAddr max length as 200.');
            }
            // 列印註記為列印(Yes)時，此參數不可為空字串
            if ($arExtend['Print'] == ECPay_PrintMark::Yes && strlen($arExtend['CustomerAddr']) == 0) {
                array_push($arErrors, 'CustomerAddr is required.');
            }
        }
        // 客戶電話CustomerPhone
        if (! array_key_exists('CustomerPhone', $arExtend)) {

This code seems to be duplicated across your project.

            $arExtend['CustomerPhone'] = '';
        } else {
            if (strlen($arExtend['CustomerPhone']) > 20) {
                array_push($arErrors, 'CustomerPhone max length as 20.');
            }
        }

        // 客戶信箱CustomerEmail
        if (! array_key_exists('CustomerEmail', $arExtend)) {

This code seems to be duplicated across your project.

            $arExtend['CustomerEmail'] = '';
        } else {
            if (strlen($arExtend['CustomerEmail']) > 200) {
                array_push($arErrors, 'CustomerEmail max length as 200.');
            }
        }

        //(CustomerEmail與CustomerPhone擇一不可為空)
        if (strlen($arExtend['CustomerPhone']) == 0 and strlen($arExtend['CustomerEmail']) == 0) {
            array_push($arErrors, 'CustomerPhone or CustomerEmail is required.');
        }

        //課稅類別 TaxType(不可為空)
        if (strlen($arExtend['TaxType']) == 0) {
            array_push($arErrors, 'TaxType is required.');
        }

        //通關方式 ClearanceMark(預設為空字串)
        if (! array_key_exists('ClearanceMark', $arExtend)) {
            $arExtend['ClearanceMark'] = '';
        } else {
            //課稅類別為零稅率(Zero)時，ClearanceMark不可為空字串
            if ($arExtend['TaxType'] == ECPay_TaxType::Zero && ($arExtend['ClearanceMark'] != ECPay_ClearanceMark::Yes || $arExtend['ClearanceMark'] != ECPay_ClearanceMark::No)) {
                array_push($arErrors, 'ClearanceMark is required.');
            }
            if (strlen($arExtend['ClearanceMark']) > 0 && $arExtend['TaxType'] != ECPay_TaxType::Zero) {
                array_push($arErrors, 'Please remove ClearanceMark.');
            }
        }

        // CarrierNum(預設為空字串)
        if (! array_key_exists('CarrierNum', $arExtend)) {
            $arExtend['CarrierNum'] = '';
        } else {
            switch ($arExtend['CarrierType']) {
                // 載具類別為無載具(None)或會員載具(Member)時，請設定空字串
                case ECPay_CarrierType::None:
                case ECPay_CarrierType::Member:
                    if (strlen($arExtend['CarrierNum']) > 0) {
                        array_push($arErrors, 'Please remove CarrierNum.');
                    }
                break;
                // 載具類別為買受人自然人憑證(Citizen)時，請設定自然人憑證號碼，前2碼為大小寫英文，後14碼為數字
                case ECPay_CarrierType::Citizen:
                    if (! preg_match('/^[a-zA-Z]{2}\d{14}$/', $arExtend['CarrierNum'])) {
                        array_push($arErrors, 'Invalid CarrierNum.');
                    }
                break;
                // 載具類別為買受人手機條碼(Cellphone)時，請設定手機條碼，第1碼為「/」，後7碼為大小寫英文、數字、「+」、「-」或「.」
                case ECPay_CarrierType::Cellphone:
                    if (! preg_match('/^\/{1}[0-9a-zA-Z+-.]{7}$/', $arExtend['CarrierNum'])) {
                        array_push($arErrors, 'Invalid CarrierNum.');
                    }
                break;

                default:
                    array_push($arErrors, 'Please remove CarrierNum.');
            }
        }

        // 愛心碼 LoveCode(預設為空字串)
        if (! array_key_exists('LoveCode', $arExtend)) {
            $arExtend['LoveCode'] = '';
        }
        // 捐贈註記為捐贈(Yes)時，參數長度固定3~7碼，請設定全數字或第1碼大小寫「X」，後2~6碼全數字
        if ($arExtend['Donation'] == ECPay_Donation::Yes) {
            if (! preg_match('/^([xX]{1}[0-9]{2,6}|[0-9]{3,7})$/', $arExtend['LoveCode'])) {
                array_push($arErrors, 'Invalid LoveCode.');
            }
        } else {
            if (strlen($arExtend['LoveCode']) > 0) {
                array_push($arErrors, 'Please remove LoveCode.');
            }
        }

        //備註 InvoiceRemark(UrlEncode, 預設為空字串)
        if (! array_key_exists('InvoiceRemark', $arExtend)) {
            $arExtend['InvoiceRemark'] = '';
        }

        // 延遲天數 DelayDay(不可為空, 預設為0) 延遲天數，範圍0~15，設定為0時，付款完成後立即開立發票
        if (! array_key_exists('DelayDay', $arExtend)) {
            $arExtend['DelayDay'] = 0;
        }
        if ($arExtend['DelayDay'] < 0 or $arExtend['DelayDay'] > 15) {
            array_push($arErrors, 'DelayDay should be 0 ~ 15.');
        }

        // 字軌類別 InvType(不可為空)
        if (! array_key_exists('InvType', $arExtend)) {
            array_push($arErrors, 'InvType is required.');
        }

        //商品相關整理
        if (! array_key_exists('InvoiceItems', $arExtend)) {
            array_push($arErrors, 'Invoice Goods information not found.');
        } else {
            $InvSptr = '|';
            $tmpItemName = [];
            $tmpItemCount = [];
            $tmpItemWord = [];
            $tmpItemPrice = [];
            $tmpItemTaxType = [];
            foreach ($arExtend['InvoiceItems'] as $tmpItemInfo) {
                if (mb_strlen($tmpItemInfo['Name'], 'UTF-8') > 0) {
                    array_push($tmpItemName, $tmpItemInfo['Name']);
                }
                if (strlen($tmpItemInfo['Count']) > 0) {
                    array_push($tmpItemCount, $tmpItemInfo['Count']);
                }
                if (mb_strlen($tmpItemInfo['Word'], 'UTF-8') > 0) {
                    array_push($tmpItemWord, $tmpItemInfo['Word']);
                }
                if (strlen($tmpItemInfo['Price']) > 0) {
                    array_push($tmpItemPrice, $tmpItemInfo['Price']);
                }
                if (strlen($tmpItemInfo['TaxType']) > 0) {
                    array_push($tmpItemTaxType, $tmpItemInfo['TaxType']);
                }
            }

            if ($arExtend['TaxType'] == ECPay_TaxType::Mix) {
                if (in_array(ECPay_TaxType::Dutiable, $tmpItemTaxType) and in_array(ECPay_TaxType::Free, $tmpItemTaxType)) {
                    // Do nothing
                } else {
                    $tmpItemTaxType = [];
                }
            }
            if ((count($tmpItemName) + count($tmpItemCount) + count($tmpItemWord) + count($tmpItemPrice) + count($tmpItemTaxType)) == (count($tmpItemName) * 5)) {
                $arExtend['InvoiceItemName'] = implode($InvSptr, $tmpItemName);
                $arExtend['InvoiceItemCount'] = implode($InvSptr, $tmpItemCount);
                $arExtend['InvoiceItemWord'] = implode($InvSptr, $tmpItemWord);
                $arExtend['InvoiceItemPrice'] = implode($InvSptr, $tmpItemPrice);
                $arExtend['InvoiceItemTaxType'] = implode($InvSptr, $tmpItemTaxType);
            }

            unset($arExtend['InvoiceItems']);
        }

        $encode_fields = [
                'CustomerName',
                'CustomerAddr',
                'CustomerEmail',
                'InvoiceItemName',
                'InvoiceItemWord',
                'InvoiceRemark',
            ];
        foreach ($encode_fields as $tmp_field) {
            $arExtend[$tmp_field] = urlencode($arExtend[$tmp_field]);
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }

        return $arExtend;
    }
}

/**
 *  付款方式：超商代碼
 */
class ECPay_CVS extends ECPay_Verification
{
    public $arPayMentExtend = [
                            'Desc_1' => '',
                            'Desc_2' => '',
                            'Desc_3' => '',
                            'Desc_4' => '',
                            'PaymentInfoURL' => '',
                            'ClientRedirectURL' => '',
                            'StoreExpireDate' => '',
                        ];

    //檢查共同參數
    public function check_string($arParameters = [])
    {
        parent::check_string($arParameters);
        if (! $arParameters['PlatformID']) {
            unset($arParameters['PlatformID']);
        }
        unset($arParameters['IgnorePayment']);

        return $arParameters;
    }

    //檢查CVS的延伸參數
    public function check_extend_string($arExtend = [], $InvoiceMark = '')
    {

        //沒設定參數的話，就給預設參數
        foreach ($this->arPayMentExtend as $key => $value) {
            if (! isset($arExtend[$key])) {
                $arExtend[$key] = $value;
            }
        }

        //若有開發票，檢查一下發票參數
        if ($InvoiceMark == 'Y') {
            $arExtend = $this->check_invoiceString($arExtend);
        }

        return $arExtend;
    }

    //過濾多餘參數
    public function filter_string($arExtend = [], $InvoiceMark = '')
    {
        $arPayMentExtend = ($InvoiceMark == '') ? array_keys($this->arPayMentExtend) : array_merge(array_keys($this->arPayMentExtend), $this->arInvoice);
        foreach ($arExtend as $key => $value) {
            if (! in_array($key, $arPayMentExtend)) {
                unset($arExtend[$key]);
            }
        }

        return $arExtend;
    }

    //檢查商品
    public function check_goods($arParameters = [])
    {
        // 檢查產品名稱。
        $szItemName = '';
        $arErrors = [];
        if (count($arParameters['Items']) > 0) {
            foreach ($arParameters['Items'] as $keys => $value) {
                $szItemName .= vsprintf('#%s %d %s x %u', $arParameters['Items'][$keys]);
                if (! array_key_exists('ItemURL', $arParameters)) {
                    $arParameters['ItemURL'] = $arParameters['Items'][$keys]['URL'];
                }
            }

            if (strlen($szItemName) > 0) {
                $szItemName = mb_substr($szItemName, 1, 200);
                $arParameters['ItemName'] = $szItemName;
            }
        } else {
            array_push($arErrors, 'Goods information not found.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }

        unset($arParameters['Items']);

        return $arParameters;
    }
}

/**
 * 付款方式 : BARCODE.
 */
class ECPay_BARCODE extends ECPay_Verification
{
    public $arPayMentExtend = [
                            'Desc_1' => '',
                            'Desc_2' => '',
                            'Desc_3' => '',
                            'Desc_4' => '',
                            'PaymentInfoURL' => '',
                            'ClientRedirectURL' => '',
                            'StoreExpireDate' => '',
                        ];

    //檢查共同參數
    public function check_string($arParameters = [])
    {
        parent::check_string($arParameters);
        if (! $arParameters['PlatformID']) {
            unset($arParameters['PlatformID']);
        }
        unset($arParameters['IgnorePayment']);

        return $arParameters;
    }

    //檢查BARCODE的延伸參數
    public function check_extend_string($arExtend = [], $InvoiceMark = '')
    {

        //沒設定參數的話，就給預設參數
        foreach ($this->arPayMentExtend as $key => $value) {
            if (! isset($arExtend[$key])) {
                $arExtend[$key] = $value;
            }
        }

        //若有開發票，檢查一下發票參數
        if ($InvoiceMark == 'Y') {
            $arExtend = $this->check_invoiceString($arExtend);
        }

        return $arExtend;
    }

    //過濾多餘參數
    public function filter_string($arExtend = [], $InvoiceMark = '')
    {
        $arPayMentExtend = ($InvoiceMark == '') ? array_keys($this->arPayMentExtend) : array_merge(array_keys($this->arPayMentExtend), $this->arInvoice);
        foreach ($arExtend as $key => $value) {
            if (! in_array($key, $arPayMentExtend)) {
                unset($arExtend[$key]);
            }
        }

        return $arExtend;
    }

    //檢查商品
    public function check_goods($arParameters = [])
    {
        // 檢查產品名稱。
        $szItemName = '';
        $arErrors = [];
        if (count($arParameters['Items']) > 0) {
            foreach ($arParameters['Items'] as $keys => $value) {
                $szItemName .= vsprintf('#%s %d %s x %u', $arParameters['Items'][$keys]);
                if (! array_key_exists('ItemURL', $arParameters)) {
                    $arParameters['ItemURL'] = $arParameters['Items'][$keys]['URL'];
                }
            }

            if (strlen($szItemName) > 0) {
                $szItemName = mb_substr($szItemName, 1, 200);
                $arParameters['ItemName'] = $szItemName;
            }
        } else {
            array_push($arErrors, 'Goods information not found.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }

        unset($arParameters['Items']);

        return $arParameters;
    }
}

/**
 *  付款方式 ATM.
 */
class ECPay_ATM extends ECPay_Verification
{
    public $arPayMentExtend = [
                            'ExpireDate' => 3,
                            'PaymentInfoURL' => '',
                            'ClientRedirectURL' => '',
                        ];

    //檢查共同參數
    public function check_string($arParameters = [])
    {
        parent::check_string($arParameters);
        if (! $arParameters['PlatformID']) {
            unset($arParameters['PlatformID']);
        }
        unset($arParameters['IgnorePayment']);

        return $arParameters;
    }

    //檢查ATM的延伸參數
    public function check_extend_string($arExtend = [], $InvoiceMark = '')
    {
        //沒設定參數的話，就給預設參數
        foreach ($this->arPayMentExtend as $key => $value) {
            if (! isset($arExtend[$key])) {
                $arExtend[$key] = $value;
            }
        }

        //若有開發票，檢查一下發票參數
        if ($InvoiceMark == 'Y') {
            $arExtend = $this->check_invoiceString($arExtend);
        }

        return $arExtend;
    }

    //過濾多餘參數
    public function filter_string($arExtend = [], $InvoiceMark = '')
    {
        $arPayMentExtend = ($InvoiceMark == '') ? array_keys($this->arPayMentExtend) : array_merge(array_keys($this->arPayMentExtend), $this->arInvoice);
        foreach ($arExtend as $key => $value) {
            if (! in_array($key, $arPayMentExtend)) {
                unset($arExtend[$key]);
            }
        }

        return $arExtend;
    }

    //檢查商品
    public function check_goods($arParameters = [])
    {
        // 檢查產品名稱。
        $szItemName = '';
        $arErrors = [];
        if (count($arParameters['Items']) > 0) {
            foreach ($arParameters['Items'] as $keys => $value) {
                $szItemName .= vsprintf('#%s %d %s x %u', $arParameters['Items'][$keys]);
                if (! array_key_exists('ItemURL', $arParameters)) {
                    $arParameters['ItemURL'] = $arParameters['Items'][$keys]['URL'];
                }
            }

            if (strlen($szItemName) > 0) {
                $szItemName = mb_substr($szItemName, 1, 200);
                $arParameters['ItemName'] = $szItemName;
            }
        } else {
            array_push($arErrors, 'Goods information not found.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }

        unset($arParameters['Items']);

        return $arParameters;
    }
}

/**
 *  付款方式 WebATM.
 */
class ECPay_WebATM extends ECPay_Verification
{
    public $arPayMentExtend = [];

    //檢查共同參數
    public function check_string($arParameters = [])
    {
        parent::check_string($arParameters);
        if (! $arParameters['PlatformID']) {
            unset($arParameters['PlatformID']);
        }
        unset($arParameters['IgnorePayment']);

        return $arParameters;
    }

    //檢查WebATM的延伸參數
    public function check_extend_string($arExtend = [], $InvoiceMark = '')
    {
        //沒設定參數的話，就給預設參數
        foreach ($this->arPayMentExtend as $key => $value) {
            if (! isset($arExtend[$key])) {
                $arExtend[$key] = $value;
            }
        }

        //若有開發票，檢查一下發票參數
        if ($InvoiceMark == 'Y') {
            $arExtend = $this->check_invoiceString($arExtend);
        }

        return $arExtend;
    }

    //過濾多餘參數
    public function filter_string($arExtend = [], $InvoiceMark = '')
    {
        $arPayMentExtend = ($InvoiceMark == '') ? array_keys($this->arPayMentExtend) : array_merge(array_keys($this->arPayMentExtend), $this->arInvoice);
        foreach ($arExtend as $key => $value) {
            if (! in_array($key, $arPayMentExtend)) {
                unset($arExtend[$key]);
            }
        }

        return $arExtend;
    }

    //檢查商品
    public function check_goods($arParameters = [])
    {
        // 檢查產品名稱。
        $arErrors = [];
        $szItemName = '';
        if (count($arParameters['Items']) > 0) {
            foreach ($arParameters['Items'] as $keys => $value) {
                $szItemName .= vsprintf('#%s %d %s x %u', $arParameters['Items'][$keys]);
                if (! array_key_exists('ItemURL', $arParameters)) {
                    $arParameters['ItemURL'] = $arParameters['Items'][$keys]['URL'];
                }
            }

            if (strlen($szItemName) > 0) {
                $szItemName = mb_substr($szItemName, 1, 200);
                $arParameters['ItemName'] = $szItemName;
            }
        } else {
            array_push($arErrors, 'Goods information not found.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }

        unset($arParameters['Items']);

        return $arParameters;
    }
}

/**
 * 付款方式 : 信用卡
 */
class ECPay_Credit extends ECPay_Verification
{
    public $arPayMentExtend = [
                                    'CreditInstallment' => 0,
                                    'InstallmentAmount' => 0,
                                    'Redeem' => false,
                                    'UnionPay' => false,
                                    'Language' => '',
                                    'PeriodAmount' => '',
                                    'PeriodType' => '',
                                    'Frequency' => '',
                                    'ExecTimes' => '',
                                    'PeriodReturnURL' => '',
                                ];

    //檢查共同參數
    public function check_string($arParameters = [])
    {
        parent::check_string($arParameters);
        if (! $arParameters['PlatformID']) {
            unset($arParameters['PlatformID']);
        }
        unset($arParameters['IgnorePayment']);

        return $arParameters;
    }

    public function check_extend_string($arExtend = [], $InvoiceMark = '')
    {
        foreach ($this->arPayMentExtend as $key => $value) {
            if (! isset($arExtend[$key])) {
                $arExtend[$key] = $value;
            }
        }

        //若有開發票，檢查一下發票參數
        if ($InvoiceMark == 'Y') {
            $arExtend = $this->check_invoiceString($arExtend);
        }

        return $arExtend;
    }

    public function filter_string($arExtend = [], $InvoiceMark = '')
    {
        $arPayMentExtend = ($InvoiceMark == '') ? array_keys($this->arPayMentExtend) : array_merge(array_keys($this->arPayMentExtend), $this->arInvoice);
        foreach ($arExtend as $key => $value) {
            if (! in_array($key, $arPayMentExtend)) {
                unset($arExtend[$key]);
            }
        }

        return $arExtend;
    }

    //檢查商品
    public function check_goods($arParameters = [])
    {
        // 檢查產品名稱。
        $arErrors = [];
        $szItemName = '';
        if (count($arParameters['Items']) > 0) {
            foreach ($arParameters['Items'] as $keys => $value) {
                $szItemName .= vsprintf('#%s %d %s x %u', $arParameters['Items'][$keys]);
                if (! array_key_exists('ItemURL', $arParameters)) {
                    $arParameters['ItemURL'] = $arParameters['Items'][$keys]['URL'];
                }
            }

            if (strlen($szItemName) > 0) {
                $szItemName = mb_substr($szItemName, 1, 200);
                $arParameters['ItemName'] = $szItemName;
            }
        } else {
            array_push($arErrors, 'Goods information not found.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }

        unset($arParameters['Items']);

        return $arParameters;
    }
}

/**
 *  付款方式：全功能.
 */
class ECPay_ALL extends ECPay_Verification
{
    public $arPayMentExtend = [];

    //檢查共同參數
    public function check_string($arParameters = [])
    {
        parent::check_string($arParameters);
        if (! $arParameters['PlatformID']) {
            unset($arParameters['PlatformID']);
        }

        return $arParameters;
    }

    //檢查ALL的延伸參數
    public function check_extend_string($arExtend = [], $InvoiceMark = '')
    {
        //若有開發票，檢查一下發票參數
        if ($InvoiceMark == 'Y') {
            $arExtend = $this->check_invoiceString($arExtend);
        }

        return $arExtend;
    }

    public function filter_string($arExtend = [], $InvoiceMark = '')
    {
        return $arExtend;
    }

    //檢查商品
    public function check_goods($arParameters = [])
    {
        // 檢查產品名稱。
        $arErrors = [];

        $szItemName = '';
        if (count($arParameters['Items']) > 0) {
            foreach ($arParameters['Items'] as $keys => $value) {
                $szItemName .= vsprintf('#%s %d %s x %u', $arParameters['Items'][$keys]);

                if (! array_key_exists('ItemURL', $arParameters)) {
                    $arParameters['ItemURL'] = $arParameters['Items'][$keys]['URL'];
                }
            }

            if (strlen($szItemName) > 0) {
                $szItemName = mb_substr($szItemName, 1, 200);
                $arParameters['ItemName'] = $szItemName;
            }
        } else {
            array_push($arErrors, 'Goods information not found.');
        }

        if (count($arErrors) > 0) {
            throw new Exception(implode('<br>', $arErrors));
        }
        unset($arParameters['Items']);

        return $arParameters;
    }
}

/**
 *  檢查碼
 */
class ECPay_CheckMacValue
{
    public static function generate($arParameters = [], $HashKey = '', $HashIV = '', $encType = 0)
    {
        $sMacValue = '';

        if (isset($arParameters)) {
            unset($arParameters['CheckMacValue']);
            uksort($arParameters, ['ECPay_CheckMacValue', 'merchantSort']);

            // 組合字串
            $sMacValue = 'HashKey='.$HashKey;
            foreach ($arParameters as $key => $value) {
                $sMacValue .= '&'.$key.'='.$value;
            }

            $sMacValue .= '&HashIV='.$HashIV;

            // URL Encode編碼
            $sMacValue = urlencode($sMacValue);

            // 轉成小寫
            $sMacValue = strtolower($sMacValue);

            // 取代為與 dotNet 相符的字元
            $sMacValue = str_replace('%2d', '-', $sMacValue);
            $sMacValue = str_replace('%5f', '_', $sMacValue);
            $sMacValue = str_replace('%2e', '.', $sMacValue);
            $sMacValue = str_replace('%21', '!', $sMacValue);
            $sMacValue = str_replace('%2a', '*', $sMacValue);
            $sMacValue = str_replace('%28', '(', $sMacValue);
            $sMacValue = str_replace('%29', ')', $sMacValue);

            // 編碼
            switch ($encType) {
                case ECPay_EncryptType::ENC_SHA256:
                    // SHA256 編碼
                    $sMacValue = hash('sha256', $sMacValue);
                break;

                case ECPay_EncryptType::ENC_MD5:
                default:
                // MD5 編碼
                    $sMacValue = md5($sMacValue);
            }

            $sMacValue = strtoupper($sMacValue);
        }

        return $sMacValue;
    }

    /**
     * 自訂排序使用.
     */
    private static function merchantSort($a, $b)
    {
        return strcasecmp($a, $b);
    }
}