核心功能与用法
Mayar Payment 是专为印尼市场设计的支付网关 MCP 技能，通过 mcp-remote 协议连接 Mayar.id 平台，为 Claude 等 AI 助手提供完整的印尼本地化支付能力。
核心工作流：
1. 发票生成 — 调用 mayar.create_invoice 创建带支付链接的电子发票，支持多商品条目、自定义过期时间、支付后重定向
2. WhatsApp 集成 — 将生成的 invoice.link 嵌入格式化消息模板，实现「一键发单-客户扫码支付」闭环
3. 状态追踪 — 通过 get_latest_transactions 轮询或 webhook 实时获取支付状态，支持按时间区间、客户、商品筛选
4. 订阅管理 — 内置会员/周期扣款工具 get_membership_customer_by_specific_product，支持 SaaS 订阅场景
技术亮点：
- 原生支持印尼主流支付方式：银行转账（BCA、Mandiri、BNI 等）、电子钱包（OVO、DANA、GoPay、ShopeePay）、QRIS 统一扫码
- 手机号字段强制格式
"\"628xxx\""（转义双引号包裹），符合印尼 +62 区号规范 - 沙盒/生产环境隔离，API 基址分别为
mayar.club（测试）与mayar.id（正式）
显著优点
- 本土化深度：唯一针对印尼市场优化的 MCP 支付技能，QRIS 覆盖率、银行通道完整性远超国际网关（Stripe/PayPal 在印尼支持有限）
- 低代码集成：无需自建后端，通过
mcporter直接调用 15+ 原子化工具，发票创建到支付通知全流程自动化 - WhatsApp 原生：印尼最大即时通讯渠道，技能提供完整消息模板示例，转化率高于邮件/短信
- 订阅友好：内置会员查询与周期管理，适合印尼数字内容、SaaS、社群付费场景
局限与风险
功能局限：
- 地域锁定：仅支持印尼盾（IDR）与印尼本地支付方式，跨境多币种需求需搭配其他网关
- Webhook 配置复杂：文档未提供 webhook 注册细节，生产环境需自行对接 Mayar 后台
- 错误处理薄弱：示例代码缺乏重试、幂等、异常熔断机制，高并发场景需开发者补充
安全风险：
- 凭证暴露：API Token 以明文形式存储于
~/.config/mayar/credentials并通过--header传递，存在命令历史、进程列表泄露风险 - 轮询压力：文档推荐的「每 30-60 秒轮询」模式在订单量大时可能触发 API 限流或额外计费
- 沙盒与生产混淆：环境切换依赖手动修改 URL，缺乏强隔离机制，易误操作导致测试数据污染生产
适合人群
- 面向印尼市场的独立开发者、DTC 电商运营者
- 需要快速搭建 WhatsApp 私域收款流程的中小商家
- 印尼 SaaS/内容创作者寻求订阅自动化方案
常规风险提醒
| 风险类型 | 说明 |
|---------|------|
| 合规性 | 需确保符合印尼央行（BI）电子支付 regulations，Mayar 已持牌但使用者需完成 KYC |
| 资金安全 | 技能本身不托管资金，但 API Token 泄露可能导致恶意退款、虚假发票创建 |
| 数据隐私 | 客户手机号、交易金额流经 MCP 通道，需确认 Mayar.id 数据本地化存储政策 |
| 服务连续性 | Mayar.id 为第三方平台，存在服务中断、费率调整、API 变更等外部依赖风险 |
建议生产环境启用 IP 白名单、轮换 API Token、使用 webhook 替代高频轮询，并在正式收款前完成沙盒全流程验证。