ECPay API Skill
The official ECPay skill teaches an agent to integrate payments, logistics and e-invoicing from the Taiwanese service.
- 239 ★ on the repository
- Last commit
Broad access
Why this level
- Generates payment code and handles keys that open payment collection and invoicing.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/ecpay-api-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Generates payment code and handles keys that open payment collection and invoicing.
This is third-party code. Review the repository files before installing.
What it does
ECPay API Skill is a knowledge pack for a coding agent from ECPay (綠界科技) itself. After installation the agent writes API integration code, diagnoses errors and walks through the integration stages from the test environment to launch. It covers payments (AIO and ECPG), domestic and cross-border logistics, B2C and B2B e-invoicing, e-receipts, ECTicket, WooCommerce, OpenCart, Magento and Shopify carts, plus POS and live-stream payment collection. It includes verified PHP samples, 29 guides, an index of the official documentation and AES-CBC and AES-GCM implementations in 12 languages. The version at the time of review is V3.4.
Who it is for. Developers of online stores and payment integrations for Taiwan who connect ECPay and do not want to read the documentation by hand.
Good fit when
- A store accepts cards through ECPay and the agent must generate a payment form and a notification handler.
- A `CheckMacValue` signature error needs diagnosing.
- Convenience-store pickup logistics and e-invoicing must be connected.
- A WooCommerce, OpenCart, Magento or Shopify project receives payments from ECPay.
Not a fit when
- The store does not operate in the Taiwan market and has no ECPay contract.
- You need a different payment service with a different API.
- You plan to call the live API without a run in the test environment.
Example request
Build an ECPay AIO card payment for an order in PHP with a ReturnURL handler that verifies CheckMacValue.Limitations
The skill targets the ECPay ecosystem and the Taiwan market. It generates code, but the `HashKey` and `HashIV` keys must be kept somewhere secure and not given to the agent in plain form. Samples are mostly PHP, and other languages cover encryption. The `SimulatePaid=1` mode is for the test environment only. The README and guides are written in Chinese. The license is not declared in metadata. The last commit is dated October 2026.
How to disable. Delete `~/.claude/skills/ecpay` or the folder where you cloned the repository in a project. Review and delete agent-generated code separately.
FAQ
How do I install the skill in Claude Code?
Run `git clone https://github.com/ECPay/ECPay-API-Skill.git ~/.claude/skills/ecpay` for all projects or clone into `.claude/skills/ecpay` for the current one. Verify with the `/ecpay` command.
Which agents are supported?
Claude Code, VS Code Copilot Chat, Visual Studio 2026, GitHub Copilot CLI, Cursor, Codex CLI and Gemini CLI. Each has its own instruction in the repository.
What is CheckMacValue?
A signature that ECPay and the store compute from shared keys. A match confirms the data was not altered in transit.
How do I test a payment without charging money?
In the test environment set `SimulatePaid` to `1` and the payment is simulated as successful. This works only in the test environment.
Which payment methods are covered?
One-time and installment cards, recurring billing, ATM virtual accounts, store codes and barcodes, WebATM, TWQR, BNPL, WeChat Pay, Apple Pay and UnionPay.
Discussion
No questions or reviews yet.
Related
Skills63 skills for Malaysian payment gateways: server-side checkout, webhook signature checks and idempotent settlement
Hundreds of per-provider skills teach an agent to receive webhooks, verify signatures and handle events, with code examples.
YooKassa Skill
Yookassa Skill
A reference skill for YooKassa integration: API v3, a TypeScript SDK, one and two-stage payments, webhooks and 54-FZ
The official Payload CMS skill shipped inside the package: collections, fields, hooks, access control, queries and database adapters
Thirty-two Tencent CloudBase skills: serverless functions, auth, AI models, storage and backend deployment in the cloud.
Official Clerk skills that teach an agent to add authentication to Next.js, React, Vue, Expo, Swift and Android apps
README in short
The README explains what an agent and a skill are, shows installation per platform and lists the covered services. Samples, guides and an API reference are collected separately.