Bayarcash MCP Server

Bayarcash MCP服务器💳

使用AI管理Bayarcash付款。创建支付链接，检查交易，并使用自然语言集成支付处理。

](https://smithery.ai/server/@khairulimran-97/bayarcash-mcp-server) ](https://www.npmjs.com/package/@webimpian/bayarcash-mcp-server) 

快速安装

Smithery（最简单）：

npx -y @smithery/cli install @khairulimran-97/bayarcash-mcp-server --client claude

手动设置： 添加到配置文件(~/.config/claude-code/mcp_settings.json):

{
  "mcpServers": {
    "bayarcash": {
      "command": "node",
      "args": ["/path/to/bayarcash-mcp-server/build/index.js"],
      "env": {
        "BAYARCASH_API_TOKEN": "your_token",
        "BAYARCASH_API_SECRET_KEY": "your_secret",
        "BAYARCASH_SANDBOX": "true"
      }
    }
  }
}

从获取您的API证书https://console.bayar.cash → 设置→ API

有关详细的使用示例和工作流程，请参阅 用法.md.

你能做什么

自然地与你的AI对话。AI将引导您完成智能工作流程：

智能支付创建

"Create a payment for RM 100"

AI将自动：

1. 询问您是否要使用上次付款的电子邮件（如果可用）
2. 显示您的支付门户并询问使用哪一个
3. 显示付款渠道并询问使用哪一个
4. 询问是否要包含电话号码（可选）
5. 创建付款并存储付款意图ID

快速付款支票

"Check status of that payment"
"Show me the payment I just created"

AI使用存储的支付意图ID来检查状态。

智能交易筛选

"Show all transactions"

AI会问：“根据上次付款的电子邮件进行筛选：test@example.com?"

更多示例：

"Create payment for RM 50 with portal abc123 using FPX"
"List all successful FPX payments today"
"Find transactions for customer@example.com"
"What payment channels are available?"
"Show me FPX banks"

特性

8种可用工具：

• create_payment_intent -使用指导工作流程创建付款
• get_payment_intent -通过付款意图ID获取付款状态
• get_transaction -按ID获取交易
• get_transaction_by_order -按订单号查找交易
• list_transactions -使用智能筛选列出交易
• get_portals -列出您的支付门户
• get_payment_channels -列出可用的支付渠道（10个渠道）
• get_fpx_banks -列出FPX网上银行

支付渠道（按ID）：

1. FPX-网上银行（20+家银行）
2. DuitNow-二维码支付
3. Boost-电子钱包
4. GrabPay-电子钱包
5. Touch'n Go-电子钱包
6. ShopeePay-电子钱包
7. SPayLater-BNPL
8. Boost PayFlex-BNPL
9. QRIS-QR支付
10. NETS-卡支付

智能功能：

• ✅ 引导式支付创建工作流程
• ✅ 自动提示上次付款的电子邮件
• ✅ 自动建议按上次付款电子邮件进行筛选
• ✅ 存储付款意图ID以进行快速状态检查
• ✅ 沙盒和生产环境
• ✅ API v3支持（始终为最新版本）
• ✅ 带过滤器的分页交易列表
• ✅ 输入验证（电子邮件、电话、金额）
• ✅ 全面的错误处理
• ✅ 完全TypeScript类型安全

配置

环境变量：

注： 服务器始终使用API v3（最新版本）。无需指定版本。

用例

对于开发者：

"Help me integrate Bayarcash in my Laravel app"
"Create a test payment for RM 50"
"Show me payment channels for my portal"

商务方面：

"Show all successful payments today"
"Find transactions for customer@example.com"
"What's the total revenue from FPX this week?"

有关更详细的示例和工作流程，请参阅 用法.md.

故障排除

服务器未连接？

1. 完全重新启动AI客户端
2. 在验证API凭据https://console.bayar.cash
3. 检查配置文件路径是否为绝对路径（非相对路径）
4. 跑 npm run build 在服务器目录中

身份验证错误？

• 确保 BAYARCASH_SANDBOX 匹配您的帐户类型
• 验证API令牌/机密中没有额外的空格
• 尝试重新生成凭据

验证错误？

• 电子邮件格式必须有效
• 电话号码必须是马来西亚格式：60123456789（以60开头）
• 金额必须为正数，最多保留2位小数
• 支付渠道必须为1-10
• 状态代码必须为0-4

正在获取API错误？

• 服务器为调试提供详细的错误消息
• 检查错误消息以了解特定的验证失败
• 使用 get_payment_channels 查看可用选项

链接

• 史密斯利市场： https://smithery.ai/server/@khairulimran-97/bayarcash mcp服务器
• 存储库： https://github.com/khairulimran-97/bayarcash-mcp-server
• 庆祝活动 ： https://bayar.cash
• MCP文件： https://modelcontextprotocol.io
• 问题： https://github.com/khairulimran-97/bayarcash-mcp-server/issues

许可证

MIT许可证-请参阅 许可证