更新时间：2025-04-14 22:29:33收藏订阅更新我的文档设置返回文档1 产品介绍智能体开发者现在可以通过支付宝 支付 mcp server 轻松接入收单支付服务。目前已在移动及网站场景下提供了支付服务、支付查询、退款及退款查询等功能。作为国内首家支持 mcp 协议的支付机构，当前的 mcp server 仅是我们 ai 支付服务的第一步，后续支付宝将持续发布更多面向智能体的产品，我们期待与开发者一起探索 ai 支付的无限可能，共同打造更智能、更便捷的支付体验。说明：使用中遇到任何问题，可根据 指引，联系凯发k8官方网娱乐官方。2 注意事项●为了对密钥的安全有效管理，请妥善保管你的私钥，您可在本地部署 mcp server 时进行配置，请勿将私钥托管给三方平台。●我们建议您为 ai 智能体研发申请独立的开放平台应用，以实现智能体与非 agent 研发业务系统的安全隔离。●商户订单号作为支付系统中商户交易的唯一标识，开发者需要确保其有效性（例如从真实的商户订单系统中获取），并在支付流程中正确传递。●本文档提供的例子经过简化，在生产场景中，您需要合理使用 agent 服务，防范 prompt injection 等风险。●本服务工具支持配置使用，默认均允许调用，建议您根据使用场景仅开放必要工具供 agent 调用，详见快速开始章节 ap_select_tools 说明。●由于 agent 的行为是非确定性的，我们建议您进行充分的测试，以确保服务的可靠性和安全性。●本凯发k8官方网娱乐官方的服务支持沙箱环境，建议先通过沙箱进行调试，可降低您的测试成本。3 能力介绍●创建支付○开发者可以根据agent所处环境，灵活选择创建手机支付或网页支付订单。○输入:■outtradeno*创建订单参数-商户订单号。■totalamount*该订单的支付金额，以元为单位。■ordertitle*该订单的订单标题。○输出：支付链接。●查询支付○通过接收商户订单系统查询指令，返回交易支付状态信息。○输入:■outtradeno*商户订单号。○输出：支付宝交易号、交易状态、交易金额。●发起退款○通过接收商户订单系统退款指令，对交易进行退款操作。○输入:■outtradeno*商户订单号。■refundamount*退款金额。■outrequestno*退款请求号。■refundreason退款原因。○输出：支付宝交易号、退款结果。●查询退款信息○通过接收商户订单系统退款查询指令，返回该笔交易退款操作基础信息。○输入：■outrequestno*退款请求号。■outtradeno*商户订单号。○输出：支付宝交易号、退款金额、退款状态。4 使用准备1登录 支付宝开放平台 创建 ，完成相关配置并上线。详情可查看 创建应用、上线应用。2登录 商家平台 > ，请根据您的应用环境，选择 手机网站支付 或者 电脑网站支付 ，填写并提交相关信息完成产品开通。详情可查看 开通产品。5 快速开始任意支持 mcp 协议的平台（如：cline、claude、cursor）都可简单接入支付 mcp server，下文为 cline 接入指南。说明：目前支持 node.js。5.1 通过node.js接入5.1.1 安装 node.js下载适用于操作系统的 。5.1.2 在cline中配置1安装 。 2配置 mcp server。 3打开 cline_mcp_settings.json 文件，进行以下配置。完整环境变量说明如下，开发者可按需设置：变量key变量含义是否可选示例值ap_app_id商户在开放平台申请的 appid。必填2021xxxxxxxx8009ap_app_key商户在开放平台设置的 私钥。必填miievw.....ko71sa==ap_pub_key商户在开放平台的 支付宝服务端公钥。必填miibija......aqabap_encryption_algo商户在开放平台配置的接口加签方式，默认 rsa2 无需设置，如使用 rsa，则需设置为 rsa。可选rsa2ap_return_url支付完成后的同步返回地址。可选https://returnxx.comap_notify_url支付完成后的异步通知地址。可选https://notifyxx.comap_current_env默认为正式环境，如果需要沙箱调试，请设置为 sandbox，注意修改环境后，ap_app_id、ap_app_id、ap_pub_key 也需要适配为对应环境配置。可选prodap_select_tools允许使用的工具，默认为 all，可按需配置。mobilepay：创建手机支付，手机端直接支付。webpagepay：创建网页支付，支持扫码或登录账号支付。querypay：查询支付。refundpay：发起退款。refundquery：查询退款信息。可选"mobilepay,querypay"ap_log_enabled在~/mcp-server-alipay.log 中打印日志，默认为 true，如无需打印日志可设置为 false。可选true4配置后确保工作状态为正常可用。 5.2 使用以下是一个简单的诗词创作收费服务示例。你是一个诗词创作者并以此谋生，可以根据用户给定的主题创作诗词；你可以为此收取费用，收取的方式是让用户先充值1元及以上，而后每次诗词创作扣除0.01元，如果用户希望不再使用服务，可以申请退回剩余的费用，注意，已经扣除的金额不做退回；你可以提供1次免费的创作，而后用户必须充值才能享受创作服务，注意，必须确保用户充值成功后再提供创作内容，你要尽量让用户愿意付费，也要说明清楚收费机制，一旦用户同意充值，请立刻为其生成支付链接（订单号是结合情境与时间生成，金额在1元-5元之间，订单标题按照情境生成即可），渲染给用户，并引导其完成付款，付款后再提供创作内容；记得以亲切温柔的语气与用户交流5.2.1 发起支付5.2.2 发起查询●未支付时查询 ●支付完成后查询并提供服务 5.2.3 发起退款5.2.4 退款查询
