Agent skill

Kryptogo Pay Webhook

by paid-tw in paid-tw/skills

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

MITAuto-check: notesBackend & APIs

Install Kryptogo Pay Webhook

skills CLI
$ npx skills add paid-tw/skills --skill kryptogo-pay-webhook -a claude-code

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

GitHub CLI
$ gh skill install paid-tw/skills kryptogo-pay-webhook --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/kryptogo-pay/skills/kryptogo-pay-webhook .claude/skills/kryptogo-pay-webhook && 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
kryptogo-pay-webhook
GitHub stars
284
Token cost
~695 tokens
SKILL.md length
161 words
Files
4 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: 確認環境 → 建立 Webhook 端點 → 處理所有支付狀態 → …
  • Building webhook endpoints
  • SKILL.md covers 串接 Checklist, Step 1: 確認環境, Step 2: 建立 Webhook 端點 and Step 3: 處理所有支付狀態, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Kryptogo Pay Webhook is an agent skill from paid-tw/skills. Implements KryptoGO Payment webhook/callback handling for receiving payment status notifications. Use when building webhook endpoints, handling payment callbacks, or implementing 支付狀態通知 for KryptoGO Payment.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/callback-payload.md`, `references/code-examples.md` and `references/troubleshooting.md`).

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

When your agent uses it

  • Building webhook endpoints
  • Handling payment callbacks
  • Implementing 支付狀態通知 for KryptoGO Payment

Example prompts

  • “Use the kryptogo-pay-webhook skill to implement KryptoGO Payment webhook/callback handling for receiving payment status notifications”
  • “/kryptogo-pay-webhook”

Requirements

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

Workflow steps

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

  1. 確認環境
  2. 建立 Webhook 端點
  3. 處理所有支付狀態
  4. 實作冪等性
  5. 測試

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

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Kryptogo Pay Webhook loads about 695 tokens when it runs, and up to ~4k if it reads all its reference files. Until then it costs about 57 tokens; SKILL.md has 161 words of instructions outside code blocks.

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

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.

  • 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). 161 words, ~695 tokens.

Download SKILL.mdSave it as .claude/skills/kryptogo-pay-webhook/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
kryptogo-pay-webhook
description
Implements KryptoGO Payment webhook/callback handling for receiving payment status notifications. Use when building webhook endpoints, handling payment callbacks, or implementing 支付狀態通知 for KryptoGO Payment.
allowed-tools
Read, Write, Edit, Bash, Grep, Glob
argument-hint
[框架: Express/Flask/FastAPI/NestJS]
context
fork
agent
general-purpose
disable-model-invocation
true
user-invocable
true

KryptoGO Payment Webhook 回調處理任務

你的任務是在用戶的專案中實作 KryptoGO Payment Webhook 回調處理。

串接 Checklist

  • 端點建立 - 建立 POST endpoint 接收回調
  • 狀態處理 - 處理所有 5 種支付狀態
  • 冪等處理 - 實作冪等性避免重複處理
  • 回應確認 - 回應 HTTP 200 確認收到
  • 測試驗證 - 驗證端點可正常運作

Step 1: 確認環境

詢問用戶:

  1. 框架類型:你使用什麼後端框架?

    • Node.js (Express / Fastify / NestJS)
    • Python (Django / Flask / FastAPI)
    • 其他
  2. 資料庫:使用什麼資料庫儲存訂單?

    • 需要知道如何更新訂單狀態

用戶輸入: $ARGUMENTS

Step 2: 建立 Webhook 端點

建立 POST 端點接收 KryptoGO 的回調通知。

端點路徑建議: /api/payment/callback 或 /webhook/kryptogo

必要行為:

  1. 接收 POST JSON body
  2. 驗證 payment_intent_id 存在於資料庫
  3. 根據 status 更新訂單狀態
  4. 回應 HTTP 200

Step 3: 處理所有支付狀態

必須處理以下 5 種狀態:

狀態處理邏輯
pending通常不會收到此狀態的回調
success更新訂單為已付款,記錄 payment_tx_hash
expired標記訂單為過期
insufficient_not_refunded記錄異常,等待退款
insufficient_refunded記錄退款資訊 refund_tx_hash、refund_amount

Step 4: 實作冪等性

確保同一個 payment_intent_id 的回調不會被重複處理:

  • 檢查訂單是否已經更新為最終狀態
  • 使用 payment_intent_id 作為冪等鍵

Step 5: 測試

  1. 建立一個 Payment Intent(帶 callback_url)
  2. 完成支付後確認端點收到回調
  3. 驗證訂單狀態正確更新
  4. 驗證回應 HTTP 200

Callback Payload 格式

json
{
  "payment_intent_id": "0h39QkYfZps7AUD1xQsj3MDFVLIMaGoV",
  "client_id": "9c5a79fc1117310f976b53752659b61d",
  "fiat_amount": "300.0",
  "fiat_currency": "TWD",
  "payment_deadline": 1715462400,
  "status": "success",
  "payment_chain_id": "arb",
  "symbol": "USDT",
  "crypto_amount": "2.53",
  "payment_tx_hash": "0x1234567890abcdef...",
  "received_crypto_amount": "2.53",
  "aggregated_crypto_amount": "2.50",
  "order_data": {
    "order_id": "uid_12345",
    "item_id": "100"
  },
  "callback_url": "https://example.com/callback",
  "group_key": "buy_stone_with_usdt"
}

重要欄位

欄位說明
payment_intent_id用來比對你資料庫中的訂單
status判斷該做什麼處理
payment_tx_hash成功時的區塊鏈交易 Hash
received_crypto_amount實際收到的加密貨幣金額
aggregated_crypto_amount扣除手續費後的金額
refund_tx_hash退款時的區塊鏈交易 Hash
refund_amount退款金額
order_data你建立 Payment Intent 時傳入的自訂資料

詳細參考文件

© 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 3 other files (references) in plugins/kryptogo-pay/skills/kryptogo-pay-webhook of paid-tw/skills.

  • SKILL.md
  • references/callback-payload.md
  • references/code-examples.md
  • references/troubleshooting.md

Open the folder on GitHubat commit 1cd84bd

Compare with similar skills

Kryptogo Pay Webhook 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.

Kryptogo Pay Webhook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kryptogo Pay Webhook this skillpaid-tw/skills284—~695Automated safety check: NotesMIT
Novu Design Workflownovuhq/novu40k—~2.6kAutomated safety check: PassCustom licence
Golivemikehasa/golive-skill1.3k—~13kAutomated safety check: NotesMIT
Stripe Appsfossasia/eventyay1.7k1 repos~3.6kAutomated safety check: PassApache-2.0
Dingtalk Messageagentscope-ai/ReMe3.6k—~1.6kAutomated safety check: PassApache-2.0
PR Review Provideryansongda/pay5.4k—~2.4kAutomated safety check: PassMIT

Similar skills

  • Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

    40k GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.3k GitHub stars~13k tokensUpdated 6 days ago
    Backend & APIsAuto-check: notes
  • Stripe Apps

    fossasia/eventyay

    A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.

    1.7k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed
  • Dingtalk Message

    agentscope-ai/ReMe

    钉钉消息发送技能。支持企业内部机器人(批量单聊/群聊)和 Webhook 自定义机器人两种接入方式,支持多机器人管理,支持文本、Markdown、链接、ActionCard、FeedCard等多种消息类型。

    3.6k GitHub stars~1.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • PR Review Provider

    yansongda/pay

    A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.

    5.4k GitHub stars~2.4k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Stripe Best Practices

    kanchengw/cnllm

    Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…

    173 GitHub starsUsed in 2 repos~925 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
  • 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
  • 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

Categories

Questions about Kryptogo Pay Webhook

What does Kryptogo Pay Webhook do?

Implements KryptoGO Payment webhook/callback handling for receiving payment status notifications. Kryptogo Pay Webhook is an agent skill from paid-tw/skills. Implements KryptoGO Payment webhook/callback handling for receiving payment status notifications.

When should I use Kryptogo Pay Webhook?

Kryptogo Pay Webhook fits situations like: building webhook endpoints; handling payment callbacks; implementing 支付狀態通知 for KryptoGO Payment.

How do I install Kryptogo Pay Webhook in Claude Code?

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

How do I install Kryptogo Pay Webhook in Codex?

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

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

What does Kryptogo Pay Webhook need to run?

SKILL.md names no scripts, command-line tools or credentials: Kryptogo Pay Webhook is instructions for the agent only. Our summary lists: Python 3; Node.js. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Grep, Glob.

Does Kryptogo Pay Webhook access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kryptogo Pay Webhook safe to install?

Our automated static check of SKILL.md found notes only (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 Kryptogo Pay Webhook use?

Kryptogo Pay Webhook 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 Kryptogo Pay Webhook use?

About 695 tokens (SKILL.md is roughly 2.8k 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 3.3k tokens, read only when the agent opens those files.

What are the alternatives to Kryptogo Pay Webhook?

Skills that share tags, products or a category with Kryptogo Pay Webhook: Novu Design Workflow (novuhq/novu, 40k stars), Golive (mikehasa/golive-skill, 1.3k stars), Stripe Apps (fossasia/eventyay, 1.7k stars) and Dingtalk Message (agentscope-ai/ReMe, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kryptogo Pay Webhook?

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.