Mayar Payment Integration

核心用法

Mayar Payment Integration 是专为印尼市场设计的 MCP 支付服务，通过 mcporter 命令行工具与 Mayar.id 平台交互，提供完整的支付生命周期管理。

主要功能模块：

1. 发票与支付链接生成 - 使用 mayar.create_invoice 创建带有时效性的支付链接，支持多商品、自定义跳转 URL、过期时间设置
2. 交易状态追踪 - 通过 get_latest_transactions/get_transactions_by_time_period 轮询或 Webhook 实时获取支付状态
3. WhatsApp 集成 - 内置消息模板格式化，可直接发送带支付链接的确认消息
4. 订阅会员管理 - 支持 get_membership_customer_by_specific_product 管理周期性付费产品
5. 客户数据分析 - 提供 get_customer_detail、get_balance 等账户级查询

关键配置要求：

• API Token 需通过 https://web.mayar.id/api-keys 生成
• MCP 服务器配置使用 mcp-remote 连接 https://mcp.mayar.id/sse
• 手机号格式严格要求 ""628xxx""（转义字符串），印尼标准格式 628xxxxxxxxxx

典型工作流程：

创建发票 → 格式化 WhatsApp 消息 → 发送客户 → 轮询/Webhook 确认支付 → 触发后续业务逻辑

显著优点

• 本地化支付全覆盖 - 原生支持印尼主流渠道：银行转账（BCA、Mandiri、BNI 等）、电子钱包（GoPay、OVO、Dana、ShopeePay）、QRIS 统一扫码
• MCP 协议标准化 - 基于 Model Context Protocol，可与 Claude、Cursor 等 AI 编辑器无缝集成，实现自然语言驱动的支付操作
• 低代码 WhatsApp 集成 - 提供现成消息模板，无需额外开发即可发送专业级支付提醒
• 沙盒环境 - 提供 mayar.club 测试环境，支持完整功能验证后再切生产
• 订阅原生支持 - 内置会员系统工具，无需自行实现计费周期管理

潜在局限与风险

技术层面：

• 轮询效率问题 - 文档推荐的轮询方案（30-60秒间隔）对高并发场景不够实时，WebSocket 缺失
• 手机号格式陷阱 - 双重转义要求（"\"628xxx\""）极易导致 400 错误，缺乏输入验证自动修正
• MCP 依赖链 - 需同时维护 mcporter CLI、mcp-remote npm 包、Mayar SSE 端点三层稳定性

业务层面：

• 地域锁定 - 仅印尼盾（IDR）结算，国际业务需额外换汇层
• 退款/争议处理 - 文档未提及退款 API 或争议仲裁流程，需人工介入
• 费率不透明 - 未在文档中披露交易手续费结构

安全风险：

• API Token 以明文形式存储在 ~/.config/mayar/credentials，权限仅 600 但无密钥轮换机制
• 支付链接基于可预测的 slug 结构，存在枚举风险（虽需登录态）

适合人群

| 场景 | 匹配度 |

|------|--------|

| 印尼本土电商/服务自动化收款 | ⭐⭐⭐⭐⭐ |

| 需要 WhatsApp 私域运营的中小商家 | ⭐⭐⭐⭐⭐ |

| 已有 MCP 工作流的 AI-Native 应用 | ⭐⭐⭐⭐⭐ |

| 多币种国际业务 | ⭐⭐⭐ |

| 高频实时交易（>100 TPS） | ⭐⭐ |

常规风险提示

• Token 泄露 - Mayar API Token 具备完整账户权限，泄露可导致资金损失，建议配合短期凭证或子账户机制（如支持）
• 时区处理 - expiredAt 需严格 ISO 8601 带时区格式，跨时区部署易引发过期争议
• Webhook 可靠性 - 生产环境务必配置Webhook回退方案，避免单点故障导致订单状态丢失
• 合规要求 - 印尼金融交易需符合 BI（印尼央行）监管，大额业务建议确认 KYC 完成状态