网页、移动应用与线下支付接入
把支付宝支付能力集成到网页、移动应用或线下收银业务中；不同场景选择对应产品与 SDK，不用一种下单接口代替全部场景。
接入要求使用实名认证账号创建应用、配置密钥和所需功能，完成应用审核上线与目标收单产品的开通、签约；个人、个体与企业的可申请产品和资料不同，按对应产品实际要求核对。
电商与支付 / Alipay Open Platform
支付宝开放平台
支付宝开放平台提供网页、移动应用的支付、会员及营销等开放能力。本文以中国大陆自有商户的收单接入和交易辅助查询为范围，手册使用沙箱公钥模式；不把创建应用、开发联调和正式商户签约视为同一项资格。
01 / CAPABILITIES
开放功能
核心接口调用手册
2 个场景两项沙箱只读核心场景：已有支付订单查询、已有退款请求查询。每项都提供 Node.js 22 完整 RSA2 参数加签、表单编码、支付宝公钥与原始响应验签；不发起支付、退款或资金操作。
支付订单状态查询
按自己的商户订单号或支付宝交易号读取交易状态、订单金额和交易号，补偿异步通知遗漏，支撑业务订单状态核对。
接入要求需正确应用凭证和对应交易所属权限；out_trade_no 与 trade_no 至少传一个，同时传时 trade_no 优先。不能仅凭 code=10000 就发货，应另核对 trade_status 和本地订单。
沙箱查询订单并验证响应站内调用手册 · 参数、代码与排错已有退款请求结果查询
查询自己已经提交的退款请求，取得退款金额、原订单和退款状态，区分本次查单成功与退款成功。
接入要求需原 out_request_no 及订单标识；未在退款申请时传请求号，则查询使用原商户订单号。建议申请后间隔 10 秒以上再查询，refund_status=REFUND_SUCCESS 才表示退款成功。
沙箱查询退款请求并验签站内调用手册 · 参数、代码与排错沙箱联调与接口安全验证
使用独立沙箱 AppID、应用私钥、支付宝公钥及沙箱网关联调；通过完整 RSA2 参数签名和原始同步响应验签核对接入实现。
接入要求沙箱只支持其当前开放的产品，账号、密钥与正式环境分离；本页完整代码固定沙箱网关，使用普通公钥模式，不适用于证书模式或 OpenAPI v3。
02 / REQUIREMENTS
接入条件
- 适用主体
- 网站与应用开发者、商户技术团队、支付集成开发者
- 接入方式
- OpenAPI v2：应用私钥按 RSA2 生成 sign；支付宝公钥验证同步响应 / 不同应用可配置公钥或公钥证书加签模式，证书参数不能省略套用本页公钥示例 / 第三方代商户调用需应用授权令牌 app_auth_token；本文代码不覆盖代调用模式
- 申请概况
- 开发者需实名认证支付宝账号；正式收款须对应应用审核、产品开通和商户签约，主体条件按产品确认。
- 先以实名认证支付宝账号进入开放平台。为自己经营的业务创建相应应用；正式收款前核对产品允许的主体、经营类目、网站或应用材料及商户签约条件。
- 在应用中选择使用场景和所需功能，完成密钥、网关等开发配置；开发中应用不能据此认定已经可以在线上正式调用。
- 按当前平台配置选择普通公钥或公钥证书方式；本页代码只使用 RSA2 普通公钥模式，上传应用公钥、保管应用私钥，并从可信后台取得支付宝公钥。
- 先在沙箱控制台取得独立沙箱 AppID、密钥与测试账号，确认所需接口受沙箱支持；不能混用正式和沙箱的任何一组凭证。
- 正式发布还需应用审核通过、产品开通和签约；若替他人商户开发，应走服务商或第三方应用授权路线并设置 app_auth_token，不收集对方私钥冒充直连。
- 准备自己的服务端用于请求签名、响应验签及可信结果处理；支付通知、查单与履约还需校验应用、交易归属、金额并保持幂等。
03 / GET STARTED
开通步骤
- 01
确认支付场景与主体
选择网页、APP 或线下等目标产品，核对经营资料、应用类型、签约主体与具体费率。
- 02
创建应用和配置 RSA2
在官方平台配置应用、公钥或证书加签方式；应用私钥只保存在自己受保护的服务端。
- 03
先在沙箱读取已有测试资源
使用沙箱 AppID、密钥和新沙箱网关，先对已有测试订单、退款请求执行只读查询并验签。
- 04
完成正式资格与结果闭环
应用审核上线、产品签约后，另行验证正式场景的通知验签、查单补偿、幂等履约与退款结果。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况
区分无真实资金的沙箱联调、辅助 API 查询和正式交易的签约费率。
- 官方沙箱说明明确所有交易为模拟数据，不使用真实资金且不产生实际费用；自己的服务器和开发资源成本仍需自行承担。
- 本页两个查询接口的官方参数文档未列单独按请求收费标准，不能因此推导所有支付宝产品免费或无限次可用。
- 正式收单按所开通基础产品的收单费率逐笔计费；官方费用说明指向 商家平台 → 账号中心 → 签约管理 查看实际费率。本文不把单一行业或活动费率作为全平台报价。
- 支付之外的独立产品、硬件或第三方服务可能另有费用；退款相关费率处理、结算规则和产品服务费应以该商户当次签约为准。
使用范围与限制
- 本条目覆盖大陆收单接入及两个辅助查询接口，不涵盖 Antom 跨境网关、转账、资金授权或全部营销产品；不能把某一产品的主体条件推及所有平台能力。
- 本页使用 OpenAPI v2 gateway.do 的 RSA2 公钥模式，OpenAPI v3 请求签名和证书模式参数不同。
- 沙箱 AppID、密钥、支付宝公钥、测试账号及交易与正式环境相互独立；沙箱通过不代表正式签约、授权或资金流程完成。
- 同步 HTTP 200 和 code=10000 只说明对应请求成功，订单支付需 trade_status=TRADE_SUCCESS 或 TRADE_FINISHED；退款需核对 refund_status。
- 本页没有执行或提供在线代付，不调用下单、退款、转账等资金写入接口；只读查询仍需自己的真实授权或沙箱资源。
如何进行开发测试
- 沙箱：当前官方示例网关 https://openapi-sandbox.dl.alipaydev.com/gateway.do，独立沙箱凭证；本手册固定此地址，不自动切换正式。
- 正式：OpenAPI v2 网关 https://openapi.alipay.com/gateway.do，必须使用已完成正式条件的应用、产品和商户。
- 沙箱控制台是登录入口；本文未进入账号、创建测试订单、支付、退款或执行任何 API 请求。
接入前再确认
- 已读取支付宝官方最新 API Markdown、RSA2 签名规则、官方 Node SDK 实现及沙箱配置；未登录账号或执行支付与查询。
- opendocs 部分页面公开读取为空，采用当前 aipayment 官方文档；不把空页面标为已验证。
- 沙箱升级公告正文未读取成功，不以此推断迁移日期或旧网关下线时间；当前网关依据已读官方沙箱示例。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。
- 01网页及移动应用接入能力已核对官方资料 · 2026-10-15
- 02开放平台创建应用与沙箱接入已核对官方资料 · 2026-10-15
- 03统一收单交易查询 API已核对官方资料 · 2026-10-15
- 04统一收单交易退款查询 API已核对官方资料 · 2026-10-15
- 05RSA2 参数签名规则已核对官方资料 · 2026-10-15
- 06公钥模式签名与验签配置已核对官方资料 · 2026-10-15
- 07沙箱密钥、网关与模拟费用说明已核对官方资料 · 2026-10-15
- 08收单产品单笔计费与签约费率查询已核对官方资料 · 2026-10-15
- 09支付宝官方 Node SDK：原始同步响应验签已核对官方资料 · 2026-10-15
- 10支付宝官方 Node SDK：RSA2 算法映射与加签已核对官方资料 · 2026-10-15
- 11支付宝开放平台控制台入口官方入口 · 细则待复核 · 2026-10-15
- 12沙箱应用控制台官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明
最近核验 2026-10-15 · 查看核验说明
