├── TODO.md
├── .gitignore
├── Info
    ├── InfoDecorator.php
    ├── Period
    │   ├── Decorator
    │   │   ├── BackUrl.php
    │   │   ├── NotifyUrl.php
    │   │   ├── ReturnUrl.php
    │   │   ├── Webhook.php
    │   │   └── Memo.php
    │   ├── BasicInfo.php
    │   └── Info.php
    ├── Decorator
    │   ├── EnableWebAtm.php
    │   ├── EnableLinePay.php
    │   ├── EnableUnionPay.php
    │   ├── EnableGooglePay.php
    │   ├── EnableCreditBonus.php
    │   ├── EnableSamsungPay.php
    │   ├── EnableAmericanExpress.php
    │   ├── EnableAliPay.php
    │   ├── EnableEzPay.php
    │   ├── EnableVacc.php
    │   ├── EnableCvs.php
    │   ├── EnableBarcode.php
    │   ├── Enable.php
    │   ├── PayerEmailEditable.php
    │   ├── Language.php
    │   ├── PayInInstallments.php
    │   ├── PayComplete.php
    │   ├── PayCancel.php
    │   ├── EnableCredit.php
    │   ├── Comment.php
    │   ├── TradeLimit.php
    │   ├── EnableCvsCom.php
    │   ├── AliPayProduct.php
    │   └── OfflinePay.php
    ├── AliPayInfo.php
    ├── BasicInfo.php
    ├── AliPayBasicInfo.php
    └── Info.php
├── Constants
    ├── Cipher.php
    ├── LanguageType.php
    └── Period
    │   ├── VersionType.php
    │   ├── AlterType.php
    │   └── PeriodStartType.php
├── Contracts
    ├── InfoInterface.php
    ├── PayerInterface.php
    ├── AliPayPayerInterface.php
    ├── QuickCreditInterface.php
    ├── OrderInterface.php
    ├── AliPayProductInterface.php
    └── Period
    │   ├── ContactInterface.php
    │   └── OrderInterface.php
├── Exceptions
    └── TradeInfoException.php
├── composer.json
├── phpunit.xml.dist
├── Tests
    ├── MerchantTest.php
    ├── InfoTest.php
    ├── NewebPayTest.php
    └── AliPayInfoTest.php
├── LICENSE
├── Merchant.php
├── Cryption.php
├── Response.php
├── README.md
└── NewebPay.php


/TODO.md:
--------------------------------------------------------------------------------
1 | # TODO
2 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | /vendor
2 | composer.lock
3 | phpunit.xml


--------------------------------------------------------------------------------
/Info/InfoDecorator.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace fall1600\Package\Newebpay\Info;
4 | 
5 | abstract class InfoDecorator extends Info
6 | {
7 | }
8 | 


--------------------------------------------------------------------------------
/Constants/Cipher.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace fall1600\Package\Newebpay\Constants;
4 | 
5 | class Cipher
6 | {
7 |     public const METHOD = 'AES-256-CBC';
8 | }
9 | 


--------------------------------------------------------------------------------
/Contracts/InfoInterface.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace fall1600\Package\Newebpay\Contracts;
4 | 
5 | interface InfoInterface
6 | {
7 |     public function getInfo();
8 | }
9 | 


