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 INLINECODE0
- Commercial context, case studies, and pitch info: See INLINECODE1
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, INLINECODE6 - Authenticate → cache Bearer token (auto-renew 30 min before expiry)
- Implement
POST /merso-buy-item with a unique itemId per purchase - Register webhook URL via INLINECODE9
- Handle webhook events idempotently (check payment status before crediting)
- Add fallback:
GET /verify-payment-intent/:id if webhook doesn't arrive - Apply Node.js TLS config (SNI) when connecting through Cloudflare — see INLINECODE11
Minimum item price: $5
Merso 集成技能
Merso 是一个面向游戏数字商品（如NFT、Web2游戏内资产和虚拟货币包）的PNPL（先玩后付）平台。它并非信贷产品。该平台发放软件许可，授予即时访问权限；如果分期付款中断，许可将自动过期。零KYC、零承保、零信用风险，对商家而言。
关键参考资料
- - 完整API + 集成指南： 参见 references/api.md
- 商业背景、案例研究和推介信息： 参见 references/commercial.md
何时加载参考资料
- - 任何技术集成任务（端点、Webhook、数据库模式、Node.js配置、流程）加载 references/api.md
- 推介准备、案例研究、GMV指标或合作伙伴背景加载 references/commercial.md
集成检查清单
- 1. 设置环境变量：MERSOENV、MERSOGAMEID、MERSOAPI_KEY
- 身份验证 → 缓存Bearer令牌（到期前30分钟自动续期）
- 实现 POST /merso-buy-item，每次购买使用唯一的 itemId
- 通过 POST /set-webhook-url 注册Webhook URL
- 幂等处理Webhook事件（在记账前检查支付状态）
- 添加备用方案：如果Webhook未到达，使用 GET /verify-payment-intent/:id
- 通过Cloudflare连接时应用Node.js TLS配置（SNI）——参见 references/api.md
最低商品价格：5美元
