mayar-payment

核心用法

mayar-payment 是一个面向印尼市场的支付集成 Skill，通过 MCP（Model Context Protocol）协议连接 Mayar.id 支付平台。核心功能包括：创建带支付链接的发票、追踪交易状态、生成 WhatsApp 友好格式的支付消息、管理订阅会员，以及支持 QRIS、银行转账、GoPay、OVO 等印尼主流支付方式。

使用流程分为三步：首先在 Mayar.id 官网注册并获取 API Token，配置本地凭证文件并设置权限；其次在 mcporter 配置中添加 MCP 服务器，指定远程 SSE 端点和授权头；最后通过 mcporter call 命令调用 15+ 个可用工具，如 create_invoice 生成发票、、get_latest_transactions 查询交易、、get_balance 查看账户余额等。发票创建支持多商品、自定义过期时间、支付后跳转链接等灵活配置，返回的支付链接可直接分享给客户完成付款。

显著优点

本地化支付覆盖全面：深度集成印尼市场主流的 QRIS 扫码支付、各大银行转账、GoPay/OVO/Dana 等电子钱包，无需自行对接多个支付渠道。

WhatsApp 生态无缝融合：内置消息格式化模板，可一键生成带支付链接的 WhatsApp 消息，契合印尼高度依赖 WhatsApp 商业沟通的市场特征。

MCP 架构解耦灵活：基于 Model Context Protocol 设计，与具体 AI 助手实现解耦，理论上可接入任何支持 MCP 的客户端，扩展性强。

文档详尽开箱即用：提供从环境配置、核心工作流到故障排查的完整指南，包含多商品发票、订阅管理、Webhook/轮询两种确认模式等生产级实践。

潜在缺点与局限性

地域限制明显：仅支持印尼市场（IDR 结算、印尼手机号格式），无法直接用于其他国家和地区。

依赖链复杂：需要同时维护 Mayar.id 账户、mcporter 工具链、npx/mcp-remote 运行时，任一环节故障都会影响可用性。

实时性依赖外部配置：官方推荐的生产级方案需要自行搭建 Webhook 接收端，对技术基础设施有一定要求；轮询方案虽简单但存在 30-60 秒延迟。

非官方维护：由社区开发者 clawdbot 维护，非 Mayar.id 官方出品，长期支持和 API 同步更新存在不确定性。

适合的目标群体

• 面向印尼市场的跨境电商卖家和服务提供商
• 需要自动化发票和支付追踪的 SaaS 或订阅制业务
• 已使用 WhatsApp Business 进行客户沟通的企业
• 技术团队具备基础 Node.js/npm 环境配置能力的中小商户

使用风险

凭证泄露风险：API Token 以明文形式存储在本地文件并通过命令行参数传递，若环境配置不当或日志记录未过滤，存在密钥泄露隐患。

网络稳定性依赖：所有支付操作依赖 Mayar.id 云端 API，网络波动或服务中断将直接影响交易处理能力。

合规责任边界：Skill 本身不处理 PCI DSS 敏感数据，但商户仍需自行确保符合印尼本地数据保护法规和客户隐私要求。

版本兼容性：MCP 协议和 Mayar API 均为演进中技术，未来接口变更可能导致 Skill 功能异常，需关注更新维护。