綠界 ECPay 金流 API 串接

最近因為在串綠界的金流,來記錄一下好了。

首先要先去綠界下載 API 文件還有 SDK,我是用 php 寫的所以就下載 php 那包。

接下來要傳資料到後端去處理:

<form action="Ecpay.php" id="" method="post"><label>編號 (MerchantTradeNo):
        <input class="form-control" name="MerchantTradeNo" type="text" value="商店的訂單編號" />
        不可重複使用。英數字大小寫混合
    </label>
    <label class="col-xs-12">時間 (MerchantTradeDate):
        <input class="form-control" name="MerchantTradeDate" type="text" value="當下時間" />
        yyyy/MM/dd HH:mm:ss
    </label>
    <label class="col-xs-12">類型 (PaymentType):
        <input class="form-control" name="PaymentType" type="text" value="aio" />
        aio
    </label>
    <label class="col-xs-12">金額 (TotalAmount):
        <input class="form-control" name="TotalAmount" type="text" value="本次要負的金額" />
        請帶整數,不可有小數點 僅限新台幣 金額不可為 0 元,如果是 CVS 或 BARCODE 最低限制為 30 元,最高限制為 30,000 元
    </label>
    <label class="col-xs-12">描述 (TradeDesc):
        <input class="form-control" name="TradeDesc" type="text" value="Desc" />
    </label>
    <label class="col-xs-12">名稱 (ItemName):
        <input class="form-control" name="ItemName" type="text" value="A#B" />
        如果商品名稱有多筆,需在金流選擇頁一行一行顯示商品名稱的話,商品名稱請以符號#分隔。
    </label>
    <label class="col-xs-12">回傳網址 (ReturnURL):
        <input class="form-control" name="ReturnURL" type="text" value="要接收綠界回傳付款資訊的網址" />
    </label>
    <label class="col-xs-12">付款方式 (ChoosePayment):
        <input name="ChoosePayment" type="text" value="ALL" />
        綠界提供下列付款方式,請於建立訂單時傳送過來:Credit:信用卡及銀聯卡
UnionPay:銀聯卡(需申請開通)
WebATM:網路ATM
ATM:自動櫃員機
CVS:超商代碼
BARCODE:超商條碼
ALL:不指定付款方式,由綠界顯示付款方式選擇頁面。
    </label>

    <button class="btn btn-default" type="submit">付款</button>
</form>



接著在 post 後處理資料再送到綠界就可以了

include('ECPay.Payment.Integration.php');
    try {
        
     $obj = new ECPay_AllInOne();
   
        //服務參數
        $obj->ServiceURL  = "https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5";  //服務位置,記得測試完要還成正式網址
        $obj->HashKey     = '5294y06JbISpM5x9' ;                                          //測試用Hashkey,請自行帶入ECPay提供的HashKey
        $obj->HashIV      = 'v77hoKGq4kWxNNIS' ;                                          //測試用HashIV,請自行帶入ECPay提供的HashIV
        $obj->MerchantID  = '2000132';                                                    //測試用MerchantID,請自行帶入ECPay提供的MerchantID
        $obj->EncryptType = '1';                                                          //CheckMacValue加密類型,請固定填入1,使用SHA256加密


        //基本參數(請依系統規劃自行調整)
        $MerchantTradeNo = "Test".time() ;
        $obj->Send['ReturnURL']         = "接收回傳資料的網址" ;     //付款完成通知回傳的網址
        $obj->Send['MerchantTradeNo']   = $MerchantTradeNo;                           //訂單編號
        $obj->Send['MerchantTradeDate'] = date('Y/m/d H:i:s');                        //交易時間
        $obj->Send['TotalAmount']       = 2000;                                       //交易金額
        $obj->Send['TradeDesc']         = "good to drink" ;                           //交易描述
        $obj->Send['ChoosePayment']     = ECPay_PaymentMethod::ALL ;                  //付款方式:全功能

        //訂單的商品資料
        array_push($obj->Send['Items'], array('Name' => "歐付寶黑芝麻豆漿", 'Price' => (int)"2000",
                   'Currency' => "元", 'Quantity' => (int) "1", 'URL' => "dedwed"));

       

        //產生訂單(auto submit至ECPay)
        $obj->CheckOut();
      

    
    } catch (Exception $e) {
     echo $e->getMessage();
    } 



最後處理回傳的付款資訊即可。

