simon80119/allpay2in1

Ecpay 2in1 - Laravel 5 version

v1.1.0 2022-12-13 11:21 UTC

MIT

• Kenny Chou

• allpay
• ecpay

README

整合綠界線上刷卡及超商物流

本repository 部份fork自ScottChayaa的https://github.com/kennychou3896/allpay2in1 ，謹此聲明。

適用對象:以Laravel 5開發商務網站，欲使用綠界線上金流、物流服務。

實作版本：Laravel 5.2

本版的線上金流程式庫因當初專案需求，先引用歐付寶的Library，但後來因有超商到店付的需求，所以轉而使用綠界的線上金流＆物流服務，為什麼是綠界！？

歐付寶跟綠界基本上是同一家公司，歐付寶現在主推行動支付，物流的業務又撥回給先前購併的綠界，為求省事只好將金流與物流全轉到綠界。

還好兩家公司的金流API參數都一致，所以置換上並無多大困擾。後續有時間再改回Ecpay自家的程式庫。

若有超商貨到付款的需求者，建議與綠界簽約時，最好金流、物流都一起簽，省的到時要加簽又要花好幾天時間。

step 1 : Download the package

composer命令安裝

composer require kennychou3896/allpay2in1 dev-master

或者是新增package至composer.json

"require": { "kennychou3896/allpay2in1": "dev-master" },

然後更新安裝

composer update

或全新安裝

composer install

step 2 : Modify config file

增加config/app.php中的providers和aliases的參數 。

