执行安装命令
在智能体应用的操作界面中任选以下一种方法:
方法一
方法二
AI-native payment guide
安装 Skill、开通支付能力,并完成支付宝账户授权绑定。
为了确保您的账户和资金安全,请勿从非官方渠道安装或下载 Skill
如需查看官方源码仓库,可访问: https://github.com/alipay/payment-skills
也可直接打开以下技能页面:
在智能体应用的操作界面中任选以下一种方法:
方法一
方法二
如系统提示“未知来源”,请在设置中允许安装。
等待安装进度完成。
钱包开通申请提交仅表示申请已完成,必须完成绑定后才能使用支付功能。
点击屏幕上的绑定链接。
在弹出的“开启支付宝支付功能”页面中点击“开启”按钮,并完成身份核验。
成功授权后,系统会生成一个绑定指令,格式类似:
(6 位数字)
返回智能体聊天页面,输入绑定指令完成绑定。
绑定成功后,您将看到提示:
授权指令有效期为 5 分钟,过期后请重新获取开通链接:
请确认:
如仍无法绑定,请联系客服。
在首页点击“账单”,或在【设置 - 支付设置 - AI 付】中查看所有交易明细。
这是临时性问题,请稍后重试。如持续失败,请和您的龙虾说“反馈支付问题:「当前遇到的实际问题」”并联系客服,我们将尽快为您解决相关问题。
是的,所有支持的智能体均使用相同的两种安装方式:
方法一
方法二
可以。支付功能绑定的是您的支付宝账户,而非特定智能体。但每个智能体都需要单独完成开通和授权流程。
正在确认登录状态...
请用支付宝App扫码登录
支付宝App扫码验证身份
未获取到认证二维码,请返回产品选择后重试。
两种方式均可完成支付产品接入,可随时切换,不影响已保存的配置。
安装后,在对话中补充业务场景、应用技术栈及所需支付能力,Agent 将根据这些上下文逐步协助完成接入。
通过 npx -y @alipay/alipay-aipay@latest install 安装支付宝 AI 付 Skill,加载 alipay-aipay 技能为我的 api 接口集成按量付费,完成沙箱测试,并完成签约入驻 全流程由支付宝官方能力保障
支付宝App扫码验证身份
未获取到认证二维码,请返回产品选择后重试。
请稍候,系统正在为你准备流程。
请选择本次进入 AI 付官网时使用的身份。不同身份会影响你能查看的数据、可使用的功能,以及操作记录的归属。
你可以随时退出当前身份,重新选择。你是以下企业的操作员。选择企业后,将以该企业身份使用你被授权的功能。
该产品的账号注册申请正在处理中,完成后才能继续接入。
提示:技术集成可以和业务入驻并行进行,无需等待产品开通审核完成。建议先使用沙箱环境完成集成和测试,沙箱环境不使用真实资金,可以放心调试。
将以下密钥配置到项目环境变量中
AIPAY_APP_ID=2024001234567890 # 沙箱应用公钥 AIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... # JAVA 语言私钥 AIPAY_PRIVATE_KEY=MIIEvQIBADANBg... # 非 JAVA 语言私钥 AIPAY_PRIVATE_PKCS_KEY=MIIEowIBAA... # 沙箱支付宝公钥 AIPAY_ALIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... 将网关地址修改为沙箱地址
AlipayClient alipayClient = new
DefaultAlipayClient("https://openapi-sandbox.dl.alipaydev.com/gateway.do",AIPAY_APP_ID,AIPAY_PRIVATE_KEY,"json","UTF-8",AIPAY_PUBLIC_KEY,"RSA2"); 详情见 当前产品产品接入指南
沙箱环境无需使用真实资金。所有交易均为模拟数据,不会产生任何实际费用,可以放心反复测试。
系统已为你分配以下沙箱测试账号,请使用这些账号在沙箱 APP 中登录:
下载支付宝沙箱版 APP,使用上方买家账号登录
打开你开发的应用,触发一笔收款请求(沙箱环境不使用真实资金)
使用沙箱 APP 扫码或跳转完成付款操作
检查你的服务器是否收到支付成功的异步通知
沙箱 APP 是一个独立的测试环境客户端,与正式版支付宝完全隔离,使用上方提供的测试账号登录即可。
使用手机扫码下载沙箱 APP
把代码里的沙箱配置换成线上真实配置,然后发起一笔真实交易,确认支付全链路在线上可以正常使用。
在你的代码或环境变量中搜索以下沙箱,将它们替换为下方的线上值:
AIPAY_APP_ID=2024001234567890 # 沙箱应用公钥 AIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... # JAVA 语言私钥 AIPAY_PRIVATE_KEY=MIIEvQIBADANBg... # 非 JAVA 语言私钥 AIPAY_PRIVATE_PKCS_KEY=MIIEowIBAA... # 沙箱支付宝公钥 AIPAY_ALIPAY_PUBLIC_KEY=MIIBIjANBgkqhk... AIPAY_APP_ID=2024001234567890 # 线上应用公钥 AIPAY_PUBLIC_KEY=正在加载... # 线上 JAVA 语言私钥 AIPAY_PRIVATE_KEY=(需自行配置线上 JAVA 语言私钥) # 线上非 JAVA 语言私钥 AIPAY_PRIVATE_PKCS_KEY=(需自行配置线上非 JAVA 语言私钥) # 线上支付宝公钥 AIPAY_ALIPAY_PUBLIC_KEY=正在加载... AIPAY_APP_ID、AIPAY_PUBLIC_KEY、AIPAY_PRIVATE_KEY、AIPAY_PRIVATE_PKCS_KEY、AIPAY_ALIPAY_PUBLIC_KEY 替换为上方线上值
https://openapi.alipay.com/gateway.do 完成上方步骤后,输入支付宝交易号进行验证:
恭喜你,已完成 AI按量付费能力的一站式接入。
可按需发布到更多 Al生态中使用
在你的 AI 编程工具(Cursor / Windsurf / Claude Code 等)中,粘贴并运行下方 npx 指令,按照终端 / 智能体的步骤引导即可自动完成 SDK 安装与接入配置。
打开你的 AI 编程工具(Cursor / Windsurf / Claude Code)
复制并粘贴下方 npx 指令,回车运行
按照编程工具的引导完成支付功能集成及商家资质申请
通过 npx -y @alipay/alipay-aipay@latest install 安装支付宝 AI 付 Skill,加载 alipay-aipay 技能为我的 api 接口集成按量付费,完成沙箱测试,并完成签约入驻 查看已接入的支付产品及使用数据
查看注册服务及调用配置