mayar-payment

Mayar Payment Integration 是一套基于 MCP（Model Context Protocol）协议的印尼本地化支付集成方案，通过连接 Mayar.id 官方支付平台，为开发者提供完整的 Invoice 生成、支付链接创建、交易状态追踪及会员管理功能。

核心用法方面，该技能主要通过 mcporter 工具调用 Mayar 官方 MCP 服务器（https://mcp.mayar.id/sse）实现操作。最基础的工作流是创建支付 Invoice：通过 mayar.create_invoice 工具传入客户信息、商品明细、过期时间等参数，系统返回包含支付链接的 JSON 数据，客户可通过该链接完成 QRIS、银行转账或电子钱包（OVO、GoPay 等）支付。此外还支持通过 get_latest_transactions 轮询或 Webhook 方式追踪支付状态，利用 WhatsApp 集成模式发送格式化支付消息，以及通过会员工具管理订阅制产品的续费与状态查询。

显著优点包括：第一，深度本地化，全面覆盖印尼主流支付方式（QRIS、Virtual Account、E-Wallet），这是其他国际支付网关难以比拟的；第二，标准化集成，基于 MCP 协议设计，可与 Claude 等 AI 助手无缝衔接，实现自然语言驱动的支付操作；第三，文档详尽实用，不仅提供基础 API 调用示例，还包含 WhatsApp 消息格式化、多商品 Invoice 计算、沙盒/生产环境切换等生产级指导；第四，支持自动化工作流，可轻松嵌入电商机器人、自动开票系统和订阅管理服务。

潜在缺点与局限性方面，首先地域限制明显，Mayar.id 仅支持印尼本地支付渠道，不适用于国际业务；其次依赖链较长，需要用户预先安装配置 mcporter 并妥善管理 API Token，技术门槛高于纯 SaaS 方案；第三，来源可信度为 T3 级（个人开发者），虽经安全审计无恶意代码，但长期维护和官方支持存疑；最后，实时支付通知需依赖外部 Webhook 或主动轮询，在极高并发场景下可能需要额外架构设计。

适合的目标群体主要包括：印尼本土电商开发者、数字产品与服务提供商、需要集成 WhatsApp/Telegram 支付机器人的企业、以及希望自动化 Invoice 流程的中小型企业。特别适合已有 MCP 环境、需要快速接入印尼本地支付能力的开发团队。

使用风险提醒：用户需自行妥善保管 MAYAR_API_TOKEN，建议按文档要求设置 600 权限存储于 ~/.config/mayar/credentials；务必区分沙盒环境（mayar.club）与生产环境（mayar.id），避免测试数据污染真实账务；由于依赖外部 MCP 服务器，需确保网络可访问 https://mcp.mayar.id/sse，并关注 Mayar 官方服务可用性；移动端号码格式需严格遵循 "628xxx" 转义格式，否则将导致 Invoice 创建失败。