mcpField
N
newebpay-checkout

newebpay-checkout

github.com/paid-twDevelopment28456 installsUpdated 34w ago
Repository

About newebpay-checkout

A skill that guides implementation of NewebPay MPG front-end payments in a user's project. It covers environment checks, payment code and forms, callback endpoints, and test verification across the frameworks listed in its instructions.

Key features

  1. 01Check project framework and payment needs
  2. 02Configure required environment variables
  3. 03Create encryption and order functions
  4. 04Build a payment submission form
  5. 05Handle NotifyURL and ReturnURL
  6. 06Guide test verification

Use cases

  1. 01Add NewebPay MPG to a project
  2. 02Configure payment credentials
  3. 03Implement order and callback handling
  4. 04Verify a payment integration in test mode

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/paid-tw/skills --skill newebpay-checkout

After installing, type/newebpay-checkoutin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
code-examples.md
error-codes.md
mpg-transaction.md
response-parameters.md
troubleshooting.md
use-cases.md

Details

From the project README

藍新金流 MPG 支付串接任務

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

串接 Checklist

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

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

Step 1: 確認專案環境

詢問用戶：

  1. 框架類型：你使用什麼框架？

    • PHP (Laravel / CodeIgniter / 原生)
    • Node.js (Express / Fastify / NestJS)
    • Python (Django / Flask / FastAPI)
    • 其他

  2. 支付方式：需要支援哪些支付方式？（可複選）

    • 信用卡
    • 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

核心功能:

  1. encrypt(data) - AES256 加密
  2. decrypt(data) - AES256 解密
  3. generateSha(tradeInfo) - SHA256 簽章
  4. createOrder(orderData) - 建立訂單並回傳表單資料
  5. 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: 建立回調處理

建立兩個端點：

  1. NotifyURL (背景通知): POST /payment/notify

    • 接收藍新背景通知
    • 解密 TradeInfo
    • 更新訂單狀態
    • 回應 "OK"

  2. ReturnURL (前台返回): GET/POST /payment/return

    • 用戶支付完成後導向
    • 顯示交易結果

Step 6: 測試驗證

引導用戶進行測試：

  1. 使用測試環境 https://ccore.newebpay.com
  2. 測試信用卡號: 4000-2211-1111-1111
  3. 驗證加密解密正確性
  4. 確認回調可正常接收

API 參考

端點
環境URL
測試https://ccore.newebpay.com/MPG/mpg_gateway
正式https://core.newebpay.com/MPG/mpg_gateway
TradeInfo 必要參數
參數類型說明
MerchantIDString(15)商店代號
RespondTypeStringJSON
TimeStampNumberUnix timestamp
VersionString2.3
MerchantOrderNoString(30)訂單編號（不可重複）
AmtNumber金額
ItemDescString(50)商品描述
EmailString(50)付款人 Email
ReturnURLString前台返回網址
NotifyURLString背景通知網址
支付方式參數
參數值說明
CREDIT1信用卡
INST3,6,12分期期數
LINEPAY1LINE Pay
APPLEPAY1Apple Pay
GOOGLEPAY1Google Pay
VACC1ATM 轉帳
CVS1超商代碼
BARCODE1超商條碼

詳細參考文件

Comments

Markdown supported