A Claude Code skill for integrating with Bank of Maldives (BML) Connect payment API.
When installed, Claude Code automatically knows how to work with BML Connect — correct endpoints, authentication, laari conversion, webhook signature verification, tokenization, and all the quirks that trip up developers.
- Authentication (API key pattern, public vs secret keys)
- Creating and managing transactions (v2 API)
- Webhook handling and signature verification (SHA256, timing-safe)
- Card-on-file / tokenization (two-step charge flow)
- Customer management (
/public-customersdash URL) - QR code and payment link flow
- SMS/Email sending (and the known AWS auth fallback)
- Multi-merchant SaaS patterns
- Local development setup (webhook tunnel vs simulation)
- Money handling (laari/MVR integer conversion)
- MIB bank limitation
- Common pitfalls
git clone https://github.com/umarey/claude-skill-bml-connect ~/.claude/skills/bml-connectThen add this line to your project's CLAUDE.md (or ~/.claude/CLAUDE.md for global access):
@~/.claude/skills/bml-connect/SKILL.md
That's it. Next time you ask Claude Code to integrate BML Connect, it'll know exactly what to do.
git -C ~/.claude/skills/bml-connect pullWithout this skill, Claude guesses BML-specific details and gets them wrong — wrong endpoints, wrong signature formula, no laari conversion, invented header names. With it, Claude gets every detail right:
| Test Case | With Skill | Without Skill |
|---|---|---|
| Express payment integration | 6/6 (100%) | 2/6 (33%) |
| Laravel webhook verification | 5/5 (100%) | 3/5 (60%) |
| Next.js card tokenization | 5/5 (100%) | 0/5 (0%) |
| Overall | 16/16 (100%) | 5/16 (31%) |
- BML Connect API (March 2026)
- Works with any framework — Node.js, Laravel, Next.js, Django, etc.
Found something new about BML Connect? Open a PR. Especially useful:
- New endpoint discoveries
- Auth quirks
- Webhook edge cases
- Sandbox vs production differences
Umar Moosa Fikry