Agent skill

Newebpay Checkout

by paid-tw in paid-tw/skills

Implements NewebPay MPG checkout integration including AES256 encryption, form submission, and payment callback handling.

MITAuto-check: notesBackend & APIs

Install Newebpay Checkout

skills CLI
$ npx skills add paid-tw/skills --skill newebpay-checkout -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install paid-tw/skills newebpay-checkout --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/paid-tw/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/newebpay/skills/newebpay-checkout .claude/skills/newebpay-checkout && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
newebpay-checkout
GitHub stars
284
Token cost
~850 tokens
SKILL.md length
227 words
Files
7 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Implements NewebPay MPG checkout integration including AES256 encryption, form submission, and payment callback handling.

  • Works in 6 steps: 確認專案環境 → 檢查環境變數 → 建立支付模組 → …
  • Integrating payment gateway
  • SKILL.md covers 串接 Checklist, Step 1: 確認專案環境, Step 2: 檢查環境變數 and Step 3: 建立支付模組, plus 5 more sections
  • Reaches ccore.newebpay.com and core.newebpay.com; needs NEWEBPAY_HASH_KEY

What it does

Newebpay Checkout is an agent skill from paid-tw/skills. Implements NewebPay MPG checkout integration including AES256 encryption, form submission, and payment callback handling. Use when integrating payment gateway, creating checkout flows, or building 藍新金流 payment pages.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/code-examples.md`, `references/error-codes.md` and `references/mpg-transaction.md`).

It sits in Backend & APIs, covering Backend development. It works with PHP. The repository describes itself as: 台灣第三方金流 Skills for AI Agents - 藍新金流、綠界科技 ECPay、統一金流 PAYUNi. The licence is MIT.

When your agent uses it

  • Integrating payment gateway
  • Creating checkout flows
  • Building 藍新金流 payment pages

Example prompts

  • “Use the newebpay-checkout skill to implement NewebPay MPG checkout integration including AES256 encryption, form submission, and payment callback…”
  • “/newebpay-checkout”

Requirements

  • Python 3
  • Node.js
  • A credential in HASH_KEY
  • A credential in NEWEBPAY_HASH_KEY
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Grep, Glob

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. 確認專案環境
  2. 檢查環境變數
  3. 建立支付模組
  4. 建立支付表單頁面
  5. 建立回調處理
  6. 測試驗證

What it can do on your machine

Read from SKILL.md and the folder at commit 1cd84bd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • ccore.newebpay.com
    • core.newebpay.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NEWEBPAY_HASH_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Newebpay Checkout loads about 850 tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 227 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~850
With references · SKILL.md plus every file in references/, read only if the agent opens them
~17k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:59
    搜尋專案中的 `.env` 或設定檔,確認是否已設定:
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Grep, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from paid-tw/skills at commit 1cd84bd, republished under its MIT licence (© paid-tw). 227 words, ~850 tokens.

Download SKILL.mdSave it as .claude/skills/newebpay-checkout/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
newebpay-checkout
description
Implements NewebPay MPG checkout integration including AES256 encryption, form submission, and payment callback handling. Use when integrating payment gateway, creating checkout flows, or building 藍新金流 payment pages.
allowed-tools
Read, Write, Edit, Bash, Grep, Glob
argument-hint
[支付方式: 信用卡/LINE Pay/ATM/超商]
context
fork
agent
general-purpose
disable-model-invocation
true
user-invocable
true

藍新金流 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: 建立支付表單頁面

根據框架建立支付表單,需包含:

html
<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超商條碼

詳細參考文件

© paid-tw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in plugins/newebpay/skills/newebpay-checkout of paid-tw/skills.

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

Open the folder on GitHubat commit 1cd84bd

Compare with similar skills

Newebpay Checkout next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Newebpay Checkout compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Newebpay Checkout this skillpaid-tw/skills284—~850Automated safety check: NotesMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Fortify Developmentcoollabsio/coolify63k4 repos~1.9kAutomated safety check: PassMIT
Laravel Best Practicesanonaddy/anonaddy4.9k13 repos~1.2kAutomated safety check: PassMIT
Geoflowyaojingang/GEOFlow3.8k—~722Automated safety check: PassAGPL-3.0
Livewire Developmentcoollabsio/coolify63k—~964Automated safety check: PassMIT

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed
  • Laravel Best Practices

    anonaddy/anonaddy

    Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code.

    4.9k GitHub starsUsed in 13 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Geoflow

    yaojingang/GEOFlow

    Operate/develop GEOFlow CLI/Laravel/admin/API, topics/专题 and topic tasks, theme libraries/replication, sites/leads/Agent, channel sync and legacy yao-geoflow-cli/design/template migration.

    3.8k GitHub stars~722 tokensUpdated today
    Backend & APIsAuto-check passed
  • Livewire Development

    coollabsio/coolify

    A skill your agent uses for any task or question involving Livewire.

    63k GitHub stars~964 tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Laravel Specialist

    Jeffallan/claude-skills

    Builds Laravel 10+ applications with Eloquent models, Sanctum authentication, Horizon queues, API resources and Livewire components, tested with Pest or PHPUnit.

    12k GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-check passed

More from paid-tw/skills

All 15 skills in this repo
  • Kryptogo Pay Checkout

    paid-tw/skills

    Implements KryptoGO Payment checkout integration including Payment Intent creation, React SDK usePayment hook, and Direct API integration.

    284 GitHub stars~1.5k tokensUpdated 7 mo ago
    Auto-check: notes
  • Kryptogo Pay Transfer

    paid-tw/skills

    Implements KryptoGO Payment token transfer/withdrawal functionality using the Asset Pro Transfer API.

    284 GitHub stars~597 tokensUpdated 7 mo ago
    Auto-check: notes
  • Kryptogo Pay Webhook

    paid-tw/skills

    Implements KryptoGO Payment webhook/callback handling for receiving payment status notifications.

    284 GitHub stars~695 tokensUpdated 7 mo ago
    Auto-check: notes
  • Payuni Checkout

    paid-tw/skills

    Implements PAYUNi UPP checkout integration including AES256 encryption, form submission, and payment callback handling.

    284 GitHub stars~1.3k tokensUpdated 7 mo ago
    Auto-check: notes
  • Payuni Webhook

    paid-tw/skills

    Implements PAYUNi webhook handling including signature verification, replay attack prevention, and payment status updates.

    284 GitHub stars~1.6k tokensUpdated 7 mo ago
    Auto-check: notes
  • Newebpay

    paid-tw/skills

    Provides NewebPay integration overview and guides users to the appropriate skill.

    284 GitHub stars~420 tokensUpdated 7 mo ago
    Auto-check: notes

Works with

Categories

Questions about Newebpay Checkout

What does Newebpay Checkout do?

Implements NewebPay MPG checkout integration including AES256 encryption, form submission, and payment callback handling. Newebpay Checkout is an agent skill from paid-tw/skills. Implements NewebPay MPG checkout integration including AES256 encryption, form submission, and payment callback handling.

When should I use Newebpay Checkout?

Newebpay Checkout fits situations like: integrating payment gateway; creating checkout flows; building 藍新金流 payment pages.

How do I install Newebpay Checkout in Claude Code?

Run `npx skills add paid-tw/skills --skill newebpay-checkout -a claude-code`. Or copy the skill folder (plugins/newebpay/skills/newebpay-checkout in paid-tw/skills) into .claude/skills/newebpay-checkout in your project. Claude Code loads it when a task matches its description.

How do I install Newebpay Checkout in Codex?

Run `npx skills add paid-tw/skills --skill newebpay-checkout -a codex`. Or copy the skill folder (plugins/newebpay/skills/newebpay-checkout in paid-tw/skills) into .agents/skills/newebpay-checkout in your project. Codex loads it when a task matches its description.

Can I use Newebpay Checkout in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add paid-tw/skills --skill newebpay-checkout -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/newebpay-checkout, .gemini/skills/newebpay-checkout, .github/skills/newebpay-checkout and .opencode/skills/newebpay-checkout in your project.

What does Newebpay Checkout need to run?

Going by SKILL.md and its folder, Newebpay Checkout needs credentials named NEWEBPAY_HASH_KEY. Our summary lists: Python 3; Node.js; A credential in HASH_KEY; A credential in NEWEBPAY_HASH_KEY. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Grep, Glob.

Does Newebpay Checkout access the network?

SKILL.md names 2 domains. In commands or code: ccore.newebpay.com and core.newebpay.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Newebpay Checkout safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Newebpay Checkout use?

Newebpay Checkout is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Newebpay Checkout use?

About 850 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.

What are the alternatives to Newebpay Checkout?

Skills that share tags, products or a category with Newebpay Checkout: Configuring Horizon (coollabsio/coolify, 63k stars), Fortify Development (coollabsio/coolify, 63k stars), Laravel Best Practices (anonaddy/anonaddy, 4.9k stars) and Geoflow (yaojingang/GEOFlow, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Newebpay Checkout?

paid-tw (a GitHub organization) maintains it in paid-tw/skills, which has 284 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on March 7, 2026.

Source: paid-tw/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.