藍新金流 MPG 支付串接任務
你的任務是在用戶的專案中實作藍新金流 MPG 幕前支付功能。
串接 Checklist
完成以下步驟即可完成串接：
Step 1: 確認專案環境
詢問用戶：
框架類型：你使用什麼框架？
- PHP (Laravel / CodeIgniter / 原生)
- Node.js (Express / Fastify / NestJS)
- Python (Django / Flask / FastAPI)
- 其他
支付方式：需要支援哪些支付方式？（可複選）
- 信用卡
- LINE Pay
- Apple Pay / Google Pay
- ATM 轉帳
- 超商代碼/條碼
用戶輸入: $ARGUMENTS
Step 2: 檢查環境變數
搜尋專案中的 .env 或設定檔，確認是否已設定：
NEWEBPAY_MERCHANT_IDNEWEBPAY_HASH_KEYNEWEBPAY_HASH_IV
若未設定，引導用戶設定環境變數。
Step 3: 建立支付模組
根據用戶框架建立支付模組檔案。
建立位置建議:
- Laravel:
app/Services/NewebPayService.php
- Express:
services/newebpay.js
- Django:
payments/services.py
核心功能:
encrypt(data) - AES256 加密decrypt(data) - AES256 解密generateSha(tradeInfo) - SHA256 簽章createOrder(orderData) - 建立訂單並回傳表單資料handleNotify(payload) - 處理回調通知
Step 4: 建立支付表單頁面
根據框架建立支付表單，需包含：
<form method="post" action="https://ccore.newebpay.com/MPG/mpg_gateway">
<input type="hidden" name="MerchantID" value="{商店代號}">
<input type="hidden" name="TradeInfo" value="{加密資料}">
<input type="hidden" name="TradeSha" value="{SHA256簽章}">
<input type="hidden" name="Version" value="2.3">
<button type="submit">前往付款</button>
</form>
Step 5: 建立回調處理
建立兩個端點：
NotifyURL (背景通知): POST /payment/notify
- 接收藍新背景通知
- 解密 TradeInfo
- 更新訂單狀態
- 回應 "OK"
ReturnURL (前台返回): GET/POST /payment/return
Step 6: 測試驗證
引導用戶進行測試：
- 使用測試環境
https://ccore.newebpay.com
- 測試信用卡號:
4000-2211-1111-1111
- 驗證加密解密正確性
- 確認回調可正常接收
API 參考
端點
| 環境 |
URL |
| 測試 |
https://ccore.newebpay.com/MPG/mpg_gateway |
| 正式 |
https://core.newebpay.com/MPG/mpg_gateway |
TradeInfo 必要參數
| 參數 |
類型 |
說明 |
| MerchantID |
String(15) |
商店代號 |
| RespondType |
String |
JSON |
| TimeStamp |
Number |
Unix timestamp |
| Version |
String |
2.3 |
| MerchantOrderNo |
String(30) |
訂單編號（不可重複） |
| Amt |
Number |
金額 |
| ItemDesc |
String(50) |
商品描述 |
| Email |
String(50) |
付款人 Email |
| ReturnURL |
String |
前台返回網址 |
| NotifyURL |
String |
背景通知網址 |
支付方式參數
| 參數 |
值 |
說明 |
| CREDIT |
1 |
信用卡 |
| INST |
3,6,12 |
分期期數 |
| LINEPAY |
1 |
LINE Pay |
| APPLEPAY |
1 |
Apple Pay |
| GOOGLEPAY |
1 |
Google Pay |
| VACC |
1 |
ATM 轉帳 |
| CVS |
1 |
超商代碼 |
| BARCODE |
1 |
超商條碼 |
詳細參考文件
