{"id":"7d0b8db8-2aed-4e7f-9211-4fd9e9fe0025","slug":"qpay-skills","kind":"skill","name":"qpay-skills","summary":"Claude skill that helps Mongolian devs integrate QPay end-to-end — credentials, .env, sandbox testing, and stack-specific code for Next.js, Node, Python, Laravel","owner":"dokind","repoUrl":"https://github.com/dokind/qpay-skills","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-05-05T13:57:08.000Z","addedAt":"2026-10-21T13:16:05.331Z","logoUrl":"https://avatars.githubusercontent.com/u/60846467?u=9334e28b549ec01cdfac696489c8434c194f4be3&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools"],"tags":["claude","claude-code","mnt","mongolia","payments","qpay","golomt","khan-bank"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-23T05:43:03.055Z","sample":false,"url":"https://conduits.dev/tools/qpay-skills","language":"","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# qpay-skills\n\nA Claude skill that helps Mongolian developers integrate **QPay** — Mongolia's QR payment system — into their project end-to-end.\n\n🇲🇳 [Монголоор унших →](./README.mn.md)\n\n---\n\n## What it does\n\nTell Claude something like:\n\n- \"I want to add QPay to my Next.js app\"\n- \"Хэрхэн QPay-г миний апп-д холбох вэ?\"\n- \"How do I accept payments from Mongolian customers?\"\n\n…and Claude walks through:\n\n1. **Detects your stack** — reads `package.json` / `composer.json` / `requirements.txt` and picks the right framework patterns\n2. **Sets up `.env`** — appends QPay variables without overwriting what's already there; updates `.env.example` and `.gitignore`\n3. **Asks for credentials** — `username`, `password`, `invoice_code`, `callback_url`. If you don't have them yet, walks you through QPay merchant onboarding\n4. **Generates working code** — auth client with token caching, invoice creation endpoint, webhook handler, status polling endpoint\n5. **Sets up local testing** — ngrok command, end-to-end test flow, what to look for in the response\n6. **Goes live** — production checklist before you flip the switch\n\nEnd state: QPay actually charging payments in your project. Not a plan, not a snippet — a working integration.\n\nSupported stacks: **Next.js** (App Router & Pages), **Node/Express/Fastify/NestJS**, **Python** (FastAPI/Django/Flask), **PHP/Laravel**. Other stacks (Go, Rust, Ruby, .NET) fall back to the raw API reference.\n\n---\n\n## Install\n\nThree ways, depending on which Claude product you use.\n\n### Option 1 — Claude Code plugin (one-line install)\n\nIn a Claude Code session:\n\n```bash\n/plugin marketplace add dokind/qpay-skills\n/plugin install qpay-integration@qpay-skills\n```\n\nAfter install, run `/reload-plugins`. The skill activates automatically when you mention QPay.\n\n### Option 2 — Claude.ai (web / desktop / mobile)\n\n1. Download [`qpay-integration.skill`](./qpay-integration.skill) (or grab it from [Releases](../../releases))\n2. In Claude.ai: **Settings → Capabilities** → enable **Code execution and file creation**\n3. **Settings → Customize → Skills** → click **Upload skill** → select the `.skill` file\n4. The skill is now available — Claude uses it whenever you mention QPay\n\nAvailable on Pro, Max, Team, and Enterprise plans.\n\n### Option 3 — Manual install (any Claude environment)\n\n```bash\ngit clone https://github.com/dokind/qpay-skills.git\ncp -r qpay-skills/qpay-integration ~/.claude/skills/\n```\n\nFor Claude Code project-scoped install (skill applies only to one repo):\n\n```bash\ncp -r qpay-skills/qpay-integration <your-project>/.claude/skills/\n```\n\n---\n\n## What's inside the skill\n\n- A locked-down **QPay v2 API reference** so Claude doesn't hallucinate endpoints\n- **Stack-specific reference files** for Next.js, Express, FastAPI/Django, Laravel\n- A **bilingual MN/EN credentials guide** for QPay merchant onboarding\n- A **troubleshooting reference** covering every common failure mode\n- A `webhook-testing.md` walkthrough for ngrok-based local testing\n\n---\n\n## What you'll need from QPay\n\nBefore the integration can run, you need a QPay merchant account:\n\n- A registered Mongolian business (`ААН`) or individual merchant registration\n- A bank account at a QPay-supporting bank (Khan, Golomt, State, Xac, TDB, Capitron, etc.)\n- A signed merchant contract with QPay\n- API credentials (`username`, `password`, `invoice_code`) emailed to you after onboarding\n\nOnboarding typically takes 3–10 business days. The skill includes a step-by-step bilingual guide — see [`qpay-integration/assets/credentials-guide.md`](./qpay-integration/assets/credentials-guide.md).\n\n---\n\n## Contributing\n\nIssues and PRs welcome. If you've shipped a real QPay integration with this skill, open an issue describing what worked and what didn't — feedback drives iteration.\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\nThis skill bundles instructions and code patterns. It does not bundle QPay's IP, API keys, or anything proprietary. The QPay name and logo are property of QPay LLC. This project is unaffiliated with and not endorsed by QPay.\n\n---\n\nBuilt and maintained by [Solo Spark Ventures](https://solospark.mn) · [@realNamsrai](https://youtube.com/@realNamsrai)\n"}