--------------------------------------------------------------------------------
/Exceptions/TradeInfoException.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace fall1600\Package\Newebpay\Exceptions;
4 | 
5 | class TradeInfoException extends \Exception
6 | {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/Constants/LanguageType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Constants;
 4 | 
 5 | class LanguageType
 6 | {
 7 |     // 繁體中文
 8 |     const ZH_TW = 'zh-tw';
 9 | 
10 |     // 英文
11 |     const EN = 'en';
12 | 
13 |     // 日文
14 |     const JP = 'JP';
15 | }
16 | 


--------------------------------------------------------------------------------
/Constants/Period/VersionType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Constants\Period;
 4 | 
 5 | class VersionType
 6 | {
 7 |     /**
 8 |      * 帶入 1.1 版本,則[背面末三碼]將為非必填
 9 |      */
10 |     public const V1_1 = '1.1';
11 | 
12 |     /**
13 |      * 帶入 1.0 版本,則[背面末三碼]將為必填欄位
14 |      */
15 |     public const V1_0 = '1.0';
16 | }
17 | 


--------------------------------------------------------------------------------
/Info/Period/Decorator/BackUrl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Period\Decorator;
 4 | 
 5 | class BackUrl extends Webhook
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'BackURL' => $this->url,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableWebAtm.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableWebAtm extends Enable
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'WEBATM' => $this->isEnable? 1: 0,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Period/Decorator/NotifyUrl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Period\Decorator;
 4 | 
 5 | class NotifyUrl extends Webhook
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'NotifyURL' => $this->url,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Period/Decorator/ReturnUrl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Period\Decorator;
 4 | 
 5 | class ReturnUrl extends Webhook
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'ReturnURL' => $this->url,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableLinePay.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableLinePay extends Enable
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'LINEPAY' => $this->isEnable? 1: 0,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableUnionPay.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableUnionPay extends Enable
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'UNIONPAY' => $this->isEnable? 1: 0,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableGooglePay.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableGooglePay extends Enable
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'ANDROIDPAY' => $this->isEnable? 1: 0,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableCreditBonus.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableCreditBonus extends Enable
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'CreditRed' => $this->isEnable? 1: 0,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableSamsungPay.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableSamsungPay extends Enable
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'SAMSUNGPAY' => $this->isEnable? 1: 0,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableAmericanExpress.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableAmericanExpress extends Enable
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return $this->info->getInfo() +
10 |             [
11 |                 'CREDITAE' => $this->isEnable? 1: 0,
12 |             ];
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/Contracts/PayerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Contracts;
 4 | 
 5 | interface PayerInterface
 6 | {
 7 |     /**
 8 |      * 用來通知付款人的信箱, 發生於完成交易或付款完成
 9 |      * @return string
10 |      */
11 |     public function getEmail();
12 | 
13 |     /**
14 |      * 是否需要登入藍新金流會員
15 |      * @return bool
16 |      */
17 |     public function getLoginType();
18 | }
19 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableAliPay.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableAliPay extends Enable
 6 | {
 7 |     /**
 8 |      * 支付寶啟用
 9 |      * @return array
10 |      */
11 |     public function getInfo()
12 |     {
13 |         return $this->info->getInfo() +
14 |             [
15 |                 'ALIPAY' => $this->isEnable? 1: 0,
16 |             ];
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableEzPay.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableEzPay extends Enable
 6 | {
 7 |     /**
 8 |      * ezPay 電子錢包啟用
 9 |      * @return array
10 |      */
11 |     public function getInfo()
12 |     {
13 |         return $this->info->getInfo() +
14 |             [
15 |                 'P2G' => $this->isEnable? 1: 0,
16 |             ];
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableVacc.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableVacc extends Enable
 6 | {
 7 |     /**
 8 |      * ATM 轉帳啟用
 9 |      *
10 |      * @return array
11 |      */
12 |     public function getInfo()
13 |     {
14 |         return $this->info->getInfo() +
15 |             [
16 |                 'VACC' => $this->isEnable? 1: 0,
17 |             ];
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/Constants/Period/AlterType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Constants\Period;
 4 | 
 5 | class AlterType
 6 | {
 7 |     // 暫停授權
 8 |     public const SUSPEND = 'suspend';
 9 | 
10 |     // 終止委託
11 |     // 終止委託後無法再次以[restart]進行啟用
12 |     public const TERMINATE = 'terminate';
13 | 
14 |     // 重新啟用已暫停授權, 於最近一期開始取授權
15 |     // 訂期定額委託單暫停後再啟用總期數不變, 扣款時間將向後展延至期數滿期
16 |     public const RESTART = 'restart';
17 | }
18 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableCvs.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableCvs extends Enable
 6 | {
 7 |     /**
 8 |      * 超商代碼啟用
 9 |      *  若訂單金額低於30或高於 20000, 進入付款頁面也不會啟用此設定
10 |      * @return array
11 |      */
12 |     public function getInfo()
13 |     {
14 |         return $this->info->getInfo() +
15 |             [
16 |                 'CVS' => $this->isEnable? 1: 0,
17 |             ];
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableBarcode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | class EnableBarcode extends Enable
 6 | {
 7 |     /**
 8 |      * 超商條碼啟用
 9 |      *  若訂單金額小於20 或超過40000, 進入付款頁面也不會啟用此設定
10 |      * @return array
11 |      */
12 |     public function getInfo()
13 |     {
14 |         return $this->info->getInfo() +
15 |             [
16 |                 'BARCODE' => $this->isEnable? 1: 0,
17 |             ];
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/Contracts/AliPayPayerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Contracts;
 4 | 
 5 | interface AliPayPayerInterface extends PayerInterface
 6 | {
 7 |     /**
 8 |      * 收貨人姓名
 9 |      * @return string
10 |      */
11 |     public function getReceiver();
12 | 
13 |     /**
14 |      * 收貨人主要聯絡電話
15 |      * @return string
16 |      */
17 |     public function getTel1();
18 | 
19 |     /**
20 |      * 收貨人次要聯絡電話
21 |      * @return string
22 |      */
23 |     public function getTel2();
24 | }
25 | 


--------------------------------------------------------------------------------
/Contracts/QuickCreditInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Contracts;
 4 | 
 5 | interface QuickCreditInterface
 6 | {
 7 |     /**
 8 |      * 付款人綁定資料
 9 |      *  可對應付款人之資料,用於綁定付款人與信用卡卡號時使用, 例:會員編號、Email
10 |      *  限英、數字,「.」、「_」、「@」、「-」格式。
11 |      * @return string
12 |      */
13 |     public function getTokenTerm();
14 | 
15 |     /**
16 |      * 1: 必填信用卡到期日與末三碼
17 |      * 2: 必填信用卡到期日
18 |      * 3: 必填末三碼
19 |      * @return int
20 |      */
21 |     public function getTokenTermDemand();
22 | }
23 | 


--------------------------------------------------------------------------------
/Info/Period/Decorator/Webhook.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Period\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Period\Info;
 6 | 
 7 | abstract class Webhook extends Info
 8 | {
 9 |     /**
10 |      * @var Info
11 |      */
12 |     protected $info;
13 | 
14 |     /**
15 |      * @var string
16 |      */
17 |     protected $url;
18 | 
19 |     public function __construct(Info $info, string $url)
20 |     {
21 |         $this->info = $info;
22 | 
23 |         $this->url = $url;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/Contracts/OrderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Contracts;
 4 | 
 5 | interface OrderInterface
 6 | {
 7 |     /**
 8 |      * 交易金額
 9 |      *   1.純數字不含符號,例:1000。
10 |      *   2.幣別:新台幣。
11 |      * @return int
12 |      */
13 |     public function getAmt();
14 | 
15 |     /**
16 |      * 商店訂單編號
17 |      *
18 |      * @return string
19 |      */
20 |     public function getMerchantOrderNo();
21 | 
22 |     /**
23 |      * 商品資訊
24 |      *
25 |      * @return string
26 |      */
27 |     public function getItemDesc();
28 | }
29 | 


--------------------------------------------------------------------------------
/Info/Decorator/Enable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | abstract class Enable extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /** @var bool */
14 |     protected $isEnable;
15 | 
16 |     public function __construct(Info $info, bool $isEnable = true)
17 |     {
18 |         $this->info = $info;
19 | 
20 |         $this->isEnable = $isEnable;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/Info/AliPayInfo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info;
 4 | 
 5 | use fall1600\Package\Newebpay\Contracts\AliPayPayerInterface;
 6 | use fall1600\Package\Newebpay\Contracts\OrderInterface;
 7 | 
 8 | abstract class AliPayInfo extends Info
 9 | {
10 |     /**
11 |      * 商品數量, 舉例此訂單有商品A, B兩種品項, 則帶入數值2
12 |      * @var int $count
13 |      */
14 |     protected $count;
15 | 
16 |     public function __construct(
17 |         string $merchantId,
18 |         string $notifyUrl,
19 |         OrderInterface $order,
20 |         AliPayPayerInterface $payer,
21 |         int $count
22 |     ) {
23 |         parent::__construct($merchantId, $notifyUrl, $order, $payer);
24 | 
25 |         $this->count = $count;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/Contracts/AliPayProductInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Contracts;
 4 | 
 5 | interface AliPayProductInterface
 6 | {
 7 |     /**
 8 |      * 商品編號, 長度限制12位數
 9 |      * @return int
10 |      */
11 |     public function getProductId();
12 | 
13 |     /**
14 |      * 商品名稱, 長度限制60個字元
15 |      * @return string
16 |      */
17 |     public function getTitle();
18 | 
19 |     /**
20 |      * 商品說明, 長度100個字元
21 |      * @return string
22 |      */
23 |     public function getDescription();
24 | 
25 |     /**
26 |      * 商品單價(新台幣), 長度限制5位數
27 |      * @return int
28 |      */
29 |     public function getPrice();
30 | 
31 |     /**
32 |      * 商品數量, 長度限制2位數
33 |      * @return int
34 |      */
35 |     public function getQuantity();
36 | }
37 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "fall1600/newebpay",
 3 |     "description": "Payment solution of NewebPay(藍新金流), implementing by pure PHP",
 4 |     "keywords": ["newebpay", "payment"],
 5 |     "type": "library",
 6 |     "license": "MIT",
 7 |     "authors": [
 8 |         {
 9 |             "name": "fall1600",
10 |             "email": "fall1600@gmail.com"
11 |         }
12 |     ],
13 |     "minimum-stability": "stable",
14 |     "require": {
15 |         "ext-openssl": "*",
16 |         "ext-mbstring": "*",
17 |         "ext-json": "*",
18 |         "ext-curl": "*"
19 |     },
20 |     "autoload": {
21 |         "psr-4": {
22 |             "fall1600\\Package\\Newebpay\\": ""
23 |         },
24 |         "exclude-from-classmap": [
25 |             "/Tests/"
26 |         ]
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/Info/Decorator/PayerEmailEditable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class PayerEmailEditable extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /** @var bool */
14 |     protected $canEditEmail;
15 | 
16 |     public function __construct(Info $info, bool $canEditEmail = true)
17 |     {
18 |         $this->info = $info;
19 | 
20 |         $this->canEditEmail = $canEditEmail;
21 |     }
22 | 
23 |     public function getInfo()
24 |     {
25 |         return $this->info->getInfo() +
26 |             [
27 |                 'EmailModify' => $this->canEditEmail? 1: 0,
28 |             ];
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/Info/BasicInfo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info;
 4 | 
 5 | use fall1600\Package\Newebpay\NewebPay;
 6 | 
 7 | class BasicInfo extends Info
 8 | {
 9 |     public function getInfo()
10 |     {
11 |         return [
12 |             'MerchantID' => $this->merchantId,
13 |             'RespondType' => 'JSON',
14 |             'TimeStamp' => time(),
15 |             'Version' => NewebPay::VERSION,
16 |             'NotifyURL' => $this->notifyUrl,
17 |             'Amt' => $this->order->getAmt(),
18 |             'ItemDesc' => $this->order->getItemDesc(),
19 |             'MerchantOrderNo' => $this->order->getMerchantOrderNo(),
20 |             'Email' => $this->payer->getEmail(),
21 |             'LoginType' => $this->payer->getLoginType()? 1: 0,
22 |         ];
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/Info/Decorator/Language.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Constants\LanguageType;
 6 | use fall1600\Package\Newebpay\Info\Info;
 7 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 8 | 
 9 | class Language extends InfoDecorator
10 | {
11 |     /** @var Info */
12 |     protected $info;
13 | 
14 |     /** @var string */
15 |     protected $language;
16 | 
17 |     public function __construct(Info $info, string $language)
18 |     {
19 |         $this->info = $info;
20 | 
21 |         $this->language = $language;
22 |     }
23 | 
24 |     public function getInfo()
25 |     {
26 |         return $this->info->getInfo() +
27 |             [
28 |                 'LangType' => $this->language ?? LanguageType::ZH_TW,
29 |             ];
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/Constants/Period/PeriodStartType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Constants\Period;
 4 | 
 5 | /**
 6 |  * 請參閱文件 p.13
 7 |  *
 8 |  * 此委託單成立後,是否立即進行信用卡授權交易,作為檢查信用卡卡號之有效性。
 9 |  *   1=立即執行十元授權(因部分發卡銀行會阻擋一元交易,因此調整為十元)
10 |  *   2=立即執行委託金額授權
11 |  *   3=不檢查信用卡資訊,不授權
12 |  */
13 | class PeriodStartType
14 | {
15 |     /**
16 |      * 委託建立當下系統將發動一筆十元信用卡授權交易,此交易授權成功後,系統將立即自動取消授權,
17 |      * 付款人將不會被扣款。商店可於平台銷售中心/定期定額管理中查看此筆十元交易取消授權紀錄。
18 |      */
19 |     public const _1 = '1';
20 | 
21 |     /**
22 |      * 委託單建立當下,立即執行委託金額授權。
23 |      * 若信用卡授權失敗,則該筆委託單將自動取消。
24 |      */
25 |     public const _2 = '2';
26 | 
27 |     /**
28 |      * 委託單自動成立。首期授權時授權失敗,則系統會自動終止該張委託單。
29 |      * 首期授權成功,但第二期授權因其他原因授權失敗(額度不足或該張卡號以掛失..等原因),
30 |      * 則系統仍會自動執行第三期、第四期...之授權,直到委託單終止。
31 |      */
32 |     public const _3 = '3';
33 | }
34 | 


--------------------------------------------------------------------------------
/Contracts/Period/ContactInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Contracts\Period;
 4 | 
 5 | interface ContactInterface
 6 | {
 7 |     /**
 8 |      * 付款人電子信箱
 9 |      * @return string
10 |      */
11 |     public function getPayerEmail();
12 | 
13 |     /**
14 |      * 設定於付款頁面,付款人電子信箱欄位是否開放讓付款人修改
15 |      *  1=可修改
16 |      *  0=不可修改
17 |      * 當未提供此參數時,將預設為可修改
18 |      * @return int
19 |      */
20 |     public function getPayerEmailModify();
21 | 
22 |     /**
23 |      * 於付款人填寫此委託單時,是否需顯示付款人資訊填寫欄位
24 |      *  Y=是
25 |      *  N=否
26 |      * 若未提供此參數,則預設為是
27 |      * @return string
28 |      */
29 |     public function getPaymentInfo();
30 | 
31 |     /**
32 |      * 於付款人填寫此委託單時,是否需顯示收件人資訊填寫欄位
33 |      *  Y=是
34 |      *  N=否
35 |      * 若未提供此參數,則預設為是
36 |      * @return string
37 |      */
38 |     public function getOrderInfo();
39 | }
40 | 


--------------------------------------------------------------------------------
/Info/Decorator/PayInInstallments.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class PayInInstallments extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 信用卡分期付款, 可分3, 6, 12, 18, 24, 30期
15 |      *  1: 所有分期期別
16 |      *  3,6,12: 開啟分3, 6, 12 期
17 |      *  0: 不開啟分期付款
18 |      * @var string
19 |      */
20 |     protected $instFlag;
21 | 
22 |     public function __construct(Info $info, string $instFlag)
23 |     {
24 |         $this->info = $info;
25 | 
26 |         $this->instFlag = $instFlag;
27 |     }
28 | 
29 |     public function getInfo()
30 |     {
31 |         return $this->info->getInfo() +
32 |             [
33 |                 'InstFlag' => $this->instFlag,
34 |             ];
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/Info/Decorator/PayComplete.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class PayComplete extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 支付完成返回的商店網址
15 |      *
16 |      * @var string
17 |      */
18 |     protected $returnUrl;
19 | 
20 |     public function __construct(Info $info, string $returnUrl)
21 |     {
22 |         $this->info = $info;
23 | 
24 |         $this->setReturnUrl($returnUrl);
25 |     }
26 | 
27 |     public function getInfo()
28 |     {
29 |         return $this->info->getInfo() +
30 |             [
31 |                 'ReturnURL' => $this->returnUrl,
32 |             ];
33 |     }
34 | 
35 |     protected function setReturnUrl(string $returnUrl = null)
36 |     {
37 |         $this->returnUrl = $returnUrl;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/phpunit.xml.dist:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | 
 3 | <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/5.2/phpunit.xsd"
 5 |          backupGlobals="false"
 6 |          colors="true"
 7 |          bootstrap="vendor/autoload.php"
 8 |          failOnRisky="true"
 9 |          failOnWarning="true"
10 | >
11 |     <php>
12 |         <ini name="error_reporting" value="-1" />
13 |     </php>
14 | 
15 |     <testsuites>
16 |         <testsuite name="fall1600 newebpay Test Suite">
17 |             <directory>./Tests/</directory>
18 |         </testsuite>
19 |     </testsuites>
20 | 
21 |     <filter>
22 |         <whitelist>
23 |             <directory>./</directory>
24 |             <exclude>
25 |                 <directory>./Tests</directory>
26 |                 <directory>./vendor</directory>
27 |             </exclude>
28 |         </whitelist>
29 |     </filter>
30 | </phpunit>
31 | 


--------------------------------------------------------------------------------
/Info/Period/Decorator/Memo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Period\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Period\Info;
 6 | 
 7 | class Memo extends Info
 8 | {
 9 |     /**
10 |      * @var Info
11 |      */
12 |     protected $info;
13 | 
14 |     /**
15 |      * @var string $memo
16 |      */
17 |     protected $memo;
18 | 
19 |     public function __construct(Info $info, string $memo)
20 |     {
21 |         $this->info = $info;
22 | 
23 |         $this->setMemo($memo);
24 |     }
25 | 
26 |     public function getInfo()
27 |     {
28 |         return $this->info->getInfo() +
29 |             [
30 |                 'PeriodMemo' => $this->memo,
31 |             ];
32 |     }
33 | 
34 |     protected function setMemo(string $memo)
35 |     {
36 |         if (mb_strlen($memo) > 255) {
37 |             throw new \LogicException("unsupported length of this memo $memo");
38 |         }
39 | 
40 |         $this->memo = $memo;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/Info/Decorator/PayCancel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class PayCancel extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 支付取消返回的商店網址
15 |      *
16 |      * @var string
17 |      */
18 |     protected $clientBackUrl;
19 | 
20 |     public function __construct(Info $info, string $clientBackUrl = null)
21 |     {
22 |         $this->info = $info;
23 | 
24 |         $this->setClientBackUrl($clientBackUrl);
25 |     }
26 | 
27 |     public function getInfo()
28 |     {
29 |         return $this->info->getInfo() +
30 |             [
31 |                 'ClientBackURL' => $this->clientBackUrl,
32 |             ];
33 |     }
34 | 
35 |     protected function setClientBackUrl(string $clientBackUrl = null)
36 |     {
37 |         $this->clientBackUrl = $clientBackUrl;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/Tests/MerchantTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Tests;
 4 | 
 5 | use fall1600\Package\Newebpay\Merchant;
 6 | use PHPUnit\Framework\TestCase;
 7 | 
 8 | class MerchantTest extends TestCase
 9 | {
10 |     public function test_decrypt()
11 |     {
12 |         //arrange
13 |         $merchant = new Merchant('3430112', '12345678901234567890123456789012', '1234567890123456');
14 | 
15 |         $encryptedStr = 'ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa';
16 | 
17 |         $expected = 'MerchantID=3430112&RespondType=JSON&TimeStamp=1485232229&Version=1.4&MerchantOrderNo=S_1485232229&Amt=40&ItemDesc=UnitTest';
18 | 
19 |         //act
20 |         $result = $merchant->decryptTradeInfo($encryptedStr);
21 | 
22 |         //assert
23 |         $this->assertEquals($expected, $result);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableCredit.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Contracts\QuickCreditInterface;
 6 | use fall1600\Package\Newebpay\Info\Info;
 7 | 
 8 | class EnableCredit extends Enable
 9 | {
10 |     /** @var QuickCreditInterface|null */
11 |     protected $quickCredit;
12 | 
13 |     public function __construct(Info $info, ?QuickCreditInterface $quickCredit = null)
14 |     {
15 |         parent::__construct($info);
16 | 
17 |         $this->quickCredit = $quickCredit;
18 |     }
19 | 
20 |     public function getInfo()
21 |     {
22 |         $result = $this->info->getInfo() +
23 |             [
24 |                 'CREDIT' => $this->isEnable? 1: 0,
25 |             ];
26 | 
27 |         if ($this->quickCredit) {
28 |             $result += [
29 |                 'TokenTerm' => $this->quickCredit->getTokenTerm(),
30 |                 'TokenTermDemand' => $this->quickCredit->getTokenTermDemand(),
31 |             ];
32 |         }
33 | 
34 |         return $result;
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/Info/Period/BasicInfo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Period;
 4 | 
 5 | class BasicInfo extends Info
 6 | {
 7 |     public function getInfo()
 8 |     {
 9 |         return [
10 |             'RespondType' => 'JSON',
11 |             'TimeStamp' => time(),
12 |             'Version' => $this->version,
13 |             'MerOrderNo' => $this->order->getMerOrderNo(),
14 |             'ProdDesc' => $this->order->getProdDesc(),
15 |             'PeriodAmt' => $this->order->getAmount(),
16 |             'PeriodType' => $this->order->getPeriodType(),
17 |             'PeriodPoint' => $this->order->getPeriodPoint(),
18 |             'PeriodStartType' => $this->periodStartType,
19 |             'PeriodTimes' => $this->order->getPeriodTimes(),
20 |             'PayerEmail' => $this->contact->getPayerEmail(),
21 |             'EmailModify' => $this->contact->getPayerEmailModify(),
22 |             'PaymentInfo' => $this->contact->getPaymentInfo(),
23 |             'OrderInfo' => $this->contact->getOrderInfo(),
24 |         ];
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/Info/AliPayBasicInfo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info;
 4 | 
 5 | use fall1600\Package\Newebpay\NewebPay;
 6 | 
 7 | class AliPayBasicInfo extends AliPayInfo
 8 | {
 9 |     public function getInfo()
10 |     {
11 |         return [
12 |             // 基本必填
13 |             'MerchantID' => $this->merchantId,
14 |             'RespondType' => 'JSON',
15 |             'TimeStamp' => time(),
16 |             'Version' => NewebPay::VERSION,
17 |             'NotifyURL' => $this->notifyUrl,
18 |             'Amt' => $this->order->getAmt(),
19 |             'ItemDesc' => $this->order->getItemDesc(),
20 |             'MerchantOrderNo' => $this->order->getMerchantOrderNo(),
21 |             'Email' => $this->payer->getEmail(),
22 |             'LoginType' => $this->payer->getLoginType()? 1: 0,
23 |             // AliPay 必填
24 |             'Receiver' => $this->payer->getReceiver(),
25 |             'Tel1' => $this->payer->getTel1(),
26 |             'Tel2' => $this->payer->getTel2(),
27 |             'Count' => $this->count,
28 |         ];
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/Info/Decorator/Comment.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class Comment extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 商店備註
15 |      *  若提供此參數則會在付款頁面顯示商店資訊
16 |      * @var string
17 |      */
18 |     protected $comment;
19 | 
20 |     public function __construct(Info $info, string $comment)
21 |     {
22 |         $this->info = $info;
23 | 
24 |         $this->setComment($comment);
25 |     }
26 | 
27 |     public function getInfo()
28 |     {
29 |         return $this->info->getInfo() +
30 |             [
31 |                 'OrderComment' => $this->comment,
32 |             ];
33 |     }
34 | 
35 |     protected function setComment(string $comment)
36 |     {
37 |         if (mb_strlen($comment) > 300) {
38 |             throw new \LogicException('comment must less or equal than 300');
39 |         }
40 | 
41 |         $this->comment = $comment;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2016-2020 Lin Jinghong
 2 | 
 3 | Permission is hereby granted, free of charge, to any person obtaining a copy
 4 | of this software and associated documentation files (the "Software"), to deal
 5 | in the Software without restriction, including without limitation the rights
 6 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 7 | copies of the Software, and to permit persons to whom the Software is furnished
 8 | to do so, subject to the following conditions:
 9 | 
10 | The above copyright notice and this permission notice shall be included in all
11 | copies or substantial portions of the Software.
12 | 
13 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19 | THE SOFTWARE.


--------------------------------------------------------------------------------
/Info/Decorator/TradeLimit.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class TradeLimit extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 交易限制秒數, 超過即交易失敗
15 |      *  0: 不啟用
16 |      *  1~60: 限制60秒
17 |      *  上限 900 秒
18 |      * @var int
19 |      */
20 |     protected $limit;
21 | 
22 |     public function __construct(Info $info, int $limit = 0)
23 |     {
24 |         $this->info = $info;
25 | 
26 |         $this->setLimit($limit);
27 |     }
28 | 
29 |     public function getInfo()
30 |     {
31 |         return $this->info->getInfo() +
32 |             [
33 |                 'TradeLimit' => $this->limit,
34 |             ];
35 |     }
36 | 
37 |     protected function setLimit(int $limit)
38 |     {
39 |         if (1 <= $limit && $limit <= 60) {
40 |             $limit = 60;
41 |         }
42 | 
43 |         if ($limit > 900) {
44 |             $limit = 900;
45 |         }
46 | 
47 |         $this->limit = $limit;
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/Info/Decorator/EnableCvsCom.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class EnableCvsCom extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 1: 超商取貨不付款
15 |      * 2: 超商取貨付款
16 |      * 3: 超商取貨不付款及超商取貨付款 (1,2同時)
17 |      * 0: 不啟用
18 |      *  若訂單金額小於30 或大於20000, 進入付款頁面不顯示此支付方式
19 |      * @var int
20 |      */
21 |     protected $type;
22 | 
23 |     public function __construct(Info $info, int $type)
24 |     {
25 |         $this->info = $info;
26 | 
27 |         $this->setType($type);
28 |     }
29 | 
30 |     /**
31 |      * 物流啟用
32 |      *
33 |      * @return array
34 |      */
35 |     public function getInfo()
36 |     {
37 |         return $this->info->getInfo() +
38 |             [
39 |                 'CVSCOM' => $this->type,
40 |             ];
41 |     }
42 | 
43 |     /**
44 |      * @param int $type
45 |      */
46 |     protected function setType(int $type)
47 |     {
48 |         if ($type < 0 || $type > 3) {
49 |             throw new \LogicException('Newebpay does not support this type');
50 |         }
51 | 
52 |         $this->type = $type;
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/Info/Decorator/AliPayProduct.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Contracts\AliPayProductInterface;
 6 | use fall1600\Package\Newebpay\Info\AliPayInfo;
 7 | 
 8 | class AliPayProduct extends AliPayInfo
 9 | {
10 |     /** @var AliPayInfo */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 訂單中品項的流水號, 從1開始遞增
15 |      * @var int
16 |      */
17 |     protected $index;
18 | 
19 |     /** @var AliPayProductInterface */
20 |     protected $product;
21 | 
22 |     public function __construct(AliPayInfo $info, int $index, AliPayProductInterface $product)
23 |     {
24 |         $this->info = $info;
25 | 
26 |         $this->index = $index;
27 | 
28 |         $this->product = $product;
29 |     }
30 | 
31 |     public function getInfo()
32 |     {
33 |         return $this->info->getInfo() +
34 |             [
35 |                 "Pid{$this->index}" => $this->product->getProductId(),
36 |                 "Title{$this->index}" => $this->product->getTitle(),
37 |                 "Desc{$this->index}" => $this->product->getDescription(),
38 |                 "Price{$this->index}" => $this->product->getPrice(),
39 |                 "Qty{$this->index}" => $this->product->getQuantity(),
40 |             ];
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/Contracts/Period/OrderInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Contracts\Period;
 4 | 
 5 | interface OrderInterface
 6 | {
 7 |     /**
 8 |      * 商店自訂的定期定額訂單編號
 9 |      * @return string
10 |      */
11 |     public function getMerOrderNo();
12 | 
13 |     /**
14 |      * 委託金額
15 |      *  1.純數字不含符號,例:1000
16 |      *  2.幣別:新台幣
17 |      * @return int
18 |      */
19 |     public function getAmount();
20 | 
21 |     /**
22 |      * 產品名稱
23 |      *  1.此委託單的商品或服務名稱
24 |      *  2.長度限制為 100 字
25 |      *  3.僅限制使用中文、英文、數字、空格及底線若內容必須含有特殊符號請自行轉為全形
26 |      * @return string
27 |      */
28 |     public function getProdDesc();
29 | 
30 |     /**
31 |      * 週期類別
32 |      *  D=固定天期制, W=每週, M=每月, Y=每年
33 |      * @return string
34 |      */
35 |     public function getPeriodType();
36 | 
37 |     /**
38 |      * 交易週期授權時間
39 |      *  W: 1~7
40 |      *  M: 01~31
41 |      *  Y: MMDD
42 |      * @return string
43 |      */
44 |     public function getPeriodPoint();
45 | 
46 |     /**
47 |      * 1. 此委託單執行信用卡授權交易的次數
48 |      * 2. 若授權期數大於信用卡到期日,則系統自動以信用卡到期日為最終期數。
49 |      *  例:授權週期為M(月),於2016/10/1建立委託單,授權期數為12,
50 |      *     而付款人之信用卡到期月/年為12/16時,則此張委託單之授權期數為3,
51 |      *     2016/10月、11月、12月,共3期。
52 |      * @return string
53 |      */
54 |     public function getPeriodTimes();
55 | }
56 | 


--------------------------------------------------------------------------------
/Info/Info.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info;
 4 | 
 5 | use fall1600\Package\Newebpay\Contracts\InfoInterface;
 6 | use fall1600\Package\Newebpay\Contracts\OrderInterface;
 7 | use fall1600\Package\Newebpay\Contracts\PayerInterface;
 8 | 
 9 | abstract class Info implements InfoInterface
10 | {
11 |     /**
12 |      * 要交給藍新處理金流的訂單
13 |      * @var OrderInterface
14 |      */
15 |     protected $order;
16 | 
17 |     /**
18 |      * 付款人資訊
19 |      * @var PayerInterface
20 |      */
21 |     protected $payer;
22 | 
23 |     /**
24 |      * 藍新金流商店代號
25 |      * @var string
26 |      */
27 |     protected $merchantId;
28 | 
29 |     /**
30 |      * 支付通知網址
31 |      *  藍新背景告知系統支付明細的callback url
32 |      * @var string
33 |      */
34 |     protected $notifyUrl;
35 | 
36 |     /**
37 |      * Decorator
38 |      *
39 |      * @return array
40 |      */
41 |     abstract public function getInfo();
42 | 
43 |     public function __construct(string $merchantId, string $notifyUrl, OrderInterface $order, PayerInterface $payer)
44 |     {
45 |         $this->order = $order;
46 | 
47 |         $this->payer = $payer;
48 | 
49 |         $this->merchantId = $merchantId;
50 | 
51 |         $this->notifyUrl = $notifyUrl;
52 |     }
53 | 
54 |     /**
55 |      * @return string
56 |      */
57 |     public function getMerchantId()
58 |     {
59 |         return $this->merchantId;
60 |     }
61 | 
62 |     /**
63 |      * @return OrderInterface
64 |      */
65 |     public function getOrder()
66 |     {
67 |         return $this->order;
68 |     }
69 | 
70 |     /**
71 |      * @return PayerInterface
72 |      */
73 |     public function getPayer()
74 |     {
75 |         return $this->payer;
76 |     }
77 | }
78 | 


--------------------------------------------------------------------------------
/Info/Decorator/OfflinePay.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Decorator;
 4 | 
 5 | use fall1600\Package\Newebpay\Info\Info;
 6 | use fall1600\Package\Newebpay\Info\InfoDecorator;
 7 | 
 8 | class OfflinePay extends InfoDecorator
 9 | {
10 |     /** @var Info */
11 |     protected $info;
12 | 
13 |     /**
14 |      * 離線付款有效天數, 預設7天, 最長可支援180天
15 |      *  用來計算參數 ExpireDate
16 |      *
17 |      * @var int
18 |      */
19 |     protected $ttl;
20 | 
21 |     /**
22 |      * 商店取號網址
23 |      *  消費者選擇離線付款後 藍新要通知你系統付款資訊
24 |      *
25 |      * @var string
26 |      */
27 |     protected $customerUrl;
28 | 
29 |     public function __construct(Info $info, string $customerUrl, int $ttl = null)
30 |     {
31 |         $this->info = $info;
32 | 
33 |         $this->customerUrl = $customerUrl;
34 | 
35 |         $this->setTtl($ttl);
36 |     }
37 | 
38 |     public function getInfo()
39 |     {
40 |         return $this->info->getInfo() +
41 |             [
42 |                 'ExpireDate' => $this->countExpireDate(),
43 |                 'CustomerURL' => $this->customerUrl,
44 |             ];
45 |     }
46 | 
47 |     protected function setTtl(int $ttl = null)
48 |     {
49 |         if ($ttl <= 0) {
50 |             throw new \LogicException('ttl must be large than 1');
51 |         }
52 | 
53 |         if ($ttl > 180) {
54 |             throw new \LogicException('ttl must be less than or equal to 180');
55 |         }
56 | 
57 |         $this->ttl = $ttl;
58 |     }
59 | 
60 |     /**
61 |      * @return string
62 |      */
63 |     protected function countExpireDate()
64 |     {
65 |         if (! $this->ttl) {
66 |             return '';
67 |         }
68 | 
69 |         return date('Ymd', strtotime("+$this->ttl days"));
70 |     }
71 | }
72 | 


--------------------------------------------------------------------------------
/Info/Period/Info.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace fall1600\Package\Newebpay\Info\Period;
 4 | 
 5 | //use fall1600\Package\Newebpay\Constants\Period\PeriodStartType;
 6 | use fall1600\Package\Newebpay\Constants\Period\VersionType;
 7 | use fall1600\Package\Newebpay\Contracts\InfoInterface;
 8 | use fall1600\Package\Newebpay\Contracts\Period\ContactInterface;
 9 | use fall1600\Package\Newebpay\Contracts\Period\OrderInterface;
10 | 
11 | abstract class Info implements InfoInterface
12 | {
13 |     /**
14 |      * @var string
15 |      */
16 |     protected $version;
17 | 
18 |     /**
19 |      * @var OrderInterface
20 |      */
21 |     protected $order;
22 | 
23 |     /**
24 |      * @var ContactInterface
25 |      */
26 |     protected $contact;
27 | 
28 |     /**
29 |      * @var string
30 |      */
31 |     protected $periodStartType;
32 | 
33 |     /**
34 |      * Decorator
35 |      *
36 |      * @return array
37 |      */
38 |     abstract public function getInfo();
39 | 
40 |     /**
41 |      * @param   OrderInterface    $order
42 |      * @param   ContactInterface  $contact
43 |      * @param   string            $periodStartType
44 |      * @param   string            $version
45 |      */
46 |     public function __construct(
47 |         OrderInterface $order,
48 |         ContactInterface $contact,
49 |         string $periodStartType,
50 |         string $version = VersionType::V1_0
51 |     ) {
52 |         $this->order = $order;
53 | 
54 |         $this->contact = $contact;
55 | 
56 |         $this->setPeriodStartType($periodStartType);
57 | 
58 |         $this->setVersion($version);
59 |     }
60 | 
61 |     protected function setPeriodStartType(string $periodStartType)
62 |     {
63 | //        if (! PeriodStartType::isValid($periodStartType)) {
64 | //            throw new \LogicException("unsupported version $periodStartType");
65 | //        }
66 | 
67 |         $this->periodStartType = $periodStartType;
68 |     }
69 | 
70 |     protected function setVersion(string $version)
71 |     {
72 | //        if (! VersionType::isValid($version)) {
73 | //            throw new \LogicException("unsupported version $version");
74 | //        }
75 | 
76 |         $this->version = $version;
77 |     }
78 | }
79 | 


--------------------------------------------------------------------------------
/Merchant.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace fall1600\Package\Newebpay;
  4 | 
  5 | use fall1600\Package\Newebpay\Exceptions\TradeInfoException;
  6 | 
  7 | class Merchant
  8 | {
  9 |     use Cryption;
 10 | 
 11 |     /**
 12 |      * 藍新金流商店代號
 13 |      * @var string
 14 |      */
 15 |     protected $id;
 16 | 
 17 |     /**
 18 |      * 商店專屬 HashKey
 19 |      * @var string
 20 |      */
 21 |     protected $hashKey;
 22 | 
 23 |     /**
 24 |      * 商店專屬 HashIV
 25 |      * @var string
 26 |      */
 27 |     protected $hashIv;
 28 | 
 29 |     /**
 30 |      * 封裝來自藍新的回傳, 僅提供各種支付共同參數的accessor
 31 |      * @var Response
 32 |      */
 33 |     protected $response;
 34 | 
 35 |     public function __construct(string $id, string $hashKey, string $hashIv)
 36 |     {
 37 |         $this->id = $id;
 38 | 
 39 |         $this->hashKey = $hashKey;
 40 | 
 41 |         $this->hashIv = $hashIv;
 42 |     }
 43 | 
 44 |     /**
 45 |      * 因為商城代號, hashKey, hashIv 是一整組的, 要就一次修改
 46 |      * response 是屬於個別商城的, 改商城順手清空response
 47 |      * @param  string  $id
 48 |      * @param  string  $hashKey
 49 |      * @param  string  $hashIv
 50 |      * @return $this
 51 |      */
 52 |     public function reset(string $id, string $hashKey, string $hashIv)
 53 |     {
 54 |         $this->id = $id;
 55 |         $this->hashKey = $hashKey;
 56 |         $this->hashIv = $hashIv;
 57 | 
 58 |         $this->response = null;
 59 | 
 60 |         return $this;
 61 |     }
 62 | 
 63 |     /**
 64 |      * 注入來自藍新通知的交易資訊
 65 |      * @param array $rawData
 66 |      * @return $this
 67 |      * @throws TradeInfoException
 68 |      */
 69 |     public function setRawData(array $rawData)
 70 |     {
 71 |         if (! isset($rawData['TradeInfo']) || ! isset($rawData['TradeSha'])) {
 72 |             throw new TradeInfoException('invalid data');
 73 |         }
 74 | 
 75 |         $this->response = new Response(
 76 |             json_decode($this->decryptTradeInfo($rawData['TradeInfo']), true),
 77 |             $rawData['TradeInfo'],
 78 |             $rawData['TradeSha']
 79 |         );
 80 | 
 81 |         return $this;
 82 |     }
 83 | 
 84 |     /**
 85 |      * 用來確認藍新通知的資料是否真的屬於此商城
 86 |      * @return bool
 87 |      */
 88 |     public function validateResponse()
 89 |     {
 90 |         if (! $this->response) {
 91 |             throw new \LogicException('set rawData first');
 92 |         }
 93 | 
 94 |         return $this->response->getTradeSha() === $this->countTradeSha($this->response->getTradeInfo());
 95 |     }
 96 | 
 97 |     /**
 98 |      * @return string
 99 |      */
100 |     public function getId()
101 |     {
102 |         return $this->id;
103 |     }
104 | 
105 |     /**
106 |      * @return string
107 |      */
108 |     public function getHashKey(): string
109 |     {
110 |         return $this->hashKey;
111 |     }
112 | 
113 |     /**
114 |      * @return string
115 |      */
116 |     public function getHashIv()
117 |     {
118 |         return $this->hashIv;
119 |     }
120 | 
121 |     /**
122 |      * @return Response
123 |      */
124 |     public function getResponse()
125 |     {
126 |         return $this->response;
127 |     }
128 | }
129 | 


--------------------------------------------------------------------------------
/Cryption.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace fall1600\Package\Newebpay;
  4 | 
  5 | use fall1600\Package\Newebpay\Constants\Cipher;
  6 | use fall1600\Package\Newebpay\Contracts\InfoInterface;
  7 | use fall1600\Package\Newebpay\Exceptions\TradeInfoException;
  8 | 
  9 | trait Cryption
 10 | {
 11 |     protected $hashKey;
 12 | 
 13 |     protected $hashIv;
 14 | 
 15 |     /**
 16 |      * @param InfoInterface $info
 17 |      * @return string
 18 |      */
 19 |     public function countTradeInfo(InfoInterface $info)
 20 |     {
 21 |         $infoPayload = $info->getInfo();
 22 | 
 23 |         return $this->createEncryptedStr($infoPayload);
 24 |     }
 25 | 
 26 |     /**
 27 |      * @param string $tradeInfo
 28 |      * @return string
 29 |      */
 30 |     public function countTradeSha(string $tradeInfo)
 31 |     {
 32 |         if (! $tradeInfo) {
 33 |             throw new \LogicException('empty trade info');
 34 |         }
 35 | 
 36 |         return strtoupper(
 37 |             hash(
 38 |                 "sha256",
 39 |                 "HashKey={$this->hashKey}&{$tradeInfo}&HashIV={$this->hashIv}"
 40 |             )
 41 |         );
 42 |     }
 43 | 
 44 |     /**
 45 |      * @return string
 46 |      */
 47 |     public function getHashKey()
 48 |     {
 49 |         return $this->hashKey;
 50 |     }
 51 | 
 52 |     /**
 53 |      * @return string
 54 |      */
 55 |     public function getHashIv()
 56 |     {
 57 |         return $this->hashIv;
 58 |     }
 59 | 
 60 |     public function createEncryptedStr(array $infoPayload = [])
 61 |     {
 62 |         return trim(
 63 |             bin2hex(
 64 |                 openssl_encrypt(
 65 |                     $this->addPadding(http_build_query($infoPayload)),
 66 |                     Cipher::METHOD,
 67 |                     $this->hashKey,
 68 |                     OPENSSL_RAW_DATA|OPENSSL_ZERO_PADDING,
 69 |                     $this->hashIv
 70 |                 )
 71 |             )
 72 |         );
 73 |     }
 74 | 
 75 |     /**
 76 |      * 從藍新回傳的加密交易資訊解成可讀的字串
 77 |      * @param string $tradeInfo
 78 |      * @return string
 79 |      * @throws TradeInfoException
 80 |      */
 81 |     public function decryptTradeInfo(string $tradeInfo)
 82 |     {
 83 |         if (! $tradeInfo) {
 84 |             throw new \LogicException('empty trade info');
 85 |         }
 86 | 
 87 |         return $this->stripPadding(
 88 |             openssl_decrypt(
 89 |                 hex2bin($tradeInfo),
 90 |                 Cipher::METHOD,
 91 |                 $this->hashKey,
 92 |                 OPENSSL_RAW_DATA|OPENSSL_ZERO_PADDING,
 93 |                 $this->hashIv
 94 |             )
 95 |         );
 96 |     }
 97 | 
 98 |     protected function addPadding(string $string, int $blockSize = 32)
 99 |     {
100 |         $len = strlen($string);
101 |         $pad = $blockSize - ($len % $blockSize);
102 |         $string .= str_repeat(chr($pad), $pad);
103 |         return $string;
104 |     }
105 | 
106 |     /**
107 |      * @param $string
108 |      * @return string
109 |      * @throws TradeInfoException
110 |      */
111 |     protected function stripPadding($string)
112 |     {
113 |         $slast = ord(substr($string, -1));
114 |         $slastc = chr($slast);
115 |         $pcheck = substr($string, -$slast);
116 |         if (preg_match("/$slastc{" . $slast . "}/", $string)) {
117 |             $string = substr($string, 0, strlen($string) - $slast);
118 |             return $string;
119 |         }
120 | 
121 |         throw new TradeInfoException();
122 |     }
123 | }
124 | 


--------------------------------------------------------------------------------
/Response.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace fall1600\Package\Newebpay;
  4 | 
  5 | class Response
  6 | {
  7 |     /** @var array */
  8 |     protected $data;
  9 | 
 10 |     /** @var string */
 11 |     protected $tradeInfo;
 12 | 
 13 |     /** @var string */
 14 |     protected $tradeSha;
 15 | 
 16 |     /**
 17 |      * 注入藍新來的回傳值
 18 |      * @param array $data
 19 |      * @param string $tradeInfo
 20 |      * @param string $tradeSha
 21 |      */
 22 |     public function __construct(array $data, string $tradeInfo, string $tradeSha)
 23 |     {
 24 |         $this->data = $data;
 25 | 
 26 |         $this->tradeInfo = $tradeInfo;
 27 | 
 28 |         $this->tradeSha = $tradeSha;
 29 |     }
 30 | 
 31 |     /**
 32 |      * 回傳狀態
 33 |      *   成功: SUCCESS
 34 |      *   失敗: 錯誤代碼
 35 |      * @return string
 36 |      */
 37 |     public function getStatus()
 38 |     {
 39 |         return $this->data['Status'];
 40 |     }
 41 | 
 42 |     /**
 43 |      * 回傳訊息
 44 |      * @return string
 45 |      */
 46 |     public function getMessage()
 47 |     {
 48 |         return $this->data['Message'];
 49 |     }
 50 | 
 51 |     /**
 52 |      * 回傳參數細節
 53 |      * @return array
 54 |      */
 55 |     public function getResult()
 56 |     {
 57 |         return $this->data['Result'];
 58 |     }
 59 | 
 60 |     /**
 61 |      * 商城代號
 62 |      * @return string|null
 63 |      */
 64 |     public function getMerchantId()
 65 |     {
 66 |         return $this->data['Result']['MerchantID'] ?? null;
 67 |     }
 68 | 
 69 |     /**
 70 |      * 交易金額
 71 |      * @return int|null
 72 |      */
 73 |     public function getAmt()
 74 |     {
 75 |         return ((int) $this->data['Result']['Amt']) ?? null;
 76 |     }
 77 | 
 78 |     /**
 79 |      * 交易序號
 80 |      * @return string|null
 81 |      */
 82 |     public function getTradeNo()
 83 |     {
 84 |         return $this->data['Result']['TradeNo'] ?? null;
 85 |     }
 86 | 
 87 |     /**
 88 |      * 用來跟藍新溝通的訂單編號, 也就是OrderInterface 提供的MerchantOrderNo
 89 |      * @return string|null
 90 |      */
 91 |     public function getMerchantOrderNo()
 92 |     {
 93 |         return $this->data['Result']['MerchantOrderNo'] ?? null;
 94 |     }
 95 | 
 96 |     /**
 97 |      * 付款方式
 98 |      * @return string|null
 99 |      */
100 |     public function getPaymentType()
101 |     {
102 |         return $this->data['Result']['PaymentType'] ?? null;
103 |     }
104 | 
105 |     public function getResponseType()
106 |     {
107 |         return $this->data['Result']['ResponseType'] ?? null;
108 |     }
109 | 
110 |     /**
111 |      * 付款完成時間
112 |      * @return string|null
113 |      */
114 |     public function getPayTime()
115 |     {
116 |         return $this->data['Result']['PayTime'] ?? null;
117 |     }
118 | 
119 |     /**
120 |      * 付款人取號或交易時的ip
121 |      * @return string|null
122 |      */
123 |     public function getIp()
124 |     {
125 |         return $this->data['Result']['IP'] ?? null;
126 |     }
127 | 
128 |     /**
129 |      * 款項保管銀行
130 |      * @return string|null
131 |      */
132 |     public function getEscrowBank()
133 |     {
134 |         return $this->data['Result']['EscrowBank'] ?? null;
135 |     }
136 | 
137 |     /**
138 |      * 離線金流會帶繳費到期日回來, 格式: yyyy-mm-dd
139 |      * @return string|null
140 |      */
141 |     public function getExpireDate()
142 |     {
143 |         return $this->data['Result']['ExpireDate'] ?? null;
144 |     }
145 | 
146 |     /**
147 |      * @return string
148 |      */
149 |     public function getTradeInfo()
150 |     {
151 |         return $this->tradeInfo;
152 |     }
153 | 
154 |     /**
155 |      * @return string
156 |      */
157 |     public function getTradeSha()
158 |     {
159 |         return $this->tradeSha;
160 |     }
161 | 
162 |     /**
163 |      * @return array
164 |      */
165 |     public function getData()
166 |     {
167 |         return $this->data;
168 |     }
169 | }
170 | 


--------------------------------------------------------------------------------
/Tests/InfoTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace fall1600\Package\Newebpay\Tests;
  4 | 
  5 | use fall1600\Package\Newebpay\Constants\LanguageType;
  6 | use fall1600\Package\Newebpay\Contracts\OrderInterface;
  7 | use fall1600\Package\Newebpay\Contracts\PayerInterface;
  8 | use fall1600\Package\Newebpay\Info\Decorator\Language;
  9 | use fall1600\Package\Newebpay\Info\Decorator\OfflinePay;
 10 | use fall1600\Package\Newebpay\Info\Decorator\PayComplete;
 11 | use fall1600\Package\Newebpay\Info\Decorator\PayerEmailEditable;
 12 | use fall1600\Package\Newebpay\Info\BasicInfo;
 13 | use fall1600\Package\Newebpay\Info\Decorator\PayCancel;
 14 | use fall1600\Package\Newebpay\Merchant;
 15 | use fall1600\Package\Newebpay\NewebPay;
 16 | use PHPUnit\Framework\TestCase;
 17 | 
 18 | class InfoTest extends TestCase
 19 | {
 20 |     public function test_info()
 21 |     {
 22 |         //arrange
 23 |         $merchant = new Merchant('merchant.id.123','hash.key.123','hash.iv.4567890');
 24 | 
 25 |         $returnUrl= 'return.url';
 26 | 
 27 |         $notifyUrl = 'notify.url';
 28 | 
 29 |         $clientBackUrl = 'client.back.url';
 30 | 
 31 |         $order = $this->getMockBuilder(OrderInterface::class)
 32 |             ->getMock();
 33 | 
 34 |         $order->expects($this->once())
 35 |             ->method('getMerchantOrderNo')
 36 |             ->willReturn($orderMerchantNo = (string) time());
 37 | 
 38 |         $order->expects($this->once())
 39 |             ->method('getItemDesc')
 40 |             ->willReturn($itemDesc = 'This is an apple');
 41 | 
 42 |         $order->expects($this->once())
 43 |             ->method('getAmt')
 44 |             ->willReturn($amt = 100);
 45 | 
 46 |         $payer = $this->getMockBuilder(PayerInterface::class)
 47 |             ->getMock();
 48 | 
 49 |         $payer->expects($this->once())
 50 |             ->method('getEmail')
 51 |             ->willReturn($email = 'foobar@gg.cc');
 52 | 
 53 |         $payer->expects($this->once())
 54 |             ->method('getLoginType')
 55 |             ->willReturn($loginType = false);
 56 | 
 57 |         $ttl = 3;
 58 | 
 59 |         $customerUrl = 'customer.url';
 60 | 
 61 |         //act
 62 |         $info =
 63 |             new PayComplete(
 64 |                 new OfflinePay(
 65 |                     new PayCancel(
 66 |                         new Language(
 67 |                             new PayerEmailEditable(
 68 |                                 new BasicInfo($merchant->getId(), $notifyUrl, $order, $payer),
 69 |                                 $email
 70 |                             ),
 71 |                             $lang = LanguageType::EN
 72 |                         ),
 73 |                         $clientBackUrl
 74 |                     ),
 75 |                     $customerUrl,
 76 |                     $ttl
 77 |                 ),
 78 |                 $returnUrl
 79 |             )
 80 |         ;
 81 |         $result = $info->getInfo();
 82 | 
 83 |         //assert
 84 |         $this->assertArrayHasKey('MerchantID', $result);
 85 |         $this->assertEquals($merchant->getId(), $result['MerchantID']);
 86 | 
 87 |         $this->assertArrayHasKey('RespondType', $result);
 88 |         $this->assertEquals('JSON', $result['RespondType']);
 89 | 
 90 |         $this->assertArrayHasKey('TimeStamp', $result);
 91 | 
 92 |         $this->assertArrayHasKey('Version', $result);
 93 |         $this->assertEquals(NewebPay::VERSION, $result['Version']);
 94 | 
 95 |         $this->assertArrayHasKey('NotifyURL', $result);
 96 |         $this->assertEquals($notifyUrl, $result['NotifyURL']);
 97 | 
 98 |         $this->assertArrayHasKey('Amt', $result);
 99 |         $this->assertEquals($amt, $result['Amt']);
100 | 
101 |         $this->assertArrayHasKey('ItemDesc', $result);
102 |         $this->assertEquals($itemDesc, $result['ItemDesc']);
103 | 
104 |         $this->assertArrayHasKey('MerchantOrderNo', $result);
105 |         $this->assertEquals($orderMerchantNo, $result['MerchantOrderNo']);
106 | 
107 |         $this->assertArrayHasKey('Email', $result);
108 |         $this->assertEquals($email, $result['Email']);
109 | 
110 |         $this->assertArrayHasKey('LoginType', $result);
111 |         $this->assertEquals($loginType, $result['LoginType']);
112 | 
113 |         $this->assertArrayHasKey('EmailModify', $result);
114 |         $this->assertEquals(1, $result['EmailModify']);
115 | 
116 |         $this->assertArrayHasKey('LangType', $result);
117 |         $this->assertEquals($lang, $result['LangType']);
118 | 
119 |         $this->assertArrayHasKey('ClientBackURL', $result);
120 |         $this->assertEquals($clientBackUrl, $result['ClientBackURL']);
121 | 
122 |         $this->assertArrayHasKey('ExpireDate', $result);
123 | 
124 |         $this->assertArrayHasKey('CustomerURL', $result);
125 |         $this->assertEquals($customerUrl, $result['CustomerURL']);
126 | 
127 |         $this->assertArrayHasKey('ReturnURL', $result);
128 |         $this->assertEquals($returnUrl, $result['ReturnURL']);
129 |     }
130 | }
131 | 


--------------------------------------------------------------------------------
/Tests/NewebPayTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace fall1600\Package\Newebpay\Tests;
  4 | 
  5 | use fall1600\Package\Newebpay\Constants\LanguageType;
  6 | use fall1600\Package\Newebpay\Contracts\OrderInterface;
  7 | use fall1600\Package\Newebpay\Contracts\PayerInterface;
  8 | use fall1600\Package\Newebpay\Info\BasicInfo;
  9 | use fall1600\Package\Newebpay\Info\Decorator\Language;
 10 | use fall1600\Package\Newebpay\Info\Decorator\OfflinePay;
 11 | use fall1600\Package\Newebpay\Info\Decorator\PayCancel;
 12 | use fall1600\Package\Newebpay\Info\Decorator\PayComplete;
 13 | use fall1600\Package\Newebpay\Info\Decorator\PayerEmailEditable;
 14 | use fall1600\Package\Newebpay\Merchant;
 15 | use fall1600\Package\Newebpay\NewebPay;
 16 | use PHPUnit\Framework\TestCase;
 17 | 
 18 | class NewebPayTest extends TestCase
 19 | {
 20 |     public function test_sendTransaction()
 21 |     {
 22 |         //arrange
 23 |         $newebpay = new NewebPay();
 24 | 
 25 |         $merchantId = 'merchant.id.123';
 26 | 
 27 |         $hashKey = 'hash.key.234';
 28 | 
 29 |         $hashIv = 'hash.iv.34567890';
 30 | 
 31 | //        $merchant = new Merchant($merchantId, $hashKey, $hashIv);
 32 | 
 33 |         $merchant = $this->getMockBuilder(Merchant::class)
 34 |             ->disableOriginalConstructor()
 35 |             ->getMock();
 36 | 
 37 |         $merchant->expects($this->atLeastOnce())
 38 |             ->method('getId')
 39 |             ->willReturn($merchantId);
 40 | 
 41 |         $merchant->expects($this->once())
 42 |             ->method('countTradeInfo')
 43 |             ->willReturn($tradeInfo = '12345');
 44 | 
 45 |         $merchant->expects($this->once())
 46 |             ->method('countTradeSha')
 47 |             ->willReturn($tradeSha = '22345');
 48 | 
 49 |         $email = 'test@gg.cc';
 50 | 
 51 |         $returnUrl= 'return.url';
 52 | 
 53 |         $notifyUrl = 'notify.url';
 54 | 
 55 |         $clientBackUrl = 'client.back.url';
 56 | 
 57 |         $order = $this->getMockBuilder(OrderInterface::class)
 58 |             ->getMock();
 59 | 
 60 |         $payer = $this->getMockBuilder(PayerInterface::class)
 61 |             ->getMock();
 62 | 
 63 |         $ttl = 3;
 64 | 
 65 |         $customerUrl = 'customer.url';
 66 | 
 67 |         $info = new BasicInfo($merchant->getId(), $notifyUrl, $order, $payer);
 68 |         $info = new PayerEmailEditable($info, $email);
 69 |         $info = new Language($info, LanguageType::EN);
 70 |         $info = new PayCancel($info, $clientBackUrl);
 71 |         $info = new OfflinePay($info, $customerUrl, $ttl);
 72 |         $info = new PayComplete($info, $returnUrl);
 73 | 
 74 |         $expected = <<<EOT
 75 |         <form name="newebpay" id="newebpay-form" method="post" action="https://ccore.newebpay.com/MPG/mpg_gateway" style="display:none;">
 76 |             <input type="text" name="MerchantID" value="{$merchantId}" type="hidden"/>
 77 |             <input type="text" name="TradeInfo" value="{$tradeInfo}" type="hidden"/>
 78 |             <input type="text" name="TradeSha" value="{$tradeSha}" type="hidden"/>
 79 |             <input type="text" name="Version" value="1.5" type="hidden"/>
 80 |         </form>
 81 |         EOT;
 82 | 
 83 | 
 84 |         //act
 85 |         $result = $newebpay
 86 |             ->setIsProduction(false)
 87 |             ->setMerchant($merchant)
 88 |             ->generateForm($info);
 89 | 
 90 |         //assert
 91 |         $this->assertEquals($expected, $result);
 92 |     }
 93 | 
 94 |     public function test_checkoutByApi()
 95 |     {
 96 |         //arrange
 97 |         $newebpay = new NewebPay();
 98 | 
 99 |         $merchantId = 'merchant.id.123';
100 | 
101 |         $hashKey = 'hash.key.234';
102 | 
103 |         $hashIv = 'hash.iv.34567890';
104 | 
105 | //        $merchant = new Merchant($merchantId, $hashKey, $hashIv);
106 | 
107 |         $merchant = $this->getMockBuilder(Merchant::class)
108 |             ->disableOriginalConstructor()
109 |             ->getMock();
110 | 
111 |         $merchant->expects($this->atLeastOnce())
112 |             ->method('getId')
113 |             ->willReturn($merchantId);
114 | 
115 |         $merchant->expects($this->once())
116 |             ->method('countTradeInfo')
117 |             ->willReturn($tradeInfo = '12345');
118 | 
119 |         $merchant->expects($this->once())
120 |             ->method('countTradeSha')
121 |             ->willReturn($tradeSha = '22345');
122 | 
123 |         $email = 'test@gg.cc';
124 | 
125 |         $returnUrl= 'return.url';
126 | 
127 |         $notifyUrl = 'notify.url';
128 | 
129 |         $clientBackUrl = 'client.back.url';
130 | 
131 |         $order = $this->getMockBuilder(OrderInterface::class)
132 |             ->getMock();
133 | 
134 |         $payer = $this->getMockBuilder(PayerInterface::class)
135 |             ->getMock();
136 | 
137 |         $ttl = 3;
138 | 
139 |         $customerUrl = 'customer.url';
140 | 
141 |         $info = new BasicInfo($merchant->getId(), $notifyUrl, $order, $payer);
142 |         $info = new PayerEmailEditable($info, $email);
143 |         $info = new Language($info, LanguageType::EN);
144 |         $info = new PayCancel($info, $clientBackUrl);
145 |         $info = new OfflinePay($info, $customerUrl, $ttl);
146 |         $info = new PayComplete($info, $returnUrl);
147 | 
148 |         $expected = [
149 |             'url' => 'https://ccore.newebpay.com/MPG/mpg_gateway',
150 |             'form_params' => [
151 |                 'MerchantID' => $merchantId,
152 |                 'TradeInfo' => $tradeInfo,
153 |                 'TradeSha' => $tradeSha,
154 |                 'Version' => '1.5',
155 |             ],
156 |         ];
157 | 
158 |         //act
159 |         $result = $newebpay
160 |             ->setIsProduction(false)
161 |             ->setMerchant($merchant)
162 |             ->checkoutForApi($info);
163 | 
164 |         //assert
165 |         $this->assertEquals($expected, $result);
166 | 
167 |     }
168 | }
169 | 


--------------------------------------------------------------------------------
/Tests/AliPayInfoTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace fall1600\Package\Newebpay\Tests;
  4 | 
  5 | use fall1600\Package\Newebpay\Contracts\AliPayPayerInterface;
  6 | use fall1600\Package\Newebpay\Contracts\AliPayProductInterface;
  7 | use fall1600\Package\Newebpay\Contracts\OrderInterface;
  8 | use fall1600\Package\Newebpay\Info\AliPayBasicInfo;
  9 | use fall1600\Package\Newebpay\Info\Decorator\EnableAliPay;
 10 | use fall1600\Package\Newebpay\Info\Decorator\AliPayProduct;
 11 | use fall1600\Package\Newebpay\Info\Decorator\EnableCredit;
 12 | use fall1600\Package\Newebpay\Merchant;
 13 | use fall1600\Package\Newebpay\NewebPay;
 14 | use PHPUnit\Framework\TestCase;
 15 | 
 16 | class AliPayInfoTest extends TestCase
 17 | {
 18 |     public function test_getInfo()
 19 |     {
 20 |         //arrange
 21 |         $order = $this->getMockBuilder(OrderInterface::class)
 22 |             ->getMock();
 23 | 
 24 |         $order->expects($this->once())
 25 |             ->method('getMerchantOrderNo')
 26 |             ->willReturn($orderMerchantNo = (string) time());
 27 | 
 28 |         $order->expects($this->once())
 29 |             ->method('getItemDesc')
 30 |             ->willReturn($itemDesc = 'This is an apple');
 31 | 
 32 |         $order->expects($this->once())
 33 |             ->method('getAmt')
 34 |             ->willReturn($amt = 100);
 35 | 
 36 |         $payer = $this->getMockBuilder(AliPayPayerInterface::class)
 37 |             ->getMock();
 38 | 
 39 |         $payer->expects($this->once())
 40 |             ->method('getEmail')
 41 |             ->willReturn($email = 'foobar@gg.cc');
 42 | 
 43 |         $payer->expects($this->once())
 44 |             ->method('getLoginType')
 45 |             ->willReturn($loginType = false);
 46 | 
 47 |         $payer->expects($this->once())
 48 |             ->method('getReceiver')
 49 |             ->willReturn('foobar');
 50 | 
 51 |         $payer->expects($this->once())
 52 |             ->method('getTel1')
 53 |             ->willReturn('0988999000');
 54 | 
 55 |         $payer->expects($this->once())
 56 |             ->method('getTel2')
 57 |             ->willReturn('0988777666');
 58 | 
 59 |         $merchantId = 'merchant.id.223';
 60 | 
 61 |         $merchant = new Merchant($merchantId, $hashKey = 'hash.key.123', $hashIv = 'hash.iv.4567890');
 62 | 
 63 |         $notifyUrl = 'notify.url';
 64 | 
 65 |         $count = 3;
 66 | 
 67 |         $product1 = $this->getMockBuilder(AliPayProductInterface::class)
 68 |             ->getMock();
 69 | 
 70 |         $product1->expects($this->once())
 71 |             ->method('getProductId')
 72 |             ->willReturn($p1id = time());
 73 | 
 74 |         $product1->expects($this->once())
 75 |             ->method('getTitle')
 76 |             ->willReturn($p1title = 'title1');
 77 | 
 78 |         $product1->expects($this->once())
 79 |             ->method('getDescription')
 80 |             ->willReturn($p1desc = '<div>this is a big apple</div>');
 81 | 
 82 |         $product1->expects($this->once())
 83 |             ->method('getPrice')
 84 |             ->willReturn($p1price = 100);
 85 | 
 86 |         $product1->expects($this->once())
 87 |             ->method('getQuantity')
 88 |             ->willReturn($p1qty = 2);
 89 | 
 90 |         $product2 = $this->getMockBuilder(AliPayProductInterface::class)
 91 |             ->getMock();
 92 | 
 93 |         $product2->expects($this->once())
 94 |             ->method('getProductId')
 95 |             ->willReturn($p2id = time());
 96 | 
 97 |         $product2->expects($this->once())
 98 |             ->method('getTitle')
 99 |             ->willReturn($p2title = 'title2');
100 | 
101 |         $product2->expects($this->once())
102 |             ->method('getDescription')
103 |             ->willReturn($p2desc = '<div>this is a big camera</div>');
104 | 
105 |         $product2->expects($this->once())
106 |             ->method('getPrice')
107 |             ->willReturn($p2price = 1000);
108 | 
109 |         $product2->expects($this->once())
110 |             ->method('getQuantity')
111 |             ->willReturn($p2qty = 1);
112 | 
113 |         //act
114 |         $info = new AliPayBasicInfo($merchant->getId(), $notifyUrl, $order, $payer, $count);
115 |         $info = new AliPayProduct($info, 1, $product1);
116 |         $info = new AliPayProduct($info, 2, $product2);
117 |         $info = new EnableAliPay($info);
118 |         $info = new EnableCredit($info);
119 |         $result = $info->getInfo();
120 | 
121 |         //assert
122 |         $this->assertArrayHasKey('MerchantID', $result);
123 |         $this->assertEquals($merchantId, $result['MerchantID']);
124 | 
125 |         $this->assertArrayHasKey('RespondType', $result);
126 |         $this->assertEquals('JSON', $result['RespondType']);
127 | 
128 |         $this->assertArrayHasKey('TimeStamp', $result);
129 | 
130 |         $this->assertArrayHasKey('Version', $result);
131 |         $this->assertEquals(NewebPay::VERSION, $result['Version']);
132 | 
133 |         $this->assertArrayHasKey('NotifyURL', $result);
134 |         $this->assertEquals($notifyUrl, $result['NotifyURL']);
135 | 
136 |         $this->assertArrayHasKey('Amt', $result);
137 |         $this->assertEquals($amt, $result['Amt']);
138 | 
139 |         $this->assertArrayHasKey('ItemDesc', $result);
140 |         $this->assertEquals($itemDesc, $result['ItemDesc']);
141 | 
142 |         $this->assertArrayHasKey('MerchantOrderNo', $result);
143 |         $this->assertEquals($orderMerchantNo, $result['MerchantOrderNo']);
144 | 
145 |         $this->assertArrayHasKey('Email', $result);
146 |         $this->assertEquals($email, $result['Email']);
147 | 
148 |         $this->assertArrayHasKey('LoginType', $result);
149 |         $this->assertEquals($loginType, $result['LoginType']);
150 | 
151 |         $this->assertArrayHasKey('Pid1', $result);
152 |         $this->assertEquals($p1id, $result['Pid1']);
153 | 
154 |         $this->assertArrayHasKey('Title1', $result);
155 |         $this->assertEquals($p1title, $result['Title1']);
156 | 
157 |         $this->assertArrayHasKey('Desc1', $result);
158 |         $this->assertEquals($p1desc, $result['Desc1']);
159 | 
160 |         $this->assertArrayHasKey('Price1', $result);
161 |         $this->assertEquals($p1price, $result['Price1']);
162 | 
163 |         $this->assertArrayHasKey('Qty1', $result);
164 |         $this->assertEquals($p1qty, $result['Qty1']);
165 | 
166 |         $this->assertArrayHasKey('Pid2', $result);
167 |         $this->assertEquals($p2id, $result['Pid2']);
168 | 
169 |         $this->assertArrayHasKey('Title2', $result);
170 |         $this->assertEquals($p2title, $result['Title2']);
171 | 
172 |         $this->assertArrayHasKey('Desc2', $result);
173 |         $this->assertEquals($p2desc, $result['Desc2']);
174 | 
175 |         $this->assertArrayHasKey('Price2', $result);
176 |         $this->assertEquals($p2price, $result['Price2']);
177 | 
178 |         $this->assertArrayHasKey('Qty2', $result);
179 |         $this->assertEquals($p2qty, $result['Qty2']);
180 |     }
181 | }
182 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # Newebpay 藍新金流
  2 | 
  3 | 程式版本 1.5 <br>
  4 | 文件版本 1.0.4 <br>
  5 | [Official Doc](https://www.newebpay.com/website/Page/content/download_api#1)
  6 | 
  7 | ## feature
  8 | 
  9 | - [x] 多功能收款 MPG
 10 | - [x] 單筆交易狀態查詢
 11 | - [ ] 信用卡取消授權
 12 | - [ ] 信用卡請退款
 13 | - [x] 信用卡定期定額
 14 | 
 15 | ## How to use
 16 | 
 17 | ### 信用卡定期定額
 18 | 
 19 | #### 建立交易資訊 (BasicInfo)
 20 |  - $order: 你的訂單物件, 務必實作package 中的OrderInterface
 21 |  - $contact: 你的付款人物件, 務必實作package 中的ContactInterface
 22 |  - $periodStartType: 檢查卡號模式, 參閱文件p.13
 23 |  - $version: 串接程式版本
 24 |     - 帶入 1.0 版本,則[背面末三碼]將為必填欄位
 25 |     - 帶入 1.1 版本,則[背面末三碼]將為非必填
 26 | ```php
 27 | $info = new \fall1600\Package\Newebpay\Info\Period\BasicInfo($order, $payer, $periodStartType, $version);
 28 | ```
 29 | 
 30 | #### 選填參數
 31 | 
 32 | ```php
 33 | 
 34 | $info = new ReturnUrl($info, 'https://your.return.url');
 35 | $info = new NotifyUrl($info, 'https://your.notify.url');
 36 | $info = new BackUrl($info, 'https://your.back.url');
 37 | $info = new Memo($info, 'your memo here');
 38 | ```
 39 | 
 40 | #### 建立NewebPay 物件, 注入商店資訊, 帶著交易資訊前往藍新申請定期定額
 41 |  - $merchantId: 你在藍新商店代號
 42 |  - $hashKey: 你在藍新商店專屬的HashKey
 43 |  - $hashIv: 你在藍新商店專屬的HashIV
 44 | 
 45 | ```php
 46 | $newebpay = new NewebPay();
 47 | $newebpay
 48 |     ->setIsProduction(false) // 設定環境, 預設就是走正式機
 49 |     ->setMerchant(new Merchant($merchantId, $hashKey, $hashIv))
 50 |     ->issue($info);
 51 | ```
 52 | 
 53 | #### 請在你的訂單物件實作 OrderInterface
 54 | 
 55 | ```php
 56 | <?php
 57 | 
 58 | namespace Your\Namespace;
 59 | 
 60 | use fall1600\Package\Newebpay\Contracts\Period\OrderInterface;
 61 | 
 62 | class Order implements OrderInterface
 63 | {
 64 |     // your order detail...
 65 | }
 66 | ```
 67 | 
 68 | #### 請在你的付款人(假設是Member), 實作ContactInterface
 69 | 
 70 | ```php
 71 | <?php
 72 | 
 73 | namespace Your\Namespace;
 74 | 
 75 | use fall1600\Package\Newebpay\Contracts\Period\ContactInterface;
 76 | 
 77 | class Member implements ContactInterface
 78 | {
 79 |     // your member detail...
 80 | }
 81 | ```
 82 | 
 83 | #### 各種url 你分的清楚嗎?
 84 | | Name             | 用途                                  | 設定的物件    |    備註                                                   |
 85 | |:-----------------|:------------------------------------ |:-------------|:---------------------------------------------------------|
 86 | | ReturnURL        | 首次信用卡授權完成後要回到你系統的位置      | ReturnUrl    | 沒設定就是顯示在藍新   |
 87 | | NotifyURL        | 每期授權結果通知                        | NotifyUrl    | 每期執行信用卡授權交易完成後, 以Post 方式通知商店授權結果; 若此欄位為空值,程式則將不通知  |
 88 | | BackURL          | 取消交易時返回商店的網址                  | BackUrl      | 沒設定就是顯示在藍新                                        |
 89 | 
 90 | 
 91 | <hr>
 92 | 
 93 | ### 多功能收款
 94 | 
 95 | #### 建立交易資訊 (BasicInfo)
 96 |  - $merchantId: 你在藍新申請的商店代號
 97 |  - $notifyUrl: 用來接收藍新付款通知的callback url
 98 |  - $order: 你的訂單物件, 務必實作package 中的OrderInterface
 99 |  - $payer: 你的付款人物件, 務必實作package 中的PayerInterface 
100 |  
101 | ```php
102 | $info = new BasicInfo($merchantId, $notifyUrl, $order, $payer);
103 | ```
104 | 
105 | #### 依場景開啟各種付款方式, 有需要再啟用即可
106 | ```php
107 | // 啟用信用卡
108 | $info = new EnableCredit($info);
109 | // 啟用3, 6, 12 期分期付款
110 | $info = new PayInInstallments($info, '3,6,12');
111 | // 啟用超商條碼
112 | $info = new EnableBarcode($info);
113 | // 啟用Google Pay
114 | $info = new EnableGooglePay($info);
115 | // 啟用Web ATM
116 | $info = new EnableWebAtm($info);
117 | // 搭配非即時交易, 設定藍新通知付款資訊的callback url, 以及繳費期限
118 | $info = new OfflinePay($info, $customerUrl, $ttl);
119 | // 在藍新交易完成後導回的網址
120 | $info = new PayComplete($info, $returnUrl);
121 | // 設定讓消費者在付款頁按下返回時可以回導的頁面
122 | $info = new PayCancel($info, $clientBackUrl);
123 | 
124 | // 文件末有付款方式對應表
125 | ```
126 | 
127 | #### 建立NewebPay 物件, 注入商店資訊, 帶著交易資訊前往藍新付款
128 |  - $merchantId: 你在藍新商店代號
129 |  - $hashKey: 你在藍新商店專屬的HashKey
130 |  - $hashIv: 你在藍新商店專屬的HashIV
131 |  
132 | ```php
133 | $newebpay = new NewebPay();
134 | $newebpay
135 |     ->setIsProduction(false) // 設定環境, 預設就是走正式機
136 |     ->setMerchant(new Merchant($merchantId, $hashKey, $hashIv))
137 |     ->checkout($info);
138 | ```
139 | 
140 | #### 請在你的訂單物件實作 OrderInterface
141 | 
142 | ```php
143 | <?php
144 | 
145 | namespace Your\Namespace;
146 | 
147 | use fall1600\Package\Newebpay\Contracts\OrderInterface;
148 | 
149 | class Order implements OrderInterface
150 | {
151 |     // your order detail...
152 | }
153 | 
154 | ```
155 | 
156 | #### 請在你的付款人(假設是Member), 實作PayerInterface
157 | 
158 | ```php
159 | <?php
160 | 
161 | namespace Your\Namespace;
162 | 
163 | use fall1600\Package\Newebpay\Contracts\PayerInterface;
164 | 
165 | class Member implements PayerInterface
166 | {
167 |     // your member detail...
168 | }
169 | ```
170 | 
171 | #### 解開來自藍新的交易通知
172 | ```php
173 | $isValid = $merchant->setRawData($request->all())->validateResponse(); //確認為true 後再往下走
174 | 
175 | // response 封裝了通知交易的結果, 以下僅列常用methods
176 | $response = $merchant->getResponse();
177 | // 付款成敗
178 | $response->getStatus();
179 | // 取得交易序號
180 | $response->getTradeNo();
181 | // 取得訂單編號, 就是OrderInterface 實作的getMerchantOrderNo
182 | $response->getMerchantOrderNo();
183 | // 付款時間
184 | $response->getPayTime();
185 | ```
186 | 
187 | #### 支付寶 (AliPay)
188 | 
189 | 支付寶付款需提供的參數更多
190 | 
191 | - $payer: 你的付款人物件, 務必實作package 中的AliPayPayerInterface
192 | - $numberOfProducts: 此訂單的品項數量(integer)
193 | - $product1: 第一個品項(實作AliPayProductInterface)
194 | - $product2: 第二個品項(實作AliPayProductInterface)
195 | 
196 | ```php
197 | $info = new AliPayBasicInfo($merchantId, $notifyUrl, $order, $payer, $numberOfProducts);
198 | $info = new EnableAliPay($info);
199 | 
200 | $info = new AliPayProduct($info, 1, $product1);
201 | $info = new AliPayProduct($info, 2, $product2);
202 | ```
203 | 
204 | #### 單筆交易查詢
205 | ```php
206 | $resp = $newebpay
207 |     ->setMerchant($merchant)
208 |     ->query($order);
209 | ```
210 | 
211 | 
212 | #### 各種url 你分的清楚嗎?
213 | | Name             | 用途                                  | 設定的物件    |    備註                                                   |
214 | |:-----------------|:------------------------------------ |:-------------|:---------------------------------------------------------|
215 | | NotifyURL        | 通知你系統交易資訊的callback url         | BasicInfo    | 通常用在訂單付款狀態切換, 最重要,所以BasicInfo 就要設定了   |
216 | | CustomerURL      | 離線付款取號完成通知你系統的callback url  | OfflinePay   | 用在紀錄離線付款的取號, 務必設定                            |
217 | | ReturnURL        | 付款完成後要回到你系統的位置              | PayComplete  | 沒設定就是顯示在藍新                                        |
218 | | ClientBackURL    | 交易取消時回到你系統的位置                | PayCancel    | 沒設定就是顯示在藍新                                        |
219 | 
220 | 
221 | #### 付款方式對應的物件
222 | 
223 | | Class             | 付款方式                  | 交易性質           |
224 | |:------------------|:------------------------|:------------------|
225 | | EnableCredit      | 信用卡(一次結清)           | 即時交易           |
226 | | EnableWebAtm      | WebATM                  | 即時交易            |
227 | | EnableVacc        | ATM 轉帳                 | 非即時交易          |
228 | | EnableCvs         | 超商代碼繳費              | 非即時交易          |
229 | | EnableBarcode     | 超商條碼繳費              | 非即時交易          |
230 | | EnableCvsCom      | 超商取貨付款              | 非即時交易          |
231 | | EnableAliPay      | 支付寶                   | 非即時交易          |
232 | | EnableEzPay       | ezPay 電子錢包            | 即時交易, 非即時交易 |
233 | | EnableLinePay     | LINE Pay                | 即時交易           |
234 | 
235 | 


--------------------------------------------------------------------------------
/NewebPay.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace fall1600\Package\Newebpay;
  4 | 
  5 | use fall1600\Package\Newebpay\Contracts\OrderInterface;
  6 | use fall1600\Package\Newebpay\Exceptions\TradeInfoException;
  7 | use fall1600\Package\Newebpay\Info\Info;
  8 | use fall1600\Package\Newebpay\Info\Period\Info as PeriodInfo;
  9 | 
 10 | class NewebPay
 11 | {
 12 |     /**
 13 |      * 藍新說是哪一版就是哪一版
 14 |      * @var string
 15 |      */
 16 |     public const VERSION = '1.5';
 17 | 
 18 |     /**
 19 |      * 付款-測試環境
 20 |      * @var string
 21 |      */
 22 |     public const CHECKOUT_URL_TEST = 'https://ccore.newebpay.com/MPG/mpg_gateway';
 23 | 
 24 |     /**
 25 |      * 付款-正式環境
 26 |      * @var string
 27 |      */
 28 |     public const CHECKOUT_URL_PRODUCTION = 'https://core.newebpay.com/MPG/mpg_gateway';
 29 | 
 30 |     /**
 31 |      * 查詢付款資訊-測試環境
 32 |      * @var string
 33 |      */
 34 |     public const QUERY_URL_TEST = 'https://ccore.newebpay.com/API/QueryTradeInfo';
 35 | 
 36 |     /**
 37 |      * 查詢付款資訊-正式環境
 38 |      * @var string
 39 |      */
 40 |     public const QUERY_URL_PRODUCTION = 'https://core.newebpay.com/API/QueryTradeInfo';
 41 | 
 42 |     /**
 43 |      * 建立定期定額委託單-測試環境
 44 |      * @var string
 45 |      */
 46 |     public const ISSUE_URL_TEST = 'https://ccore.newebpay.com/MPG/period';
 47 | 
 48 |     /**
 49 |      * 建立定期定額委託單-正式環境
 50 |      * @var string
 51 |      */
 52 |     public const ISSUE_URL_PRODUCTION = 'https://core.newebpay.com/MPG/period';
 53 | 
 54 |     /**
 55 |      * 修改已建立委託單狀態-測試環境
 56 |      * @var string
 57 |      */
 58 |     public const ALTER_STATUS_URL_TEST = 'https://ccore.newebpay.com/MPG/period/AlterStatus';
 59 | 
 60 |     /**
 61 |      * 修改已建立委託單狀態-正式環境
 62 |      * @var string
 63 |      */
 64 |     public const ALTER_STATUS_URL_PRODUCTION = 'https://core.newebpay.com/MPG/period/AlterStatus';
 65 | 
 66 |     /**
 67 |      * 修改已建立委託單內容-測試環境
 68 |      * @var string
 69 |      */
 70 |     public const ALTER_AMT_URL_TEST = 'https://ccore.newebpay.com/MPG/period/AlterAmt';
 71 | 
 72 |     /**
 73 |      * 修改已建立委託單內容-正式環境
 74 |      * @var string
 75 |      */
 76 |     public const ALTER_AMT_URL_PRODUCTION = 'https://core.newebpay.com/MPG/period/AlterAmt';
 77 | 
 78 |     /**
 79 |      * 決定URL 要使用正式或測試機
 80 |      * @var bool
 81 |      */
 82 |     protected $isProduction = true;
 83 | 
 84 |     /**
 85 |      * 送往藍新表單的id
 86 |      * @var string
 87 |      */
 88 |     protected $formId = 'newebpay-form';
 89 | 
 90 |     /** @var Merchant */
 91 |     protected $merchant;
 92 | 
 93 |     /**
 94 |      * aha: 雖然文件上 PeriodType(週期類別), PeriodPoint(交易週期授權時間) 標注選填, 但實際觸發發現是必填
 95 |      * @param string $orderNo 商店訂單編號
 96 |      * @param string $periodNo 委託單號
 97 |      * @param string $periodType 週期類別
 98 |      * @param string $periodPoint 交易週期授權時間
 99 |      * @param int|null $alterAmt 委託金額
100 |      * @return array
101 |      * @throws TradeInfoException
102 |      */
103 |     public function alterAmt(
104 |         string $orderNo,
105 |         string $periodNo,
106 |         string $periodType,
107 |         string $periodPoint,
108 |         int $alterAmt = null
109 |     ) {
110 |         if (! $this->merchant) {
111 |             throw new \LogicException('empty merchant');
112 |         }
113 | 
114 |         $url = $this->isProduction? static::ALTER_AMT_URL_PRODUCTION: static::ALTER_AMT_URL_TEST;
115 | 
116 |         $data = [
117 |             'RespondType' => 'JSON',
118 |             'Version' => '1.0',
119 |             'MerOrderNo' => $orderNo,
120 |             'PeriodNo' => $periodNo,
121 |             'TimeStamp' => time(),
122 |             'PeriodType' => $periodType,
123 |             'PeriodPoint' => $periodPoint,
124 |         ];
125 | 
126 |         if ($alterAmt) {
127 |             $data['AlterAmt'] = $alterAmt;
128 |         }
129 | 
130 |         $payload = [
131 |             'MerchantID_' => $this->merchant->getId(),
132 |             'PostData_' => $this->merchant->createEncryptedStr($data),
133 |         ];
134 | 
135 |         $resp = $this->post($url, $payload);
136 |         if (! isset($resp['period'])) {
137 |             throw new TradeInfoException("interface change from Newebpay");
138 |         }
139 | 
140 |         return json_decode($this->merchant->decryptTradeInfo($resp['period']), true);
141 |     }
142 | 
143 |     /**
144 |      * @param string $orderNo
145 |      * @param string $periodNo
146 |      * @param string $alterType
147 |      * @return array
148 |      * @throws TradeInfoException
149 |      */
150 |     public function alterStatus(string $orderNo, string $periodNo, string $alterType)
151 |     {
152 |         if (! $this->merchant) {
153 |             throw new \LogicException('empty merchant');
154 |         }
155 | 
156 |         $url = $this->isProduction? static::ALTER_STATUS_URL_PRODUCTION: static::ALTER_STATUS_URL_TEST;
157 | 
158 |         $payload = [
159 |             'MerchantID_' => $this->merchant->getId(),
160 |             'PostData_' => $this->merchant->createEncryptedStr(
161 |                 [
162 |                     'RespondType' => 'JSON',
163 |                     'Version' => '1.0',
164 |                     'MerOrderNo' => $orderNo,
165 |                     'PeriodNo' => $periodNo,
166 |                     'AlterType' => $alterType,
167 |                     'TimeStamp' => time(),
168 |                 ]
169 |             ),
170 |         ];
171 | 
172 |         $resp = $this->post($url, $payload);
173 |         if (! isset($resp['period'])) {
174 |             throw new TradeInfoException("interface change from Newebpay");
175 |         }
176 | 
177 |         return json_decode($this->merchant->decryptTradeInfo($resp['period']), true);
178 |     }
179 | 
180 |     public function issue(PeriodInfo $info)
181 |     {
182 |         echo <<<EOT
183 | <!DOCTYPE html>
184 | <html>
185 |     <head>
186 |         <meta charset="utf-8">
187 |     </head>
188 |     <body>
189 |         {$this->generatePeriodForm($info)}
190 |         <script>
191 |             var form = document.getElementById("$this->formId");
192 |             form.submit();
193 |         </script>
194 |     </bod>
195 | </html>
196 | EOT;
197 |     }
198 | 
199 |     public function generatePeriodForm(PeriodInfo $info)
200 |     {
201 |         if (! $this->merchant) {
202 |             throw new \LogicException('empty merchant');
203 |         }
204 | 
205 |         $url = $this->isProduction? static::ISSUE_URL_PRODUCTION: static::ISSUE_URL_TEST;
206 | 
207 |         $tradeInfo = $this->merchant->countTradeInfo($info);
208 | 
209 |         return <<<EOT
210 | <form name="newebpay" id="{$this->formId}" method="post" action="{$url}" style="display:none;">
211 |     <input type="text" name="MerchantID_" value="{$this->merchant->getId()}" type="hidden"/>
212 |     <input type="text" name="PostData_" value="$tradeInfo" type="hidden">
213 | </form>
214 | EOT;
215 |     }
216 | 
217 |     public function checkout(Info $info)
218 |     {
219 |         echo <<<EOT
220 | <!DOCTYPE html>
221 | <html>
222 |     <head>
223 |         <meta charset="utf-8">
224 |     </head>
225 |     <body>
226 |         {$this->generateForm($info)}
227 |         <script>
228 |             var form = document.getElementById("$this->formId");
229 |             form.submit();
230 |         </script>
231 |     </bod>
232 | </html>
233 | EOT;
234 |     }
235 | 
236 |     /**
237 |      * @param Info $info
238 |      * @return string
239 |      */
240 |     public function generateForm(Info $info)
241 |     {
242 |         if (! $this->merchant) {
243 |             throw new \LogicException('empty merchant');
244 |         }
245 | 
246 |         $url = $this->isProduction ? static::CHECKOUT_URL_PRODUCTION: static::CHECKOUT_URL_TEST;
247 | 
248 |         $tradeInfo = $this->merchant->countTradeInfo($info);
249 | 
250 |         $tradeSha = $this->merchant->countTradeSha($tradeInfo);
251 | 
252 |         $version = static::VERSION;
253 | 
254 |         return <<<EOT
255 | <form name="newebpay" id="{$this->formId}" method="post" action="{$url}" style="display:none;">
256 |     <input type="text" name="MerchantID" value="{$this->merchant->getId()}" type="hidden"/>
257 |     <input type="text" name="TradeInfo" value="{$tradeInfo}" type="hidden"/>
258 |     <input type="text" name="TradeSha" value="{$tradeSha}" type="hidden"/>
259 |     <input type="text" name="Version" value="{$version}" type="hidden"/>
260 | </form>
261 | EOT;
262 |     }
263 | 
264 |     public function checkoutForApi(Info $info)
265 |     {
266 |         if (! $this->merchant) {
267 |             throw new \LogicException('empty merchant');
268 |         }
269 | 
270 |         return [
271 |             'url' => $this->isProduction ? static::CHECKOUT_URL_PRODUCTION: static::CHECKOUT_URL_TEST,
272 |             'form_params' => [
273 |                 'MerchantID' => $this->merchant->getId(),
274 |                 'TradeInfo' => $tradeInfo = $this->merchant->countTradeInfo($info),
275 |                 'TradeSha' => $this->merchant->countTradeSha($tradeInfo),
276 |                 'Version' => static::VERSION,
277 |             ],
278 |         ];
279 |     }
280 | 
281 |     /**
282 |      * @param  OrderInterface  $order
283 |      * @return array
284 |      */
285 |     public function query(OrderInterface $order)
286 |     {
287 |         if (! $this->merchant) {
288 |             throw new \LogicException('empty merchant');
289 |         }
290 | 
291 |         $url = $this->isProduction? static::QUERY_URL_PRODUCTION: static::QUERY_URL_TEST;
292 | 
293 |         $payload = [
294 |             'MerchantID' => $this->merchant->getId(),
295 |             'Version' => '1.1',
296 |             'RespondType' => 'JSON',
297 |             'CheckValue' => $this->countCheckValue($order),
298 |             'TimeStamp' => time(),
299 |             'MerchantOrderNo' => $order->getMerchantOrderNo(),
300 |             'Amt' => $order->getAmt(),
301 |         ];
302 | 
303 |         return $this->post($url, $payload);
304 |     }
305 | 
306 |     public function setIsProduction(bool $isProduction)
307 |     {
308 |         $this->isProduction = $isProduction;
309 | 
310 |         return $this;
311 |     }
312 | 
313 |     public function setFormId(string $formId)
314 |     {
315 |         $this->formId = $formId;
316 | 
317 |         return $this;
318 |     }
319 | 
320 |     public function setMerchant(Merchant $merchant)
321 |     {
322 |         $this->merchant = $merchant;
323 | 
324 |         return $this;
325 |     }
326 | 
327 |     /**
328 |      * @param  OrderInterface  $order
329 |      * @return string
330 |      */
331 |     protected function countCheckValue(OrderInterface $order)
332 |     {
333 |         $payload = [
334 |             'IV' => $this->merchant->getHashIv(),
335 |             'Amt' => $order->getAmt(),
336 |             'MerchantID' => $this->merchant->getId(),
337 |             'MerchantOrderNo' => $order->getMerchantOrderNo(),
338 |             'Key' => $this->merchant->getHashKey(),
339 |         ];
340 | 
341 |         return strtoupper(hash('sha256', http_build_query($payload)));
342 |     }
343 | 
344 |     protected function post(string $url, array $payload)
345 |     {
346 |         $ch = curl_init($url);
347 |         curl_setopt($ch, CURLOPT_POST, 1);
348 |         curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
349 |         curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
350 |         $result = curl_exec($ch);
351 |         curl_close($ch);
352 | 
353 |         return json_decode($result, true);
354 |     }
355 | }
356 | 


--------------------------------------------------------------------------------