require('ECPay.Payment.Integration.php');

    try {
        // 收到綠界科技的付款結果訊息,並判斷檢查碼是否相符
        $AL = new ECPay_AllInOne();
        $AL->MerchantID = '2000132';
        $AL->HashKey = '5294y06JbISpM5x9';
        $AL->HashIV = 'v77hoKGq4kWxNNIS';
        // $AL->EncryptType = ECPay_EncryptType::ENC_MD5;  // MD5
        $AL->EncryptType = ECPay_EncryptType::ENC_SHA256; // SHA256
        $feedback = $AL->CheckOutFeedback();

        // 以付款結果訊息進行相對應的處理
        /** 
        回傳的綠界科技的付款結果訊息如下:
        Array
        (
            [MerchantID] =>
            [MerchantTradeNo] =>
            [StoreID] =>
            [RtnCode] =>
            [RtnMsg] =>
            [TradeNo] =>
            [TradeAmt] =>
            [PaymentDate] =>
            [PaymentType] =>
            [PaymentTypeChargeFee] =>
            [TradeDate] =>
            [SimulatePaid] =>
            [CustomField1] =>
            [CustomField2] =>
            [CustomField3] =>
            [CustomField4] =>
            [CheckMacValue] =>
        )

        再個別寫入資料庫更新即可
        */

        // 在網頁端回應 1|OK
        echo '1|OK';
    } catch(Exception $e) {
        echo '0|' . $e->getMessage();
    }

課程推薦

AI工作術全面學習實戰營:6 堂精選課程,學會最好用 AI 工具,翻轉你的人生

AI工作術全面學習實戰營:6 堂精選課程,學會最好用 AI 工具,翻轉你的人生

《PChome雜誌》攜手 5 位在 AI 領域的專業講師,打造上述 6 堂實用課程,教你學會時下最好用的 AI 工具,導入生成式 AI 來產製工作內容,改造並升級你的工作流程。

輸入折扣碼 ZERO2024 還可以額外獲得 NT$400 優惠喔。

HTML與SEO實戰應用—並以ChatGPT助力提升網站品質與流量

HTML與SEO實戰應用—並以ChatGPT助力提升網站品質與流量

本課程專為希望深入了解 HTML 並有效結合 SEO 策略的學員設計。我們將重點放在 HTML 的深度學習與應用上,同時穿插介紹如何透過搜索引擎優化提升網站能見度。透過即時互動式的直播教學,加上 ChatGPT 的輔助,您將學習到如何建立一個結構優良、美觀且符合 SEO 標準的網站。這不僅會提升網站的用戶體驗,還會大幅提高網站的搜索引擎排名,進而增加訪客流量和潛在客戶。
用AI強化職場競爭力 ChatGPT、Midjourney從入門到精通

用AI強化職場競爭力 ChatGPT、Midjourney從入門到精通

在快速變遷的職場中,提升競爭力成為關鍵。透過引領潮流的AI技術,ChatGPT和Midjourney將助您勇攀高峰。無論您是AI新手還是專家,這個課程將引導您從入門到精通,解密AI的奧秘,並學習如何運用於職場。
GitHub Copilot AI 程式碼編輯工具應用實務班

GitHub Copilot AI 程式碼編輯工具應用實務班

讓學員瞭解有效地使用該工具來加速開發流程、提高程式碼品質和生產力。課程重點放在以 JavaScript 程式語言為例,介紹 Copilot 的基本原理、使用方法和最佳實踐。

輸入折扣碼 TC1456JA 還可以額外獲得 NT$500 優惠喔。

ChatGPT X Clipchamp AI 生成影片、配音與字幕應用實戰班

ChatGPT X Clipchamp AI 生成影片、配音與字幕應用實戰班

掌握Clipchamp AI的操作技巧,靈活運用Clipchamp AI進行影片編輯和創作,實現創意表達和傳播目的。

輸入折扣碼 TC1451JAN 還可以額外獲得 NT$500 優惠喔。

如何串接多種數位工具資訊?Looker Studio 資料視覺化實戰班|GoogleAds x FB廣告 x GA流量數據

如何串接多種數位工具資訊?Looker Studio 資料視覺化實戰班|GoogleAds x FB廣告 x GA流量數據

Looker Studio除了可協助使用者監控網站流量、廣告成效、選擇匯入資源的管道之外,還可以將數據資料多平台整合、數據報表即時更新、數據範本可重複套用的效益,透過自動化系統,將數據全部匯入同一個報表平台,是企業不可或缺的重要工具。

輸入折扣碼 TC1270JIA 還可以額外獲得 NT$500 優惠喔。

和我們交流

加入我們的社群,裡面會有一些技術的內容、有趣的技術梗,以及職缺的分享,歡迎和我們一起討論。