【技術FAQ】全方位金流建立訂單示範

技術文件:綠界科技全方位金流API技術文件

以下以測試帳號 3002607 為建立全方位金流訂單的範例說明。

1. 準備參數

      {
        "MerchantID": "3002607",
        "MerchantTradeNo": "order20250304001",
        "MerchantTradeDate": "2025/03/04 00:00:00",
        "PaymentType": "aio",
        "TotalAmount": 100,
        "TradeDesc": "訂單測試",
        "ItemName": "範例商品",
        "ReturnURL": " https://5569-211-23-76-78.ngrok-free.app/returnurl.php",
        "ChoosePayment": "ALL",
        "EncryptType": 1,
        "CheckMacValue":"B251AD005829A4072192E495BF484DCF3830D75382AB34DF46F8F3AA8F794940"
      }
  
2. 以參數呼叫 API

以下僅為最簡單的呼叫示範方法。請遵循技術文件的傳輸協定,並視作業需求調整。

注意:由於必須要於前端頁面導轉,才能正常導轉至全方位金流付款頁面,因此即使是測試環境,也請避免使用  Postman 等工具。


    <html>
    <head>
      <title>測試</title>
    </head>
    <body>
      <form method="post" action="https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5">
      <input name="MerchantID" value="3002607" /><br />
      <input name="MerchantTradeNo" value="order202503040001"/><br />
      <input name="MerchantTradeDate" value="2025/03/04 00:00:00" /><br />
      <input name="PaymentType" value="aio" /><br />
      <input name="TotalAmount" value="100" /><br />
      <input name="TradeDesc" value="訂單測試"/><br />
      <input name="ItemName" value="範例商品"/><br />
      <input name="ReturnURL" value=" https://5569-211-23-76-78.ngrok-free.app/returnurl.php"/><br />
      <input name="ChoosePayment" value="ALL" /><br />
      <input name="EncryptType" value="1"/><br />
      <input name="CheckMacValue" value="54B1661DE89951772A94FD0F5639FE5CEDA91311CA42021FD8D9DD4170A965D9"/><br />
      <input type="submit" value="送出參數" />
      </form>
    </body>
  </html>
  
3. 跳轉至全方位金流付款頁面

以下分別示範不同的付款方式

3.1 信用卡付款

3.1.1 可直接於介面輸入信用卡卡號、有效年月、安全碼、持卡人資料。輸入完後按下畫面最下方的「立即付款」

3.1.2 出現測試環境才會有的提醒視窗,按「關閉」後會回到付款頁面,再按一次「立即付款」

3.1.3 按「確定」

3.1.4 來到 3D 驗證畫面,輸入密碼

3.1.5 完成付款

3.1.6 至廠商管理後台檢查訂單。因為已用信用卡付款完成,您的 ReturnURL 也會收到付款結果通知。

3.2 ATM/CVS/BARCODE 付款

3.2.1 ATM 請選擇銀行,再按「取得繳費帳號」;CVS 與 BARCODE 請按「取得繳費條碼」、「取得繳費代碼」

3.2.2 取得繳費帳號。因是測試環境,所以不會顯示完整帳號。

3.2.3 ATM/CVS/BARCODE 於測試環境無完成付款功能。

4. 關於CheckMacValue 檢查碼

發送參數、收到付款結果通知時,皆有參數 CheckMacValue。計算方式與檢查方式請看:
什麼是 CheckMacValue (檢查碼)?如何運作?(What is a CheckMacValue? How does it work?)

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.