BML Connect Claude Code Skill

Claude Code Skill — BML Connect

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.

What This Skill Covers

• 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-customers dash 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

Installation

git clone https://github.com/umarey/claude-skill-bml-connect ~/.claude/skills/bml-connect

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

Updating

git -C ~/.claude/skills/bml-connect pull

What's the difference?

Without 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%)

Tested Against

• BML Connect API (March 2026)
• Works with any framework — Node.js, Laravel, Next.js, Django, etc.

Contributing

Found som