Agent skill

Payuni

by paid-tw in paid-tw/skills

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

MITAuto-check: notesBackend & APIs

Install Payuni

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

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

GitHub CLI
$ gh skill install paid-tw/skills payuni --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/payuni/skills/payuni .claude/skills/payuni && 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
payuni
GitHub stars
284
Token cost
~472 tokens
SKILL.md length
138 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 2 steps: 專案框架:你使用什麼框架? → 環境狀態:是否已有統一金流商店帳號?
  • Starting PAYUNi integration
  • SKILL.md covers 用戶需求分析, 環境設定檢查, 環境變數設定 and 下一步, plus 4 more sections
  • Reaches sandbox-api.payuni.com.tw and api.payuni.com.tw; needs PAYUNI_HASH_KEY

What it does

Payuni is an agent skill from paid-tw/skills. Provides PAYUNi integration overview and guides users to the appropriate skill. Use when starting PAYUNi integration, setting up environment, or needing general guidance about 統一金流.

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

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

When your agent uses it

  • Starting PAYUNi integration
  • Setting up environment
  • Needing general guidance about 統一金流

Example prompts

  • “Use the payuni skill to provide PAYUNi integration overview and guides users to the appropriate skill”
  • “/payuni”

Requirements

  • Python 3
  • Node.js
  • A credential in PAYUNI_HASH_KEY

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 專案框架:你使用什麼框架?
  2. 環境狀態:是否已有統一金流商店帳號?

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 nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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 bash).

    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:

    • sandbox-api.payuni.com.tw
    • api.payuni.com.tw

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

  • Credentials

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

    • PAYUNI_HASH_KEY

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

Context cost

Payuni loads about 472 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 138 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~472

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:52
    1. 在專案根目錄建立或編輯 `.env` 檔案
  • NoteMentions a .env fileSKILL.md:54
    3. 確保 `.env` 已加入 `.gitignore`

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). 138 words, ~472 tokens.

Download SKILL.mdSave it as .claude/skills/payuni/SKILL.md (or your agent's skills folder).
name
payuni
description
Provides PAYUNi integration overview and guides users to the appropriate skill. Use when starting PAYUNi integration, setting up environment, or needing general guidance about 統一金流.
argument-hint
[功能: checkout/query/webhook]
user-invocable
true

統一金流整合指南

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

用戶需求分析

用戶輸入: $ARGUMENTS

根據用戶需求,判斷下一步:

  • 若包含「串接」「checkout」「建立交易」「UPP」→ 引導使用 /payuni-checkout
  • 若包含「查詢」「query」「訂單狀態」→ 引導使用 /payuni-query
  • 若包含「webhook」「回調」「通知」→ 引導使用 /payuni-webhook
  • 若無特定指定 → 提供以下環境設定引導

環境設定檢查

詢問用戶以下問題:

  1. 專案框架:你使用什麼框架?

    • PHP (Laravel / 原生 PHP / 其他)
    • Node.js (Express / Next.js / NestJS / 其他)
    • Python (Django / Flask / FastAPI / 其他)
    • 其他
  2. 環境狀態:是否已有統一金流商店帳號?

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

環境變數設定

引導用戶建立環境變數:

bash
PAYUNI_MERCHANT_ID=你的商店代號
PAYUNI_HASH_KEY=你的HashKey
PAYUNI_HASH_IV=你的HashIV
PAYUNI_TEST_MODE=true  # test 模式,正式環境設為 false

指導用戶:

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

下一步

完成環境設定後,根據用戶需求引導:

需求Skill說明
建立支付頁面/payuni-checkoutUPP 幕前支付串接
查詢交易狀態/payuni-query交易查詢 API
處理 Webhook/payuni-webhook接收付款通知

環境資訊

環境API Base URL
測試https://sandbox-api.payuni.com.tw
正式https://api.payuni.com.tw

支援的支付方式

  • 信用卡: 一次付清、分期付款
  • 行動支付: LINE Pay、Apple Pay、Google Pay
  • ATM: WebATM、ATM 轉帳
  • 超商: 代碼繳費、條碼繳費

重要注意事項

  1. HashKey 和 HashIV 必須保密,不可暴露在前端
  2. PAYUNi 使用 AES-256-CBC 加密
  3. 訂單編號不可重複
  4. NotifyURL/ReturnURL 必須是 HTTPS(正式環境)
  5. Webhook 需驗證簽名防止偽造

與其他金流比較

特性PAYUNi藍新綠界
加密方式AES-256-CBCAES-256-CBCAES-128-CBC
簽章方式SHA256 (HashInfo)SHA256 (TradeSha)SHA256 (CheckMacValue)
API 版本統一版本Version 參數Version 參數

© 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

Just SKILL.md in plugins/payuni/skills/payuni of paid-tw/skills.

Open the folder on GitHubat commit 1cd84bd

Compare with similar skills

Payuni 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.

Payuni compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Payuni this skillpaid-tw/skills284—~472Automated safety check: NotesMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api44k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

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
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    44k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k 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

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
  • Newebpay Checkout

    paid-tw/skills

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

    284 GitHub stars~850 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

Categories

Questions about Payuni

What does Payuni do?

Provides PAYUNi integration overview and guides users to the appropriate skill. Payuni is an agent skill from paid-tw/skills. Provides PAYUNi integration overview and guides users to the appropriate skill.

When should I use Payuni?

Payuni fits situations like: starting PAYUNi integration; setting up environment; needing general guidance about 統一金流.

How do I install Payuni in Claude Code?

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

How do I install Payuni in Codex?

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

Can I use Payuni 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 payuni -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/payuni, .gemini/skills/payuni, .github/skills/payuni and .opencode/skills/payuni in your project.

What does Payuni need to run?

Going by SKILL.md and its folder, Payuni needs credentials named PAYUNI_HASH_KEY. Our summary lists: Python 3; Node.js; A credential in PAYUNI_HASH_KEY.

Does Payuni access the network?

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

Is Payuni safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Payuni use?

Payuni 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 Payuni use?

About 472 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Payuni?

Skills that share tags, products or a category with Payuni: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 44k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Payuni?

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.