mcp-openpay

@codespar/mcp-openpay

适用于 Openpay 的 MCP 服务——这是一家归 BBVA 所有的墨西哥支付网关。

对于墨西哥在线商户，Openpay 是 BBVA 支持的 Conekta 主要替代方案。将它与 @codespar/mcp-conekta 一同加入目录，补全了墨西哥两大网关的支持，并让 Agent 能够使用 BBVA 支付通道（SPEI、OXXO 和本地银行卡）。它在本目录中的差异化功能包括：原生订阅（计划 + 按客户定期扣款）和平台付款。

工具（23 个）

工具	用途
create_charge	创建扣款。
get_charge	检索扣款。
capture_charge	扣取此前已授权的款项（原始扣款使用 capture=false 时）。
refund_charge	退还已扣取的款项。
create_customer	创建客户记录。
get_customer	按 Openpay 客户 ID 检索客户。
list_customers	按可选筛选条件列出客户。
create_card	将银行卡令牌化。
delete_card	删除已令牌化的银行卡。
create_plan	创建订阅计划。
create_subscription	为客户订阅计划。
create_payout	向银行账户支付 MXN。
update_customer	更新已存储的客户（PUT /customers/{id}）。
delete_customer	删除客户（DELETE /customers/{id}）。
get_card	检索已令牌化的银行卡。
list_cards	列出已令牌化的银行卡。
create_bank_account	保存客户银行账户（POST /customers/{customer_id}/bankaccounts）。
delete_bank_account	删除已保存的客户银行账户（DELETE /customers/{customer_id}/bankaccounts/{id}）。
cancel_subscription	取消客户的订阅（DELETE /customers/{customer_id}/subscriptions/{id}）。
list_payouts	列出付款。
create_webhook	注册 Webhook 端点（POST /webhooks）。
list_webhooks	列出已配置的 Webhook 订阅（GET /webhooks）。
delete_webhook	删除 Webhook 订阅（DELETE /webhooks/{id}）。

安装

npm install @codespar/mcp-openpay

环境变量

OPENPAY_MERCHANT_ID="..."  # merchant id (part of the API URL path)
OPENPAY_PRIVATE_KEY="..."  # private API key — secret
OPENPAY_ENV="sandbox"      # 'sandbox' (default) | 'production'

身份验证

HTTP Basic。私钥作为用户名，密码留空：

Authorization: Basic base64(OPENPAY_PRIVATE_KEY + ":")
Content-Type: application/json

服务会自动进行 Base64 编码——你只需配置三个环境变量。

基础 URL

环境	主机
sandbox（默认）	https://sandbox-api.openpay.mx/v1/{merchant_id}
production	https://api.openpay.mx/v1/{merchant_id}

运行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-openpay

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-openpay

作用域说明

Openpay 的若干资源既可在商户作用域下访问，也可在客户作用域下访问。工具通过可选的 customer_id 参数提供此功能：

• create_charge、get_charge、capture_charge、refund_charge — 设置 customer_id 时，路由到 /customers/{customer_id}/...；否则路由到 /...。
• create_card、delete_card — 采用相同模式。
• create_payout — 客户作用域下的付款要求客户设置 requires_account=true。
• create_subscription — API 要求使用客户作用域（计划属于商户作用域；订阅始终按客户创建）。

PCI 范围

建议使用 Openpay.js 在客户端进行令牌化，并将生成的 token_id / source_id 传递给服务端。只有在符合 PCI-DSS 要求时，才能在服务端发送原始 PAN/CVV。

文档

https://documents.openpay.mx/en/api

企业版

需要为 Agent 付款提供治理、预算限额和审计追踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、支付路由和合规模板。

许可证

MIT