Mayar.id印尼支付集成MCP工具，支持创建发票、支付链接、交易追踪及订阅管理，覆盖银行转账、电子钱包、QRIS等本地支付方式。
说明：
## 核心用法
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 完成状态
会员专属
