技術文件:綠界科技全方位金流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?)