mcp-izipay

@codespar/mcp-izipay

Izipay 的 MCP 服务，面向秘鲁的企业级收单机构。

Izipay 是 Niubiz（Visa 与秘鲁银行的合资企业）面向商户的品牌。Niubiz/Izipay 是秘鲁最大的银行卡收单机构，市场份额超过 20%。对于交易量可观的大型企业商户，Niubiz/Izipay 是默认选择，他们会与收单机构直接签约。

与 Culqi 的定位对比

	@codespar/mcp-culqi	@codespar/mcp-izipay
客群	秘鲁中小企业	秘鲁大型企业
类型	PSP（类似 Stripe）	收单机构（Niubiz）
入驻方式	自助开通	商务合同
客户	D2C、SaaS、初创公司	连锁零售、航空公司、公用事业、银行

交易量可观的秘鲁商户通常会先与 Izipay 签订收单合同，再采用 PSP——客户、合同和商务条款都各不相同。这两个服务相辅相成。

状态：alpha

这是 0.1.0-alpha.1。Izipay 的开发者门户 developers.izipay.pe 需要签约才能访问——公开主页介绍了 API，但完整的 REST 参考文档仅向签约商户开放。本服务中的端点路径是根据 Izipay 的公开 SDK 仓库（github.com/izipay-pe）和常见的 Niubiz/Izipay REST 约定尽力推断的。上线前应根据你的集成套件验证以下每个端点，欢迎通过 PR 提交更正。

推测的端点（未经验证）

工具	方法	路径
auth（内部）	POST	/auth/login
create_charge	POST	/v1/charges
capture_charge	POST	/v1/charges/{id}/capture
cancel_charge	POST	/v1/charges/{id}/cancel
refund_charge	POST	/v1/charges/{id}/refund
get_charge	GET	/v1/charges/{id}
tokenize_card	POST	/v1/tokens
delete_token	DELETE	/v1/tokens/{id}
create_installment_plan	POST	/v1/installments
list_transactions	GET	/v1/transactions
get_settlement	GET	/v1/settlements/{date}

工具（20 个）

工具	用途
create_charge	授权银行卡付款。
capture_charge	扣款一笔先前已授权的款项（在调用 create_charge 时使用了 capture=false）。
cancel_charge	撤销一笔已授权但尚未扣款的款项。
refund_charge	退还一笔已扣款的款项。
get_charge	根据 Izipay 交易 ID 查询一笔款项。
tokenize_card	将银行卡令牌化，以便安全地重复使用并符合 PCI 标准。
delete_token	删除已存储的银行卡令牌。
create_installment_plan	为一笔款项创建秘鲁 cuotas（分期付款）计划。
list_transactions	列出交易以便对账。
get_settlement	获取指定日期的每日结算批次（liquidación）。
get_charge_by_order	根据商户端的 orderNumber 查询一笔款项（即传递给 create_charge 的 order_id）。
list_installment_options	根据银行卡 BIN 和金额查询可用的分期付款计划。
list_settlements	列出指定日期范围内的结算批次。
create_payment_link	创建托管式付款链接（通过链接付款）。
get_payment_link	根据 ID 查询付款链接。
pay_yape	发起 Yape 直接付款。
pay_plin	发起 Plin 直接付款。
authenticate_3ds	完成 3-D Secure 验证。
create_subscription	开始周期性银行卡扣款（订阅）。
cancel_subscription	取消有效订阅。

安装

npm install @codespar/mcp-izipay@alpha

环境

IZIPAY_USERNAME="..."       # merchant username
IZIPAY_PASSWORD="..."       # merchant password (secret)
IZIPAY_MERCHANT_CODE="..."  # codigoComercio
IZIPAY_ENV="production"     # or "sandbox"
IZIPAY_BASE_URL="..."       # Optional override

默认值：

• IZIPAY_ENV=production → https://api.izipay.pe
• IZIPAY_ENV=sandbox → https://sandbox-api.izipay.pe

身份验证

JWT Bearer。首次调用 API 时，服务会向 /auth/login 发送 { username, password, merchantCode }，并将返回的 JWT 缓存到内存中；之后的每次请求都会附带 Authorization: Bearer <jwt>。缓存的 JWT 会在过期前 60 秒刷新。调用方无需处理这些细节。

运行

# stdio (default)
npx @codespar/mcp-izipay

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-izipay

企业版

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

许可证

MIT