Zhifubao

核心功能涵盖支付宝支付产品选型（匹配不同业务场景）、沙箱联调、RSA2签名规范、异步通知避坑、高频报错排查；典型场景包括接入咨询、报错排查、对账设计、多渠道架构建议；输入为开发者相关问题，输出专业合规的接入指导与解决方案，助力高效完成支付宝支付接入。

热度 14.36

最近更新 2026-07-11 21:45:15

分类：开发依赖：纯提示词应用场景：API 集成 / 财务 / 调试排错

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add zhifubao

Metadata

name: 支付宝
version: 1.0.0
description: 支付宝开放平台接入指南。Use for: (1) 选对支付产品——当面付/APP支付/手机网站/电脑网站/小程序支付的适用场景与费率结构, (2) 沙箱联调、RSA2 签名与异步通知验签的正确姿势, (3) 高频报错排查（ISV权限不足/签名错误/回调不来）。Alipay Open Platform integration guide: payment-product selection, sandbox testing, RSA2 signing, and async-notification pitfalls.
tags: ["alipay","zhifubao","payment","openapi","fintech"]
author: ClawSkills Team
category: finance

面向要接支付宝支付的开发者：先选对产品，再按正确姿势联调，最后避开异步通知的经典大坑。

选型速判：线下收银→当面付；App→APP支付；微信里的 H5 无法用支付宝，要么引导浏览器打开要么换微信支付（见 weixin skill 支付章节）。

先沙箱后生产：开放平台控制台有独立沙箱环境（沙箱 AppID、沙箱网关、沙箱版支付宝 App），联调全流程跑通再切生产参数
密钥体系（RSA2）：开发者生成应用私钥/公钥，公钥传平台换 支付宝公钥。记牢方向：请求用你的私钥签名，验回调用支付宝公钥验签——两对密钥四把钥匙，混了必翻车
用官方 SDK：alipay-sdk 有 Java/PHP/Python/Node/Go 版，签名/验签/加解密全封装，不要手写签名
接口协议：统一网关 openapi.alipay.com/gateway.do， method 参数区分接口（如 alipay.trade.precreate 当面付预下单、 alipay.trade.page.pay 电脑网站支付），参数以官方文档为准

报错	根因	处理
ISV 权限不足 (isv.insufficient-isv-permissions)	产品没签约或没绑定到该 App	控制台确认产品状态"已生效"
签名错误 (invalid-signature)	密钥对不匹配/字符集不一致/参数拼接错	用 SDK；检查是否误用沙箱密钥打生产
系统繁忙 (aop.ACQ.SYSTEM_ERROR)	偶发	用 trade.query 查单确认状态再决定重试
回调收不到	notify_url 非公网 HTTPS / 返回了非 success	见上节