mcpField
N
newebpay

newebpay

github.com/paid-tw开发284111 次安装34 周前更新
代码仓库

关于 newebpay

newebpay 是用于配置蓝新金流环境并分流到支付相关技能的指南，面向接入 NewebPay 的开发者。它涵盖环境变量、安全注意事项，以及结账、查询和退款流程入口。

主要功能

  1. 01按需求引导至结账、查询或退款技能
  2. 02检查项目框架与商店账号状态
  3. 03指导设置环境变量和 .env
  4. 04列出支付方式与环境 API 地址
  5. 05说明密钥及交易参数注意事项

适用场景

  1. 01为项目配置 NewebPay 测试或正式环境
  2. 02根据需求选择支付、交易查询或退款流程
  3. 03检查支付接入所需的环境与账号信息

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/newebpay确认已加载。

附带文件scripts/encryption.php

详细介绍

来自项目 README

藍新金流整合指南

你的任務是幫助用戶設定藍新金流(NewebPay)環境並引導至適當的串接功能。

用戶需求分析

用戶輸入: $ARGUMENTS

根據用戶需求，判斷下一步：

  • 若包含「串接」「checkout」「建立交易」「MPG」→ 引導使用 /newebpay-checkout
  • 若包含「查詢」「query」「訂單狀態」→ 引導使用 /newebpay-query
  • 若包含「退款」「refund」「取消」→ 引導使用 /newebpay-refund
  • 若無特定指定 → 提供以下環境設定引導

環境設定檢查

詢問用戶以下問題：

  1. 專案框架：你使用什麼框架？

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

  2. 環境狀態：是否已有藍新金流商店帳號？

    • 是，已有測試環境帳號
    • 是，已有正式環境帳號
    • 否，需要申請

環境變數設定

引導用戶建立環境變數：

NEWEBPAY_MERCHANT_ID=MS12345678
NEWEBPAY_HASH_KEY=your_hash_key
NEWEBPAY_HASH_IV=your_hash_iv
NEWEBPAY_ENV=test  # test 或 production

指導用戶:

  1. 在專案根目錄建立或編輯 .env 檔案
  2. 加入上述環境變數
  3. 確保 .env 已加入 .gitignore

下一步

完成環境設定後，根據用戶需求引導：

需求Skill說明
建立支付頁面/newebpay-checkoutMPG 幕前支付串接
查詢交易狀態/newebpay-query交易查詢 API
處理退款/newebpay-refund信用卡/電子錢包退款

環境資訊

環境API Base URL
測試https://ccore.newebpay.com
正式https://core.newebpay.com

支援的支付方式

  • 信用卡: 一次付清、分期付款、紅利折抵
  • 行動支付: Apple Pay、Google Pay、Samsung Pay
  • 電子錢包: LINE Pay、台灣Pay、TWQR
  • ATM: WebATM、ATM轉帳
  • 超商: 代碼繳費、條碼繳費

重要注意事項

  1. HashKey 和 HashIV 必須保密，不可暴露在前端
  2. 時間戳記容許誤差 ±120 秒
  3. 訂單編號不可重複，限 30 字元
  4. ReturnURL/NotifyURL 只接受 80/443 Port

评论

支持 Markdown