一、银联 unionpay-mcp-server 简介

• 定位：银联基于 MCP 协议为 AI 智能体提供的支付工具，支持智能体应用安全接入银联支付能力。

• 核心场景：以行程规划智能体为例，用户输入出行需求后，智能体自动推荐酒店方案，通过银联 MCP Server 生成支付订单，用户完成支付后智能体同步订单信息，实现自动化预订流程。

• 优势：减少人工操作，提升效率，适用于需集成支付功能的智能体应用（如客服、电商、生活服务等）。

二、使用与配置流程

1. 前置条件：

• • 注册成为银联网络商户，开通业务权限。

• • 获取商户私钥（用于接口签名和验签）。

1. 接入方式：在支持 MCP 协议的客户端应用（如智能体平台）中，调用银联 MCP Server 提供的支付接口。

三、支持的支付工具与接口

1. 签约支付类接口

接口名称	描述	核心参数	输出结果
create-contract-order-unionpay-payment	创建签约支付订单，返回授权签约链接。	orderId、txnTime、certifTp、certifId、customerNm、phoneNo	code、msg、contractUrl（签约链接）
create-contract-unionpay-payment	发起签约交易，返回签约信息（仅需执行一次，支持后续多次支付）。	orderId、txnTime、origOrderId、origTxnTime、tokenType	token（签约协议 ID）、tokenEnd（失效时间）、cardContractInfo（银行卡信息）
pay-contract-order-unionpay-payment	创建签约支付订单，返回支付结果。	orderId、txnTime、token（签约 token）、txnAmt、currencyCode	code、msg、orderId（支付订单 ID）

2. 辅助与管理类接口

接口名称	描述	核心参数	输出结果
contract-pay-sms	支付前发送短信验证（需短信验证时调用）。	orderId、txnTime、token、txnAmt	code、msg、contractUrl（可能返回签约链接）
refund-contract-order-unionpay-payment	发起退货，返回退货结果。	orderId、txnTime、origOrderId、origTxnTime、txnAmt（退货金额）	code、msg、orderId（退货订单 ID）
query-unionpay-payment	查询交易状态（支持签约、支付、退款等）。	orderId、txnTime	transStatus（交易状态）、txnAmt、tokenInfo、origBizMethod（原始交易类型）
cancel-contract-order-unionpay-payment	解约（反向签约操作）。	orderId、txnTime、token（签约 token）	code、msg、orderId（解约订单 ID）

3. 平台商户 / 收单机构额外参数

除 query-unionpay-payment 外，其他接口需根据接入角色补充以下字段：

• 收单机构：merCatCode（商户类别）、merName（商户名称）、merAbbr（商户简称）。

• 平台商户：subMerId（二级商户代码）、subMerName（二级商户名称）、subMerAbbr（二级商户简称）。

四、支付方式选择建议

在智能体的 Prompt 中需明确使用场景，以便 LLM 匹配合适的支付接口：

• 网页支付（PC 端）：需展示支付二维码，适用于桌面软件或 PC 网站。

• 手机支付（移动端）：直接在手机网页发起在线付款，适用于 H5 页面或移动端应用。

五、注意事项

1. 安全风险：

• • 防范 Prompt 攻击、接口命令注入等 AI 应用特有风险。

• • 确保接口参数（如证件信息、金额）的合法性和加密传输。

1. 版本限制：当前为早期版本，功能和配套设施持续优化，建议关注银联官方更新。

1. 合规要求：遵守《中国银联服务协议》及银联开放平台规范，确保商业行为合法。

六、参考资源

• 银联开放平台签约支付产品：银联签约支付-业务产品- 中国银联开放平台

• 银联开发者使用规范：OpenAPI接入指南- 中国银联开放平台

• 服务协议：银联用户服务协议-中国银联业务网站

七、集成方式

推荐使用新器集Smcphub.com的MCP客户端。主要有以下几个优点，同时也是解决了如今MCP的几个痛点：

1. 不同的MCP Server认证方式多样
2. 编程语言多样化，有时候找到了想要的MCP Server，却无法集成到应用中
3. 还有老生常谈的问题，多个MCP Server的可维护性不好，降低开发效率
4. 没有调用日志，无法知晓MCP Server到底做了什么，甚至报错了也不知道原因
5. 各个MCP Server的实现方式不一，有的通过命令行参数启动，有的通过环境变量，有的直接输出所有结果，有的通过SSE方式
6. 就算集成了，也无法知晓用户的调用日志，也就没办法做后续的数据统计分析
7. 还有如果客户端集成MCP Server会增加应用程序打包尺寸，特别是手机应用客户端的大小