Skills newebpay-checkout

install

source · Clone the upstream repo

git clone https://github.com/Oelshafei1/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Oelshafei1/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/newebpay/skills/newebpay-checkout" ~/.claude/skills/oelshafei1-skills-newebpay-checkout && rm -rf "$T"

manifest: plugins/newebpay/skills/newebpay-checkout/SKILL.md

source content

藍新金流 MPG 支付串接任務

你的任務是在用戶的專案中實作藍新金流 MPG 幕前支付功能。

串接 Checklist

完成以下步驟即可完成串接：

環境確認 - 確認框架類型與支付方式需求
環境變數 - 設定 NEWEBPAY_MERCHANT_ID、HASH_KEY、HASH_IV
支付模組 - 建立加密解密與訂單建立功能
支付表單 - 建立送出至藍新的 HTML 表單
回調處理 - 建立 NotifyURL 與 ReturnURL 端點
測試驗證 - 使用測試環境與測試卡號驗證

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_ID
```
```
NEWEBPAY_HASH_KEY
```
```
NEWEBPAY_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	超商條碼