Ton Pay Skill — Development skill for Claude Code

ton-pay-skill

A [Claude Code](https://claude.com/claude-code) skill for integrating [TON Pay](https://docs.ton.org/ecosystem/ton-pay/overview) into web apps, Vanilla JS sites, and Telegram Mini Apps.

**TL;DR:** clone into your Claude Code skills directory, then ask Claude "add TON Pay checkout to this app." **No TON Pay merchant account is required** — the default path uses client-side polling and works with just a TON recipient address. The skill also covers the optional webhook path (HMAC verification + 7-step validation) for apps that want push-based notifications.

What's in the box

Path	What it is
SKILL.md	Skill entry — decision tree, prerequisites, quickstart for 3 frameworks
reference/webhooks.md	HMAC-SHA256 verify, retry, idempotency, 7-step validation
reference/testing.md	Testnet flow, faucet, client-side polling, local tunnel
reference/telegram-mini-app.md	TMA-specific wiring: theme, back button, wallet redirect
reference/onramp.md	Fiat → TON onramp for users without balance
reference/troubleshooting.md	Common pitfalls and fixes
examples/nextjs-app-router/	Runnable Next.js 15 example with webhook route
examples/vanilla-js/	Static HTML client + Express webhook server
examples/telegram-mini-app/	Vite + @telegram-apps/sdk-react example

Install the skill into Claude Code

Option A: clone directly

git clone https://github.com/se