merso-integration

# Merso Integration Skill Merso is a PNPL (Play Now, Pay Later) platform for digital goods for games like NFTs, web2 in-game assets and virtual currency packs. It is not a credit product. It issues software licenses that grant immediate access; the license expires automatically if installment payments stop. Zero KYC, zero underwriting, zero credit risk for the merchant. ## Key references - **Full API + integration guide:** See `references/api.md` - **Commercial context, case studies, and pitch info:** See `references/commercial.md` ## When to load references - Load `references/api.md` for any technical integration task (endpoints, webhooks, DB schema, Node.js config, flow) - Load `references/commercial.md` for pitch preparation, case studies, GMV metrics, or partner context ## Integration checklist 1. Set env vars: `MERSO_ENV`, `MERSO_GAME_ID`, `MERSO_API_KEY` 2. Authenticate → cache Bearer token (auto-renew 30 min before expiry) 3. Implement `POST /merso-buy-item` with a **unique `itemId` per purchase** 4. Register webhook URL via `POST /set-webhook-url` 5. Handle webhook events idempotently (check payment status before crediting) 6. Add fallback: `GET /verify-payment-intent/:id` if webhook doesn't arrive 7. Apply Node.js TLS config (SNI) when connecting through Cloudflare — see `references/api.md` ## Minimum item price: $5