详细介绍
参数和配置

一、银联 unionpay-mcp-server 简介

  • 定位：银联基于 MCP 协议为 AI 智能体提供的支付工具，支持智能体应用安全接入银联支付能力。
  • 核心场景：
    以行程规划智能体为例，用户输入出行需求后，智能体自动推荐酒店方案，通过银联 MCP Server 生成支付订单，用户完成支付后智能体同步订单信息，实现自动化预订流程。
  • 优势：减少人工操作，提升效率，适用于需集成支付功能的智能体应用（如客服、电商、生活服务等）。

二、使用与配置流程

  1. 前置条件：
    • 注册成为银联网络商户，开通业务权限。
    • 获取商户私钥（用于接口签名和验签）。
  2. 接入方式：
    在支持 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 应用特有风险。
    • 确保接口参数（如证件信息、金额）的合法性和加密传输。
  2. 版本限制：当前为早期版本，功能和配套设施持续优化，建议关注银联官方更新。
  3. 合规要求：遵守《中国银联服务协议》及银联开放平台规范，确保商业行为合法。

六、参考资源

通过以上整理，可快速了解银联 MCP Server 的核心能力、接入流程及接口调用要点，建议结合具体业务场景和银联官方文档进行开发。

官方
为AI智能体提供的支付工具，各类支持MCP协议的智能体应用均可安全、便捷地接入银联支付能力

最新发布

1 天前

开发语言

js

执行环境

本地

价格

免费