qpay-skills

qpay-skills

A Claude skill that helps Mongolian developers integrate QPay — Mongolia's QR payment system — into their project end-to-end.

🇲🇳 Монголоор унших →

What it does

Tell Claude something like:

• "I want to add QPay to my Next.js app"
• "Хэрхэн QPay-г миний апп-д холбох вэ?"
• "How do I accept payments from Mongolian customers?"

…and Claude walks through:

1. Detects your stack — reads package.json / composer.json / requirements.txt and picks the right framework patterns
2. Sets up .env — appends QPay variables without overwriting what's already there; updates .env.example and .gitignore
3. Asks for credentials — username, password, invoice_code, callback_url. If you don't have them yet, walks you through QPay merchant onboarding
4. Generates working code — auth client with token caching, invoice creation endpoint, webhook handler, status polling endpoint
5. Sets up local testing — ngrok command, end-to-end test flow, what to look for in the response
6. Goes live — production checklist before you flip the switch

End state: QPay actually charging payments in your project. Not a plan, not a snippet — a working integration.

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

Install

Three ways, depending on which Claude product you use.

Option 1 — Claude Code plugin (one-line install)

In a Claude Code session:

/plugin marketplace add dokind/qpay-skills
/plugin install qpay-integration@qpay-skills

After install, run /reload-plugins. The skill activates automatically when you mention QPay.

Option 2 — Claude.ai (web / desktop / mobile)

1. Download qpay-integration.skill (or grab it from Releases)
2. In Claude.ai: Settings → Capabilities → enable Code execution and file creation
3. Settings → Customize → Skills → click Upload skill → select the .skill file
4. The skill is now available — Claude uses it whenever you mention QPay

Available on Pro, Max, Team, and Enterprise plans.

Option 3 — Manual install (any Claude environment)

git clone https://github.com/dokind/qpay-skills.git
cp -r qpay-skills/qpay-integration ~/.claude/skills/

For Claude Code project-scoped install (skill applies only to one repo):

cp -r qpay-skills/qpay-integration <your-project>/.claude/skills/

What's inside the skill

• A locked-down QPay v2 API reference so Claude doesn't hallucinate endpoints
• Stack-specific reference files for Next.js, Express, FastAPI/Django, Laravel
• A bilingual MN/EN credentials guide for QPay merchant onboarding
• A troubleshooting reference covering every common failure mode
• A webhook-testing.md walkthrough for ngrok-based local testing

What you'll need from QPay

Before the integration can run, you need a QPay merchant account:

• A registered Mongolian business (ААН) or individual merchant registration
• A bank account at a QPay-supporting bank (Khan, Golomt, State, Xac, TDB, Capitron, etc.)
• A signed merchant contract with QPay
• API credentials (username, password, invoice_code) emailed to you after onboarding

Onboarding typically takes 3–10 business days. The skill includes a step-by-step bilingual guide — see qpay-integration/assets/credentials-guide.md.

Contributing

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

License

MIT — see LICENSE.

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

Built and maintained by Solo Spark Ventures · @realNamsrai