mcpField
M
mcp-payway

mcp-payway

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-payway

mcp-payway 是面向阿根廷卡收单网关 Payway（原 Decidir）的 MCP 服务，提供卡片令牌化、一次性与二次授权收费、分期（cuotas）、分账和退款等 6 个工具。适合需要在阿根廷市场由 Agent 发起卡支付的开发者。

主要功能

  1. 01提供 6 个 Payway 支付工具
  2. 02支持卡片令牌化与单次使用令牌
  3. 03支持一次性收费与两步授权后捕获
  4. 04支持分期付款与分账收费
  5. 05支持全额退款与部分退款

适用场景

  1. 01通过 Agent 对已令牌化的卡片发起收费
  2. 02查询支付记录并处理部分退款
  3. 03在两步授权流程中捕获已授权的支付

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 Payway 的令牌化、收费、查询与退款接口作为工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-payway": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-payway"
      ],
      "env": {
        "PAYWAY_PUBLIC_API_KEY": "<PAYWAY_PUBLIC_API_KEY>",
        "PAYWAY_PRIVATE_API_KEY": "<PAYWAY_PRIVATE_API_KEY>",
        "PAYWAY_ENV": "<PAYWAY_ENV>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-payway
需要配置的环境变量
PAYWAY_PUBLIC_API_KEY密钥Payway PUBLIC apikey — used only by create_token (card tokenization)
PAYWAY_PRIVATE_API_KEY密钥Payway PRIVATE apikey — payments, captures, refunds and queries
PAYWAY_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox' (Decidir sandbox host).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-payway0.1.0

工具

6

收录的工具列表 · 更新于 2 周前

参数类型必填说明
card_numberstring是完整 PAN（卡号）
security_codestring是CVV/CVC
card_holder_namestring是卡面印制的持卡人姓名
card_expiration_yearstring是有效期年份，YY（例如 '27'）
card_expiration_monthstring是有效期月份，MM（例如 '08'）
card_holder_identificationobject否持卡人证件，例如 { type: 'dni', number: '12345678' }
card_holder_identification.typestring否证件类型（dni、cuit 等）
card_holder_identification.numberstring否文件编号

详细介绍

@codespar/mcp-payway

适用于 Payway（前身为 Prisma Medios de Pago / Decidir）的 MCP 服务——阿根廷占主导地位的银行卡收单网关：银行卡令牌化、一步和两步扣款、分期付款（cuotas）、市场平台拆分和退款。

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "payway": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-payway"],
      "env": {
        "PAYWAY_PUBLIC_API_KEY": "your-public-apikey",
        "PAYWAY_PRIVATE_API_KEY": "your-private-apikey",
        "PAYWAY_ENV": "sandbox"
      }
    }
  }
}
Claude Code
claude mcp add payway -- npx @codespar/mcp-payway
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "payway": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-payway"],
      "env": {
        "PAYWAY_PUBLIC_API_KEY": "your-public-apikey",
        "PAYWAY_PRIVATE_API_KEY": "your-private-apikey",
        "PAYWAY_ENV": "sandbox"
      }
    }
  }
}

身份验证

Payway 使用名为 apikey 的单个原始标头进行身份验证（不是 Authorization: Bearer）。有两个权限不同、地位相同的密钥——请参阅下表。

双密钥模式

Payway 会签发两个权限不同、地位相同的 API 密钥：

密钥标头可调用的接口
公钥apikeyPOST /tokens（仅银行卡令牌化）
私钥apikey其他所有接口：付款、捕获、退款、查询

身份验证标头是名为 apikey 的单个原始标头——不是 Authorization: Bearer。

工具（6 个）

工具接口功能
create_tokenPOST /tokens将银行卡数据令牌化为一次性支付令牌（公钥）
create_paymentPOST /payments扣取令牌对应的款项——单笔销售或分配／拆分付款，支持分期付款
get_paymentGET /payments/{id}按 ID 获取付款
list_paymentsGET /payments列出付款（offset、pageSize、siteOperationId、merchantId）
refund_paymentPOST /payments/{id}/refunds全额退款（空请求体）或部分退款（以最小货币单位指定 amount）
confirm_paymentPUT /payments/{id}捕获此前已授权的付款（两步流程）

环境变量

变量必需说明
PAYWAY_PUBLIC_API_KEY是公钥 apikey（令牌化）
PAYWAY_PRIVATE_API_KEY是私钥 apikey（付款、退款、查询）
PAYWAY_ENV否sandbox（默认值，Decidir 沙盒主机）或 production

基础 URL：生产环境 https://ventasonline.payway.com.ar/api/v2，沙盒环境 https://developers.decidir.com/api/v2。

注意事项

  • 金额以最小货币单位的整数表示：50000 = 500.00 阿根廷比索。
  • payment_method_id 用于标识银行卡品牌（1 = Visa，31 = Mastercard，15 = Maestro，……）。
  • site_transaction_id 是商户侧的幂等标识——每笔销售都必须唯一。
  • 此服务绝不会虚构银行卡数据；Agent 必须向用户或保险库收集卡号、有效期和 CVV。

企业版

需要为 Agent 驱动的 Payway 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、付款路由和合规模板。

许可证

MIT © CodeSpar

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。