'providers' => [ // ... Kennychou3896\Allpay2in1\AllpayServiceProvider::class, ]

'aliases' => [ // ... 'Allpay' => Kennychou3896\Allpay2in1\Facade\Allpay::class, ]

step 3 : Publish config to your project

執行下列命令，將package的config檔配置到你的專案中

php artisan vendor:publish

至config/allpay.php中確認Allpay設定：

return [
    'ServiceURL' => 'http://payment-stage.ecpay.com.tw/Cashier/AioCheckOut',    
    'HashKey'    => '5294y06JbISpM5x9',    //這是綠界給的test Key ，正式上線由此抽換為你的Key
    'HashIV'     => 'v77hoKGq4kWxNNIS',    
    'MerchantID' => '2000132',    
];

**How To Use -->線上刷卡篇

在Controller中

use Allpay; 
public function Demo()
{   
  //Official Example :     
  //https://github.com/allpay/PHP/blob/master/AioSDK/example/sample_Credit_CreateOrder.php

  //基本參數(可依系統規劃自行調整)
  Allpay::i()->Send['ReturnURL']         = "http://www.yourwebsites.com.tw/ReturnURL" ; 
                                        //交易結果回報的網址
  Allpay::i()->Send['ClientBackURL']     = "http://www.yourwebsites.com.tw/ClientBackURL" ; 
                                        //交易結束，讓user導回的網址
  Allpay::i()->Send['MerchantTradeNo']   = "Test".time() ;           //訂單編號
  Allpay::i()->Send['MerchantTradeDate'] = date('Y/m/d H:i:s');      //交易時間
  Allpay::i()->Send['TotalAmount']       = 2000;                     //交易金額
  Allpay::i()->Send['TradeDesc']         = "good to drink" ;         //交易描述
  Allpay::i()->Send['EncryptType']      = '1' ;  
  Allpay::i()->Send['ChoosePayment']     = "Credit" ;     //付款方式:信用卡
  Allpay::i()->Send['PaymentType']        = 'aio' ;

  //訂單的商品資料
  array_push(Allpay::i()->Send['Items'], 
          array('Name' => "美美小包包", 
          'Price' => (int)"2000",'Currency' => "元", 
          'Quantity' => (int) "1", 
          'URL' => "http://www.yourwebsites.com.tw/Product"));

  //Go to EcPay    
  echo "線上刷卡頁面導向中...";    
  echo Allpay::i()->CheckOutForm();

  //開發階段，如果你希望看到表單的內容，可以改為以下敘述：   
  //echo Allpay::i()->CheckOutForm('按我，才送出');

}

超商物流篇--到店付

1.選擇『到付店』：
  Allpay::l()->Send['MerchantTradeNo'] = 'Test-'.date('YmdHis');
  Allpay::l()->Send['LogisticsSubType'] = 'UNIMARTC2C'; //或FAMIC2C,全家
  Allpay::l()->Send['IsCollection'] = 'N';//是否代收貨款
  Allpay::l()->Send['ServerReplyURL'] = url('shop_option_reply'); //超商系統回覆路徑post
  Allpay::l()->Send['ExtraData'] = ''; //附帶資料
  Allpay::l()->Send['Device'] = '0';		
  $logisticsForm = Allpay::l()->CvsMap();
  echo $logisticsForm;

2.取得『到付店』之回覆資訊：
  $data = array();		
  $data['merchant_trade_no'] = $request->input('MerchantTradeNo'); //訂單編號
  $data['LogisticsSubType'] = $request->input('LogisticsSubType'); //物流通路代碼,如統一:UNIMART
  $data['CVSStoreID'] = $request->input('CVSStoreID');//商店代碼
  $data['CVSStoreName'] = $request->input('CVSStoreName');
  $data['CVSAddress'] = $request->input('CVSAddress');//User 所選之超商店舖地址
  $data['CVSTelephone'] = $request->input('CVSTelephone');//User 所選之超商店舖電話
  $data['ExtraData'] = $request->input('ExtraData');//額外資訊,原資料回傳

3.產生『到付店』托運單：

//背景建立店到付物流單
	try {
	$AL = Allpay::l();
  	$AL->HashKey = config('allpay.HashKey');
  	$AL->HashIV = config('allpay.HashIV');
        $AL->Send = array(
            'MerchantID' => config('allpay.MerchantID'),
            'MerchantTradeNo' => 'mic-' . date('YmdHis'),
            'MerchantTradeDate' => date('Y/m/d H:i:s'),
            'LogisticsType' => 'CVS',
            'LogisticsSubType' => 'UNIMARTC2C',
            'GoodsAmount' => 100,
            'CollectionAmount' => 100,
            'IsCollection' => 'Y',    //是否代收貨款
            'GoodsName' => '商品名稱',
            'SenderName' => '李小華',
            'SenderPhone' => '0226550115',
            'SenderCellPhone' => '0911222333',
            'ReceiverName' => '周大大',
            'ReceiverPhone' => '0233881234',
            'ReceiverCellPhone' => '0912555666',
            'ReceiverEmail' => '[e-mail]',
            'TradeDesc' => '測試交易敘述',
            'ServerReplyURL' => url('logistics_order_reply'),        //物流狀態回覆網址
            'LogisticsC2CReplyURL' => url('logistics_order_C2C_reply'),    //到付店若有異動訊息回覆網址
            'Remark' => '測試備註',
            'PlatformID' => '',
        );
        $AL->SendExtend = array(
             'ReceiverStoreID' => '136392',     //到付店id
             'ReturnStoreID' => '991182'        //回退店id,一般與寄件店id同
        );
	$Result = $AL->BGCreateShippingOrder();   //超商系統回覆內容
	echo '<pre>' . print_r($Result, true) . '</pre>';          
      	if($Result['RtnCode'] == 300){
        		//托運單成功建立

      	}
} catch(Exception $e) {
	$Result = $e->getMessage();
      	echo $e->getMessage();
	} 
3.1 取消『到付店』托運單(僅統一超商)：
    // 取消物流單(統一超商C2C)
    try {
      $AL = Allpay::l();
      $AL->HashKey = config('allpay.HashKey');
      $AL->HashIV = config('allpay.HashIV');
        $AL->Send = array(
        'MerchantID' => config('allpay.MerchantID'),
        'AllPayLogisticsID' => $ships->AllPayLogisticsID,     //綠界物流編號
            'CVSPaymentNo' => $ships->CVSPaymentNo,        		//統一超商寄貨單號
            'CVSValidationNo' => $ships->CVSValidationNo,         //驗證碼
            'PlatformID' => ''
      );
      $Result = $AL->CancelUnimartLogisticsOrder();
      //	echo '<pre>' . print_r($Result, true) . '</pre>';

     } catch(Exception $e) {
        $Result = $e->getMessage();
        echo $e->getMessage();
     } 
    
4.列印『到付店』托運＆繳款單：
  //統一超商
		try {
	        $AL = Allpay::l();
	        $AL->HashKey = config('allpay.HashKey');
	        $AL->HashIV = config('allpay.HashIV');
	        $AL->Send = array(
	            'MerchantID' => config('allpay.MerchantID'),
	            'AllPayLogisticsID' => $Result['AllPayLogisticsID'],
	            'CVSPaymentNo' => $Result['CVSPaymentNo'],
	            'CVSValidationNo' => $Result['CVSValidationNo'],
	            'PlatformID' => ''
	        );
	        // PrintUnimartC2CBill(Button名稱, Form target)
	        $html = $AL->PrintUnimartC2CBill();  //'列印繳款單(統一超商C2C)'
	        echo $html;
	    } catch(Exception $e) {
	        echo $e->getMessage();
	    }
    //全家
    try {
          $AL = Allpay::l();
          $AL->HashKey = config('allpay.HashKey');
          $AL->HashIV = config('allpay.HashIV');
          $AL->Send = array(
              'MerchantID' => config('allpay.MerchantID'),
              'AllPayLogisticsID' => $Result['AllPayLogisticsID'],
              'CVSPaymentNo' => $Result['CVSPaymentNo'],
              'PlatformID' => ''
          );
          // PrintFamilyC2CBill(Button名稱, Form target)
          $html = $AL->PrintFamilyC2CBill(); //'全家列印小白單(全家超商C2C)'
          echo $html;  
      } catch(Exception $e) {
          echo $e->getMessage();
      }