# 网页&移动应用 > 开发者可通过支付宝SDK等工具快速将产品集成至自身的网页或移动应用中。 ## 开发 ### 指南 - [创建应用](https://opendocs.alipay.com/open/009yp4.md): 本文档主要介绍了在支付宝开放平台创建网页/移动应用的全流程。开发者需使用实名认证账号登录控制台，选择应用类型创建应用，初始状态为“开发中”。核心流程包括：填写应用基础信息（名称、图标、绑定账号），需严格遵守应用审核规范；针对移动应用配置iOS Bundle ID或Android包名与签名；开通所需产品；配置应用环境，其中接口加签方式为必填项，IP白名单、应用网关等为可选项。配置完成后，开发者可在控制台查看应用唯一标识APPID，用于调用开放产品接口能力。 - [绑定应用](https://opendocs.alipay.com/open/0128wr.md): 本文档介绍了支付宝开放平台应用与商家账号绑定的功能及操作流程。平台包含开发者、商家和服务商三种角色，应用（APPID）需绑定商家账号（PID）方可调用支付等资金产品能力。操作分为普通商家和服务商代商家两种模式：前者由商家登录商家平台在账号中心提交绑定申请；后者由服务商通过服务商平台的商家管理页面代为操作。注意事项指出，同主体绑定无通知，不同主体不支持绑定，商家签约产品后可供其名下所有绑定应用使用，APPID可在开放平台控制台查询。 - [配置密钥](https://opendocs.alipay.com/open/02nlga.md): 本文档介绍了在支付宝开放平台配置接口加签方式的具体操作流程。用户需登录控制台，在应用详情页的开发设置中找到接口加签方式设置入口。核心配置流程包括：选择“密钥”加签方式；下载并使用密钥工具生成RSA2算法的应用公私钥对；将应用公钥上传至平台并完成短信或支付密码验证。文档特别强调，平台不保存用户的应用私钥，用户必须自行妥善保管，一旦丢失或泄露需重新配置。配置完成后，用户需保存支付宝公钥以便后续接口调用。 - [上线应用](https://opendocs.alipay.com/open/009yp8.md): 该文档主要介绍了支付宝开放平台应用上线流程、协作费说明及接口调用方法。应用上线需提交审核，审核通过后变为“已上线”状态，方可在生产环境调用接口，开发者需自行验收并进行安全检查。协作费协议可在应用上线时或上线后申请，需注意协议互斥关系，历史应用需通过新建应用补充签约。接口调用需下载服务端SDK，并根据普通公钥或公钥证书模式初始化AlipayClient对象，配置网关地址、密钥或证书路径等参数，文档最后提供了具体的API调用代码示例。 - [成员管理](https://opendocs.alipay.com/open/0h5rel.md): 本文档介绍了支付宝网页/移动应用的成员管理功能，旨在通过管理员与应用管理员角色协助开发者管理应用。管理入口位于开放平台控制台的应用详情页。权限方面，管理员拥有最高权限，涵盖信息编辑、接口加签与加密配置、添加应用管理员及提交审核等；应用管理员权限受限，无法修改核心开发配置或添加管理员，但可进行IP白名单、网关配置及提审。管理员属全局角色，在账户中心添加；应用管理员仅在特定应用下添加，且添加过程无需对方确认即刻生效。 - [开通产品](https://opendocs.alipay.com/open/009ypa.md): 本文档主要介绍自研型应用在上线后开通产品的流程。用户需登录商家平台的产品中心选择目标产品，点击“立即开通”并填写信息提交协议。审核预计需1个工作日，结果通过短信和邮件告知。此外，文档指出不同产品使用条件不同，若未找到产品可前往开放平台API中心查询，遇到政策答疑或审核问题可拨打客服电话咨询。 ### 服务端 - [产品地图](https://opendocs.alipay.com/open/065yhr.md): 该文档介绍了支付宝开放平台为满足开发者业务诉求而开放的各类产品接口体系。文档详细列出了十大核心产品分类：支付产品涵盖当面付、APP支付、刷脸付及AI按量付费等多种场景；私域与公域产品助力商家引流与推广；营销产品提供优惠券、会员卡、红包及用户分析工具；资金产品支持分账、转账及分期服务；会员产品提供身份验证与登录功能；信用产品基于芝麻信用提供免押服务；安全产品负责交易风控与内容识别；此外还包含广告投放及覆盖生活缴费、教育、出行等场景的通用解决方案，全面赋能商家数字化经营。 #### 支付产品 ##### 当面付 - [产品介绍](https://opendocs.alipay.com/open/00f7nr.md): 该文档详细介绍了支付宝“当面付”产品。公告指出该产品不再支持小程序使用，小程序需选用专用支付产品。产品主要适用于线下实体场所的面对面收银场景。申请支持企业、个人及个体工商户账号，需提交经营场所照片等材料，个人申请需营业执照，材料不全将面临收款额度限制。费率统一为单笔0.6%，支持多种支付工具，服务费四舍五入计算。结算默认实时到账，新签约或连续交易不满足条件的商家实行次日结算。退款默认有效期为交易后12个月，服务费随退款退回。 - [接入准备](https://opendocs.alipay.com/open/01csp3.md): 本文档介绍了支付宝产品的两种接入模式：商家自研和服务商代开发。商家自研模式涵盖创建应用、配置加签方式与网关等参数、应用上线、绑定商家账号及开通产品等流程，详细说明了必选与可选配置项。服务商代开发模式则指导服务商创建第三方应用、协助商家开通产品、获取授权令牌及代商家调用接口。此外，文档还提供了服务端SDK的集成指南，重点阐述了公钥模式与公钥证书模式下AlipayClient对象的初始化配置及关键参数说明，帮助开发者完成系统对接。 ###### 接入指南 ###### 基础功能 - [付款码支付快速接入](https://opendocs.alipay.com/open/00f7ns.md): 本文档提供了支付宝“当面付付款码支付”的快速接入指引。接入方式分为门店直连和商家后台转发两种，适用于不同规模商户。文档详细说明了支付、查询、撤销、退款及对账五大核心流程。支付时，商家通过扫码调用`alipay.trade.pay`接口，并需根据返回码（如10003等待付款）进行轮询查询或撤销操作以防止单边账。退款支持全额与部分退款，资金原路返回。对账可通过接口下载账单文件。安全方面采用HTTPS、RSA签名及付款码定时刷新机制。开发者需注意付款码长度扩充的设计预留。 - [当面付接入注意事项](https://opendocs.alipay.com/open/00f7nv.md): 本文档制定了支付宝接口调用的规范与最佳实践。建议对唤起收银台的交易进行轮询以确认结果，部分退款需确保请求号唯一。入参规范要求正确传入storeid、terminalid等关键参数以保障权益。异常处理部分明确了各类接口在超时或错误时的重试与人工处理流程。资金安全章节强调需及时撤销未支付订单，禁用撤销接口替代退款，并防止未获结果即重覆收款。此外，文档还涉及异步通知验签、订单号生成及规避“单边账”风险的措施，旨在保障交易安全与体验。 - [异步通知说明](https://opendocs.alipay.com/open/00f7nu.md): 本文档详细阐述了支付宝支付结果的异步通知机制。异步通知通过POST请求将支付结果发送至商户指定的notify_url，商户需响应“success”以确认接收，否则支付宝将按特定策略重试。文档强调了接入异步通知的同时必须搭配“统一收单交易查询接口”，以防止因通知丢失导致的订单状态不一致或重复支付。文档列出了关键通知参数，重点说明了交易状态（如TRADE_SUCCESS）及其触发条件，并详细解析了资金明细与优惠券信息结构。最后，文档重点描述了严格的验签流程，包括RSA签名验证步骤及商户侧必须执行的业务二次校验（订单号、金额、商户ID一致性），确保交易安全。 ###### 扩展功能 - [当面付扩展功能](https://opendocs.alipay.com/open/00f7nw.md): 本文档主要介绍支付宝当面付产品的花呗分期接入及高级功能配置。首先，阐述了花呗分期接入的标准收银台与单通道两种模式，详述了各自的准入条件及单通道模式下的分期数与手续费承担参数配置。其次，解析了优惠金额控制逻辑，包括限制可优惠金额的参数设置及订单总金额、实收金额、用户实付金额与开票金额的计算关系和典型案例。此外，文档说明了集团商家指定收款账号、商品信息同步匹配营销活动、多门店参数配置及小票打印规范。最后，介绍了服务商通过签约政策并传入PID参数获取交易返佣的流程与注意事项。 - [对账说明](https://opendocs.alipay.com/open/03axls.md): 支付宝提供商家平台手动下载和接口调用两种对账方式。商家平台支持下载资金账单和交易账单，分为日账单（次日生成）和月账单（次月4日前生成），数据最早可追溯至2013年。接口对账方式通过调用`alipay.data.dataservice.bill.downloadurl.query`接口实现，支持收款账号接入和主账号开通（含ISV模式）两种模式，商家可获取下载链接（有效期30秒）自动下载CSV文件进行对账。账单文件包含业务账单和财务账单，均设有汇总与明细表，且支持自定义下载字段与语言设置。 - [商户风险联防指引](https://opendocs.alipay.com/open/00f7nz.md): 该文档介绍了支付宝联防机制，旨在治理被动欺诈和被动赌博风险。被动欺诈指欺诈者利用商户订单诱导受害者支付获利；被动赌博指黑产利用订单链接进行赌资转移。商户可通过支付接口回传数据，结合支付宝内部数据提升风控能力。文档列出了适用的支付产品，并详细规定了数据集成方式，建议通过 `business_params` 字段回传风控信息。文档进一步明确了必选与可选的数据字段定义，涵盖账户、网络、设备及交易信息，并强调敏感数据须采用AES加密，仅用于风险管控。 - [用户下单 IP 获取指引](https://opendocs.alipay.com/open/05zt96.md): 该文档旨在指导商家正确获取支付宝支付安全所需的用户下单IP（mc_create_trade_ip）。该IP指用户在商家侧生成订单时的客户端IP。文档根据网络环境分为两种场景：无代理场景下，应直接获取连接IP（RemoteAddr），严禁读取HTTP头信息以防伪造；有代理场景下，需配置代理服务器（如Nginx、Apache）传递真实IP，服务端通过解析X-Real-IP或X-Forwarded-For字段获取。文档提供了Java和PHP代码示例及配置指引，并通过案例分析强调了需校验IP链条与网络路由的一致性，以防范IP伪造风险。 ###### 集成工具 - [沙箱调试说明](https://opendocs.alipay.com/open/00ip3n.md): 支付宝沙箱环境是为开发者提供的与生产环境完全隔离的联调测试平台，支持“当面付”能力调试。该环境允许开发者在未签约产品前进行接口调用，实现开发与商务流程并行，提升交付效率。文档详细说明了接口支持范围，涵盖付款码支付、交易查询、退款及撤销等核心功能，但指出退款需全额且仅限一次，账单下载仅提供模板。调试时需注意：沙箱仅支持余额支付，不支持银行卡、花呗分期及优惠核销；参数设置有特定限制；数据体系独立，不可与生产环境混淆。开发者需使用沙箱应用信息及指定网关进行配置，调试完成后仍需在生产环境验收。 - [SDK & Demo 获取](https://opendocs.alipay.com/open/00f7ny.md): 该文档主要介绍支付宝开放平台服务端SDK及当面付Demo的使用说明。SDK支持Java、PHP、NodeJS、Python和.NET等多种语言，封装了签名验签与HTTP请求等基础功能。当面付Demo提供了Java、.NET和PHP三个版本，并明确了各自的运行环境要求。运行Demo前，需在配置文件中替换appid、pid及密钥等参数，参考test方法运行。文档特别提示，若使用公钥证书请求方式，需对Demo配置及请求方法进行相应修改。 ###### API 列表 - [统一收单交易支付接口](https://opendocs.alipay.com/open/02ekfp.md): 本文档详细介绍了支付宝“当面付”接口的功能与使用规范。该接口用于收银员通过扫码设备读取用户付款码后发起支付，支持条码支付和刷脸支付两种场景。文档明确了接口的公共请求参数与业务必选参数（如商户订单号、金额、授权码等），并提供了Java、PHP、C#、Node.js等多种语言的SDK接入示例。在响应处理方面，文档定义了包含交易状态、资金渠道等信息的业务响应字段。此外，文档汇总了大量业务错误码（如余额不足、权限受限、交易状态异常等）及其解决方案，并说明了交易状态变更的异步通知机制，为商户接入当面付功能提供了完整的技术参考。 - [统一收单交易查询接口](https://opendocs.alipay.com/open/02ekfq.md): 该文档介绍了支付宝统一收单交易查询接口，旨在协助商户主动查询订单状态。适用场景包括商户未收到支付通知、接口返回系统错误或未知状态、交易处理中及撤销前确认等。请求参数包含应用ID、签名等公共参数，业务参数中商户订单号与支付宝交易号二选一，支持定制查询选项。响应涵盖交易状态、金额、买家信息及资金渠道等数据。文档提供了Java、PHP等多语言代码示例及常见业务错误码解决方案，指导开发者正确集成与调试。 - [统一收单交易退款接口](https://opendocs.alipay.com/open/02ekfs.md): 本文档详细说明了支付宝退款接口的功能与使用规范。该接口支持卖家在约定时间内将支付款原路退回买家账户，支持单笔交易多次退款，但累计金额不得超原交易金额。使用者需保证退款请求号唯一以防重复退款，且同一笔交易退款间隔需3秒以上。退款成功判断以 `fund_change=Y` 为准，`code=10000` 仅代表请求受理。若原交易涉及分账，需接收方开启回退授权。文档还详细列出了公共请求参数、业务请求参数（如退款金额、订单号、退分账明细等）、响应参数及多语言代码示例，并针对卖家余额不足、交易状态异常等常见业务错误码提供了解决方案。 - [统一收单交易退款查询接口](https://opendocs.alipay.com/open/02ekft.md): 本文档详细介绍了支付宝退款查询接口，旨在帮助商户验证退款请求是否执行成功。文档强调了关键注意事项：返回码10000仅代表查询操作成功，需依据refund_status字段是否为REFUND_SUCCESS来判断退款结果；若退款失败，应在保持请求号和金额一致的前提下重试；查询请求建议在退款发起10秒后进行。接口要求传入退款请求号，并提供交易号或商户订单号二选一，支持通过query_options获取资金渠道、银行卡冲退等扩展信息。此外，文档提供了Java、PHP等语言的接入示例，定义了公共与业务请求响应参数规范，并列出了交易不存在、系统错误等常见业务错误码及处理方案。 - [收单退款冲退完成通知接口](https://opendocs.alipay.com/open/02ekfv.md): 本文档定义了支付宝退款至银行卡完成通知接口的规范。该通知仅在退款涉及银行卡且回传包含deposit_back_info时触发。文档详细说明了公共请求参数（如notify_id、sign、biz_content等）及消息属性，其中dback_status字段标识冲退成败（S/F），失败时资金转入余额。接口要求商户同步响应“success”以确认处理，否则将触发重试机制，策略为25小时内按递增间隔重试8次。 - [统一收单交易撤销接口](https://opendocs.alipay.com/open/02ekfr.md): 本文档介绍了支付宝撤销交易接口（alipay.trade.cancel）的功能与使用规范。该接口用于处理支付失败或系统超时场景：若用户支付失败则关闭订单，若支付成功则自动退款。文档强调仅当支付结果未知时才可调用此接口，正常退款应使用退款API。主要请求参数为商户订单号或支付宝交易号（二选一）。响应参数包含重试标识及动作类型。文档还提供了Java、PHP、C#等多种语言的SDK调用示例，并列出了如“余额不足”、“超时”等常见业务错误码及其解决方案，帮助开发者排查异常。 - [统一收单交易关闭接口](https://opendocs.alipay.com/open/02o6e8.md): 本文档详细介绍了支付宝交易关闭接口的功能与使用规范。该接口用于商户在交易创建后，关闭用户一定时间内未付款的交易。文档明确了公共请求参数（如app_id、method、sign等）及业务请求参数的配置，其中业务参数trade_no与out_trade_no二选一且前者优先。提供了cURL、Java、C#、PHP及Node.js多语言的SDK调用示例。响应部分包含公共与业务参数说明，并列出了ACQ.INVALID_PARAMETER、ACQ.TRADE_NOT_EXIST等常见业务错误码及其解决方案。此外，文档还阐述了交易关闭与成功状态下的异步通知触发机制。 - [查询对账单下载地址接口](https://opendocs.alipay.com/open/02ekfu.md): 本文档介绍了支付宝商户离线账单下载接口，旨在帮助商户通过接口获取账单下载地址以实现快速查账。文档详细说明了公共请求参数（如应用ID、签名、时间戳）和业务请求参数（账单类型、账单日期）。该接口支持交易、资金、营销及直付通等多种账单类型，响应结果包含有效期为30秒的下载链接。此外，文档还提供了Java、PHP、C#及cURL的代码示例，并列举了账单不存在、参数非法及频率限制等常见业务错误码的解决方案。 - [常见问题](https://opendocs.alipay.com/open/00f7o1.md): 本文档主要解答支付宝支付产品的常见问题，涵盖当面付、付款码支付、交易撤销、退款及查询接口等内容。当面付申请需具备实体门店并通过照片审核。付款码支付默认免密，有特定的扣款优先级与安全机制。文档详细对比了撤销、关闭与退款接口的适用场景与时效差异：撤销仅限当面付且时效24小时，退款用于交易成功后资金返还。此外，说明了退款到账时间、异步通知区分方法，以及查询接口参数设置与账单展示规则，为商户接入与排查故障提供指导。 - [更新日志](https://opendocs.alipay.com/open/074mkv.md): 本文档记录了支付宝“当面付”产品及相关接口在2022年至2026年间的更新日志。核心要点包括：多次更新账单下载接口，新增限流、数据不存在等多种错误码；增强退款接口功能，新增指定退款账号等字段；调整业务线，将扫码支付和收款码能力分别迁移至“订单码支付”和“经营码”；新增用户下单IP获取、商户风险联防、沙箱联调指引及常见问题解答；明确异步通知重试逻辑并新增退款到卡消息通知接口。 ##### 订单码支付 - [产品介绍](https://opendocs.alipay.com/open/05osux.md): 本文介绍了支付宝“订单码支付”产品，即商家生成二维码、用户扫码付款的支付方式，适用于实体店及广告场景。其流程包括商家生成码、用户扫码支付及后台通知。在使用分账产品时，退款默认按比例自动退回。该产品支持企业和个人账号申请，需提交经营场所照片等材料，个人需营业执照，否则面临收款限额。计费费率为单笔0.6%～1%，按四舍五入计算。退款周期为12个月内原路退回，资金默认实时到账，新签约商家需次日结算。接入需完成产品开通与开发配置。 - [接入准备](https://opendocs.alipay.com/open/05osuy.md): 本文档指导用户接入支付宝“订单码支付”产品，涵盖商家自研和服务商代开发两种模式。商家自研流程包括创建应用、配置加签方式与网关等参数、应用上线、绑定商家账号及开通产品。服务商模式需创建第三方应用，协助商家开通产品并获取代开发授权，使用授权令牌调用接口。文档最后详细说明了服务端 SDK 的集成方法，提供了公钥模式与公钥证书模式的初始化示例及关键参数配置说明，帮助开发者快速完成系统对接。 ###### 接入指南 - [快速接入](https://opendocs.alipay.com/open/05osuz.md): 本文档为支付宝“订单码支付”产品的集成指引，适用于自助终端场景，支持自研商家及服务商通过API接入。核心支付流程包括商家预下单生成二维码、用户扫码支付、系统轮询查询结果，并辅以异步通知。若超时未支付需调用撤销接口关闭订单。文档详细阐述了交易状态的流转规则，涵盖成功、完成及关闭等状态的区别。同时，文档提供了下单、查询、撤销、退款及对账等核心接口的调用流程、关键参数说明及Java代码示例。退款支持全额与部分退款，并提供银行卡退款回调通知机制。对账可通过接口获取账单下载链接实现自动化处理。 - [扩展功能](https://opendocs.alipay.com/open/0c2jas.md): 文档主要介绍了支付宝商家支付接口中关于优惠金额处理、商品信息同步及小票打印的操作规范。在优惠金额方面，商家可通过`discountable_amount`参数限制订单参与优惠的额度，并在支付结果中获取订单总额、商家实收、用户实付及开票金额等数据，文档详细说明了各级金额的计算逻辑及案例。在商品同步方面，调用预下单接口时需传入商品明细以匹配单品优惠活动，重点规范了商品ID、名称、数量和单价等参数。此外，文档还规定了收银小票的打印标准，明确了必须包含的订单号、支付标识、时间以及建议包含的实收金额和开票金额等要素，以确保交易准确和售后便利。 ###### API 列表 ###### 交易 - [统一收单线下交易预创建接口](https://opendocs.alipay.com/open/05osv9.md): 本文档详细介绍了支付宝“商家请求订单码支付预下单”接口。该接口支持商户生成订单二维码，供用户通过支付宝“扫一扫”完成付款，二维码有效期为2小时。文档完整规定了公共请求参数（如app_id、method、sign等）及业务请求参数（biz_content）的规范，明确了商户订单号、订单金额、标题和产品码为必填项，同时支持传递商品明细、门店信息等可选参数。此外，文档提供了Java、PHP、C#及cURL的代码接入示例，解析了响应参数结构，列举了包括权限、限额、参数错误等常见业务错误码及其解决方案，并说明了交易状态变更的异步通知触发机制。 - [统一收单交易关闭接口](https://opendocs.alipay.com/open/05osv2.md): 该文档详细介绍了支付宝“alipay.trade.close”接口，用于在交易创建后用户未支付时关闭交易。文档规定了公共请求参数（如app_id、method、sign等）和业务请求参数（trade_no与out_trade_no二选一），并提供了cURL、Java、C#、PHP及Node.js的代码示例。响应部分包含公共与业务参数说明、正常及异常响应示例。此外，文档列举了参数无效、交易状态异常、系统错误等业务错误码及其解决方案，并说明了触发通知的类型及示例，帮助开发者实现安全、高效的交易关闭功能。 - [统一收单交易退款查询接口](https://opendocs.alipay.com/open/05osv3.md): 该文档详细介绍了支付宝统一收单交易退款查询接口的功能与使用规范。此接口旨在帮助商户查询退款请求的执行状态，文档特别强调了三个核心注意事项：一是接口返回码10000仅代表查询操作成功，退款成功的判断标准是refund_status字段返回REFUND_SUCCESS；二是若需重试退款，必须保证退款请求号和金额一致以防重复退款；三是建议查询请求在退款请求发起10秒后进行。文档还规定了公共请求参数与业务请求参数，包括必填的退款请求号及二选一的交易号/订单号，并提供了多种编程语言的调用示例及常见错误码解决方案，帮助开发者准确判断退款结果。 - [统一收单交易撤销接口](https://opendocs.alipay.com/open/05osv4.md): 本文档详细介绍了支付宝撤销交易接口的功能与使用规范。该接口用于处理支付失败或系统超时场景，若用户支付失败则关闭订单，若支付成功则退款。文档明确仅限在支付结果未知时调用，正常退款应使用退款API。内容涵盖公共请求参数（如app_id、method、sign等）及业务请求参数（商户订单号或支付宝交易号二选一）。文档提供了cURL、Java、C#、PHP四种语言的请求示例，详细解析了公共与业务响应参数，特别是action字段含义。最后，文档列举了交易不允许撤销、余额不足、超时等业务错误码及其解决方案，为开发者提供了完整的接入指引。 - [统一收单交易查询接口](https://opendocs.alipay.com/open/05osv5.md): 该文档介绍了支付宝统一收单线下交易查询接口，旨在帮助商户主动查询订单状态以处理异常情况。文档详细说明了公共请求参数与业务请求参数，重点明确了商户订单号与支付宝交易号二选一的必填规则，以及通过query_options定制返回字段的功能。同时，提供了cURL、Java、C#、PHP及Node.js等多种开发语言的调用示例。响应参数涵盖了交易状态、金额明细、买家信息及结算详情等核心数据。此外，文档列举了参数无效、系统错误、交易不存在等常见业务错误码，并给出了相应的排查解决方案，指导开发者正确集成接口。 - [统一收单交易退款接口](https://opendocs.alipay.com/open/05osv6.md): 本文档详细介绍了支付宝退款接口（alipay.trade.refund）的功能与使用规范。卖家可通过该接口将支付款原路退回买家账户，支持全额或多次部分退款。核心规则包括：退款需在约定时间内发起，单笔交易累计退款额不得超过原订单金额；同一笔退款重试需保持退款请求号一致以防重复退款；退款成功判断以fund_change=Y为准。若原订单涉及分账，需接收方开启分账回退授权。文档提供了详细的公共与业务请求参数说明，涵盖退款金额、订单号、商品详情及退分账信息，并附带Java、PHP等多种语言的代码示例及常见业务错误码解决方案，指导开发者正确接入。 - [收单退款冲退完成通知接口](https://opendocs.alipay.com/open/05osva.md): 该文档定义了支付宝“退款退到银行卡”场景下的退款完成通知接口规范。通知仅在退款请求中传入`deposit_back_info`且收到银行回执时发送。文档详细列出了公共请求参数（如通知ID、签名信息等）及消息属性，重点说明了银行卡冲退状态（成功/失败）及金额字段的处理逻辑。此外，规定了商户需响应“success”或“fail”来控制通知重试机制，系统将在25小时内按递增间隔最多重试8次。 ###### 账单 - [查询对账单下载地址接口](https://opendocs.alipay.com/open/05osv8.md): 该文档详细介绍了支付宝商户离线账单下载接口，旨在帮助商户通过API获取账单下载地址以实现快速查账。接口调用需设置公共请求参数（如app_id、签名、时间戳）及业务参数，其中必填参数为账单类型和账单日期。系统支持交易、资金、营销及直付通等多种账单类型，数据最早可追溯至6年前，并提供T+1日账单服务。响应结果包含有效期30秒的下载链接。文档提供了cURL、Java、C#和PHP四种语言的接入示例，并列举了账单不存在、参数非法、频率超限及类型不支持等常见业务错误码及其详细解决方案，指导开发者正确集成与调试。 - [常见问题](https://opendocs.alipay.com/open/05osvb.md): 该文档主要解答支付宝支付、退款及查询接口相关的常见问题。支付部分明确了二维码有效期为2小时及被扫即失效机制，并介绍了异常处理与申请门槛。退款部分详细说明了资金回流时效、部分退款实现方式、12个月退款期限，以及如何通过交易状态和特定参数区分全额退款、部分退款与超时关闭。查询接口部分解释了手续费查询方式及获取资金渠道详情的参数设置。此外，文档还详细列举了支付宝客户端账单中头像、名称、金额等信息的显示逻辑与修改规则。 ###### 相关资料 - [接入注意事项](https://opendocs.alipay.com/open/069hih.md): 本文档制定了支付宝接口集成的开发规范，涵盖调用流程、参数设置、异常处理、资金安全及最佳实践。核心要求包括：收银台轮询建议设为30秒，部分退款需保证请求号唯一。入参需规避中文，确保门店、机具、服务商ID等关键参数正确传入。异常处理需区分接口类型执行重试或人工干预。资金安全强调及时撤销未付订单，严格区分撤销与退款场景，保证金额一致，结果未明时禁止让用户重付。建议采用后台转发架构，规范订单号生成，并通过交易闭环、正确轮询及业务培训等多重措施防止单边账，确保交易稳定与资金安全。 - [异步通知说明](https://opendocs.alipay.com/open/0c2c19.md): 本文档详细阐述了支付宝支付结果异步通知机制。当订单支付状态变更时，支付宝通过POST请求通知商户系统。文档强调必须同时接入异步通知与交易查询接口，以防止因通知丢失导致的订单状态不一致或重复支付。文章列举了通知参数、交易状态枚举及触发条件，并说明了通知失败时的重试策略。核心内容包括异步返回结果的验签步骤：需对参数排序、使用支付宝公钥进行RSA验签，并在验签通过后校验订单号、金额、商户ID等信息的一致性。最终，只有状态为TRADE_SUCCESS或TRADE_FINISHED才视为付款成功，商户需返回“success”以停止重试。 - [对账说明](https://opendocs.alipay.com/open/0695en.md): 支付宝提供商家平台下载和接口调用两种对账方式。商家平台下载支持资金账单和交易账单，用户可在对账中心下载日账单或月账单，数据范围始于2013年，需注意账单生成时间及无收支情况。接口对账通过`alipay.data.dataservice.bill.downloadurl.query`实现，支持收款账号接入和主账号授权接入两种模式，适用于自动化处理。调用接口可获取30秒有效下载链接，关键参数包括账单类型和日期。下载文件包含业务与账务账单的明细及汇总表，商家还可自定义下载语言和字段。 - [更新日志](https://opendocs.alipay.com/open/05osvc.md): 该文档是支付宝开放平台2024年5月至2026年1月的接口更新日志。核心内容包括产品发布与接口迭代：一是全面开放“订单码支付”产品，支持商家生成二维码供用户扫码付款；二是重点优化账单下载接口，新增多个限流及数据校验相关错误码，并更新字段描述；三是调整交易查询与退款接口，将部分响应参数改为可选，并在退款接口中新增指定退款账号及外部凭证编号字段，提升了业务处理的灵活性与系统健壮性。 ##### APP支付 - [产品介绍](https://opendocs.alipay.com/open/00dn73.md): APP支付是商家在移动端App集成支付宝SDK以调起支付宝完成付款的产品，需签约并完成技术集成。支持企业、个人及个体工商户账号申请，需提供应用信息、营业执照等材料，资料完整性影响额度和期限。费率采用单笔收费模式，一般行业0.6%，特殊行业1.0%，服务费计算后四舍五入。退款需在交易后12个月内原路退回，服务费不退。资金默认实时结算至签约账户余额，新签约或交易不满足条件的商家实行次日结算。 - [接入准备](https://opendocs.alipay.com/open/00dn74.md): 本文档介绍了支付宝产品的接入方式，包括商家自研和服务商代开发两种模式。自研商家需创建移动应用，配置接口加签、应用网关等关键参数，审核上线后开通产品。服务商代开发需创建第三方应用，协助商家开通产品并获取授权令牌，使用自身密钥调用接口。文档还详细说明了服务端SDK的集成配置，涵盖公钥与公钥证书两种加签模式的初始化方法及参数说明，指导开发者完成接口调用准备。 ###### 接入指南 ###### 基础功能 - [界面规范](https://opendocs.alipay.com/open/0191v1.md): 本文档提供了支付宝收银台及相关产品的设计资源下载与视觉规范说明。为确保商家和开发者在接入支付宝收款功能时保持用户体验的一致性，建议使用标准设计资源。文档列举了设计要点，包括使用标准LOGO、将支付方式置于收银台首位、默认勾选设置以及添加推荐角标和标识。同时提供了包含支付宝、花呗等标准Logo、Icon及按钮素材的“支付宝收银台视觉规范和素材”压缩包供下载使用。 - [APP 支付快速接入](https://opendocs.alipay.com/open/01dcc0.md): 本文档是支付宝App支付功能的接入指引，旨在帮助商家和服务商快速完成系统集成。文档首先明确了接入前提，即需完成准备工作并采用服务端与客户端结合的模式，支持沙箱调试。核心内容涵盖了完整的业务交互流程，包括支付、退款、查询和对账四大模块。在支付流程中，详细规定了商户服务端需调用API生成订单字符串，客户端负责唤起支付宝APP，最终通过异步通知和主动查询来确认交易状态。文档特别强调了安全性规范，要求签名必须在服务端完成，严禁私钥存储于客户端。此外，还详细说明了交易状态的流转规则、退款操作的有效期与接口调用方式、以及通过对账接口获取账单的方法。最后，附录部分提供了自定义参数的命名规范与安全建议，以防止请求异常。 - [iOS 集成流程](https://opendocs.alipay.com/open/00dn76.md): 本文档详细介绍了支付宝移动支付SDK在iOS端的集成与使用流程。内容涵盖两种SDK导入方式（CocoaPods与手动导入）及其依赖库配置；强调了商户AppID注册对安全性与支付体验的优化作用；重点说明了支付请求信息的组装与签名应在服务端完成，并提供了客户端调用支付接口的代码示例。文档还指导了如何处理支付后的URL回调、配置URL Scheme，以及针对Swift项目的桥接配置。此外，详细解释了核心API接口、支付逻辑、Demo运行注意事项及Universal Links配置要点，为开发者提供了完整的接入指引。 - [Android 集成流程](https://opendocs.alipay.com/open/00dn75.md): 本文档主要介绍支付宝 Android SDK 从旧版 AAR 依赖迁移至 Maven 依赖的更新指南及核心开发流程。开发者需在移除旧版 AAR 包后，通过配置 Maven 仓库和添加远程依赖完成 SDK 导入，并申请必要的网络权限。文档指出应在支付前注册商户 AppId 以增强安全性与优化体验。支付接口需在子线程中调用，并建议开启 Loading 过渡效果。支付结果通过客户端同步回调和服务端异步通知两种方式获取，文档还提供了版本号查询方法及联调问题排查指引。 - [ Harmony 单框架集成流程](https://opendocs.alipay.com/open/0f71b5.md): 本文档为鸿蒙系统支付宝支付SDK的集成指南。安装需通过ohpm命令，并注意SDK版本需与支付宝APP版本兼容。配置环节需在module.json5中添加querySchemes。文档建议支付前注册商户appId以增强安全性和优化体验。SDK支持Router和Navigator两种跳转模式，可根据是否安装支付宝APP自动选择APP支付或H5支付，详细阐述了各模式下的接口参数与代码示例。此外，提供了日志回调与版本查询方法，并针对唤端取消回调、登录支持、错误排查及功能限制等常见问题进行了解答。 - [鸿蒙 SDK 接入说明](https://opendocs.alipay.com/open/02e7gu.md): 本文档介绍了鸿蒙版本支付宝支付 SDK 的接入流程，涵盖 SDK 导入、支付接口调用、结果处理及签名配置四部分。首先，需将 HAR 包放入 libs 目录并配置 Gradle 依赖。其次，支付接口调用方式与 Android 版一致，需在非 UI 线程中通过 PayTask 对象调用 payV2 方法，传入服务端生成的订单信息及加载状态参数。再次，支付结果通过客户端 Handler 同步回调和服务端异步通知两种途径获取。最后，真机运行 Demo 需在 Gradle 中配置调试签名。 - [同步通知说明](https://opendocs.alipay.com/open/00iki4.md): 本文档详细说明了支付宝 SDK 支付结果的同步返回机制及处理规范。支付宝处理完成后将结果反馈给商家 App，建议以同步结果仅作支付结束通知，实际支付状态以服务端异步通知为准。返回数据包含 memo、result 和 resultStatus 三个字段，文档释义了 9000（成功）、6001（取消）等关键状态码。针对支付验证，文档提供了从提取签名数据到 SHA256WithRSA 验签，再到校验订单号、金额、卖家 ID 等“五步验签”流程。此外，文中还列举了客户端常见报错信息及其解决方案，涵盖订单参数异常、重复支付、花呗分期受限等场景，指导开发者快速排查并解决支付集成问题。 - [异步通知说明](https://opendocs.alipay.com/open/00dn78.md): 文档详细规定了支付宝异步通知的集成机制与技术规范。核心内容包括：支付宝通过POST请求向商户推送交易变更信息，商户需响应“success”以确认接收，否则系统将按特定频率重试。为确保交易准确，文档强制要求商户主动接入交易查询接口以防漏单，并严格执行安全验签流程：先验证RSA签名，再校验订单号、金额、商户ID等信息的一致性。文档界定了支付、退款、关单等场景的触发条件与参数特征，明确仅TRADE_SUCCESS或TRADE_FINISHED状态代表付款成功，为商户构建可靠的支付回调系统提供了全面指导。 ###### 扩展功能 - [手机网站支付转 APP 支付](https://opendocs.alipay.com/open/00dn79.md): 本文档介绍了支付宝“手机网站支付转 Native 支付”方案，旨在解决商家 App 内嵌 H5 支付成功率低的问题。该方案通过集成支付宝 SDK，拦截 H5 支付 URL 并唤起支付宝客户端完成支付，显著提升支付成功率和用户体验。若用户未安装支付宝 App，SDK 会在内置 Webview 中完成支付。文档详细阐述了 iOS、Android 及 HarmonyOS 三大平台的接入流程，包括 SDK 配置、权限管理及“拦截+支付二合一”接口 `payInterceptorWithUrl` 的调用方法。此外，还说明了同步拦截结果与异步支付结果的处理逻辑，以及如何通过沙箱环境进行联调测试。 - [APP 支付接入花呗分期](https://opendocs.alipay.com/open/00dn7b.md): 本文档介绍了商家在App支付中接入花呗与花呗分期的方法与要求。接入花呗可提升转化率，支持已开通、未开通及不准入三种用户场景；单通道模式需传入specified_channel参数，且不可与分期参数混用。接入花呗分期支持标准收银台与单通道两种模式。标准模式无需开发，用户承担手续费；单通道模式需传入extend_params参数配置分期数与手续费承担比例。两者均要求商家已接入App支付并运营稳定，其中花呗单通道与分期单通道还需技术开发与特定协议签约。 - [花呗单通道支付界面规范](https://opendocs.alipay.com/open/01b9bi.md): 该文档旨在为商家和开发者提供支付宝收款及相关产品的标准设计资源下载服务。为确保用户体验的一致性，文档建议开发者使用官方提供的标准资源进行功能实现。提供的具体资源包括支付宝、花呗及花呗分期的标准Logo、Icon和功能按钮标识。此外，文档还提及了收银台支付方式选择位置及推荐副标题的视觉规范，并提供了包含这些视觉规范和素材的压缩包文件供下载使用。 - [对账说明](https://opendocs.alipay.com/open/00dn7a.md): 支付宝对外提供后台下载和接口调用两种常用对账方式。后台下载需登录商家平台对账中心，支持下载资金账单与交易账单，包含日账单和月账单功能，数据支持从2013年起查询，日账单次日生成，月账单次月4日前生成。接口对账通过调用查询对账单下载地址接口获取临时链接进行下载，链接有效期30秒，支持收款账号接入和主账号接入两种模式，便于系统自动化处理。下载的账单文件分为业务账单和财务账单，均包含明细与汇总表，且支持自定义配置语言和字段。 - [商户风险联防指引](https://opendocs.alipay.com/open/01ba6u.md): 该文档介绍了支付宝联防机制在治理被动欺诈和被动赌博风险场景中的应用。在被动欺诈中，欺诈者利用商户订单诱导受害者付款变现；在被动赌博中，黑产利用商户订单链接进行洗钱。联防模式要求商户通过支付接口回传订单及账户数据，结合支付宝数据提升风险识别。支持产品包括当面付、APP支付等。数据集成主要通过`business_params`字段回传，包含创建订单IP及`outTradeRiskInfo`（账户、网络、设备等信息）。涉及敏感数据需进行AES加密脱敏，仅用于风险管控，以实现对风险交易的拦截和对可信交易的保护。 - [用户下单 IP 获取指引](https://opendocs.alipay.com/open/05zoio.md): 该文档旨在指导商家正确获取支付宝支付场景所需的用户下单IP（mc_create_trade_ip），以提升支付安全性。核心内容包括明确下单IP的定义，即用户在商家侧生成订单时的客户端IP。文档根据网络部署环境，详细区分了无代理和有代理两种场景下的获取方式：无代理场景下应直接获取建连IP，严禁使用易被伪造的HTTP头字段；有代理场景下则需配置代理服务器（如Nginx、Apache）传递真实IP，并在服务端解析相应头部信息。文档提供了Java和PHP代码示例，并辅以案例详细说明如何识别伪造IP及排查程序漏洞，强调了对X-Forwarded-For字段进行校验的重要性。 - [Android 支付sdk调试功能](https://opendocs.alipay.com/open/0hcvna.md): AlipayDebugOptions是支付SDK提供的调试对象，旨在提高研发效率并协助排查Debug问题。该接口必须在调用支付接口之前执行。文档演示了通过Builder模式构建调试选项的过程，包括创建AlipayPayLifeCycle接口实例并重写onPayEnd方法。开发者可将配置好的对象通过AlipayApi.setAlipayDebugOptions方法注入。onPayEnd回调方法提供的endPayParams参数中包含isHitPreHeatApp字段，用于标识是否命中了支付SDK预热的体验优化策略，为开发者提供了关键的调试信息。 ###### 集成工具 - [沙箱调试说明](https://opendocs.alipay.com/open/00dn7d.md): 支付宝沙箱环境是为开发者提供的与生产环境完全隔离的联调测试平台，旨在支持开发与商务流程并行以提高交付效率。该环境支持App支付、交易查询、退款及关闭等核心接口，但不支持银行卡相关业务。调试时需注意：沙箱数据独立且非完全仿真，生产验收必不可少；参数配置中超时时间限15小时内，且不支持花呗分期；支付仅限余额方式，App接入仅支持Android端。开发者需在代码中显式切换环境，并使用沙箱专用网关与控制台配置，避免与生产环境数据或应用混淆。 - [SDK & DEMO 获取](https://opendocs.alipay.com/open/04km1h.md): 该文档主要介绍了App支付客户端SDK的接入指南、资源获取方式及版本更新说明。开发者可通过Maven Central、下载链接或OpenHarmony仓库分别获取Android、iOS及鸿蒙版SDK与示例Demo。文档强调了接入时的关键注意事项，包括需测试设备是否安装支付宝App的两种场景，且支付参数签名必须在服务端完成以保安全。此外，针对iOS构建可能出现的utdid冲突、arm64模拟器支持及mPaaS平台冲突等问题，文档提供了相应的解决方案。最后，详细记录了从2019年至2025年SDK的版本迭代历史，涵盖了性能优化、隐私合规、系统适配及稳定性提升等重要更新。 ###### API 列表 ###### 交易 - [app支付接口2.0](https://opendocs.alipay.com/open/02e7gq.md): 本文档详细说明了支付宝App支付接口的功能与使用规范。该接口为签名数据准备接口，旨在服务端生成包含业务参数及商户身份信息的可信签名字符串，用于APP唤起支付宝客户端完成支付。文档界定了公共请求参数（如app_id、签名类型、时间戳）及业务请求参数（如商户订单号、总金额、商品详情、买家信息校验等），并提供了Java、C#、PHP和Node.js的SDK调用示例。此外，文档列举了接口响应结构、常见业务错误码及其解决方案，以及支付结果异步通知的类型与数据格式，为开发者接入支付功能提供了完整的技术指导。 - [统一收单交易退款接口](https://opendocs.alipay.com/open/02e7go.md): 该文档详细介绍了支付宝退款接口的功能规范与接入指南。卖家可通过此接口将支付款原路退还给买家，支持单笔交易多次部分退款，但总金额不得超过原交易额。文档强调了关键业务规则：部分退款需保证请求号唯一；重试时请求号不可变以防重复退款；同一交易退款间隔需3秒以上；退款成功判断以`fund_change=Y`为准。此外，涉及分账的退款需接收方提前开启授权。文档还提供了详细的请求参数说明、响应参数结构、多语言代码示例（Java、C#、PHP等）及常见业务错误码的解决方案。 - [收单退款冲退完成通知](https://opendocs.alipay.com/open/02e7gs.md): 本文档定义了支付宝退款至银行卡完成通知接口的技术规范。该通知仅在退款至银行卡场景且发起请求包含特定参数时发送。文档详细规定了公共请求参数（如notify_id、sign、app_id等）及消息属性，包括交易号、冲退状态、金额及银行响应时间等关键信息。此外，文档明确了通知应答机制：商户需返回“success”以确认处理成功；若返回“fail”，系统将在25小时内按照递增的时间间隔策略重试最多8次，以确保消息送达。 - [统一收单交易关闭接口](https://opendocs.alipay.com/open/02e7gn.md): 该文档详细介绍了支付宝“统一收单交易关闭接口”的使用规范。该接口用于在交易创建后，若用户未在规定时间内支付，商户可调用此接口直接关闭未付款交易。文档明确了公共请求参数（如app_id、method、签名等）及业务请求参数，其中业务参数要求在支付宝交易号与商户订单号中二选一进行传递。提供了cURL、Java、C#、PHP及Node.js多种语言的SDK调用示例。响应结果包含公共参数与业务参数，并列举了参数无效、交易状态异常、交易不存在等常见业务错误码及其解决方案。此外，文档还说明了交易关闭后将触发异步通知机制。 - [统一收单交易退款查询接口](https://opendocs.alipay.com/open/02e7gp.md): 本文档介绍了支付宝退款查询接口，用于商户查询退款请求的执行状态。接口核心功能是返回退款是否成功，需注意返回码10000仅代表查询成功，只有refund_status为REFUND_SUCCESS才代表退款成功。若退款失败需重试，请保持退款请求号和金额一致以防重复退款，建议在退款请求10秒后发起查询。请求参数包括必填的退款请求号，以及二选一的交易号或订单号，支持定制查询选项。响应包含退款金额、状态、资金渠道及银行卡冲退等详细信息。文档还提供了Java、PHP等语言的代码示例及常见错误码解决方案。 - [统一收单交易查询接口](https://opendocs.alipay.com/open/02e7gm.md): 本文档详细介绍了支付宝“单笔交易查询”接口（alipay.trade.query）的使用规范。该接口旨在帮助商户主动查询订单状态，适用于商户系统未收到支付通知、接口返回系统错误或未知状态、以及处理交易取消前需确认状态等场景。文档明确了公共请求参数（如app_id、method、sign等）和业务请求参数（out_trade_no与trade_no二选一）的详细定义。同时，提供了cURL、Java、C#、PHP及Node.js等多种开发语言的请求示例。在响应方面，文档列举了包含交易状态、支付金额、买家信息等在内的业务响应参数，并给出了正常与异常响应示例及常见业务错误码解决方案，协助开发者完成接口集成与故障排查。 ###### 账单 - [查询对账单下载地址接口](https://opendocs.alipay.com/open/02e7gr.md): 本文档介绍了支付宝商户离线账单下载接口，接口名为`alipay.data.dataservice.bill.downloadurl.query`，旨在帮助商户快速查账。接口请求包含公共参数和业务参数，核心业务参数为账单类型（`bill_type`）和账单日期（`bill_date`）。账单类型覆盖交易、资金变动、营销活动及直付通业务等多种场景；日期参数支持日账单和月账单查询，遵循T+1或次月生成规则。文档提供了Java、PHP、C#等语言的请求示例。响应结果中包含下载链接，该链接有效期为30秒。此外，文档还列举了账单不存在、类型不支持、频率超限等常见业务错误码及其解决方案，指导开发者正确接入。 - [常见问题](https://opendocs.alipay.com/open/00dn7g.md): 该文档是支付宝App支付的常见问题解答指南，涵盖接入配置、开发调试、退款逻辑及账单查询四大板块。接入方面，明确了授权函提交场景、收款额度规则及费率标准，并确认支持鸿蒙与IPv6。开发调试部分详细列举了Android与iOS端的常见报错及H5支付异常的解决方案，提供了异步通知诊断工具的使用方法。退款模块解析了全额与部分退款的通知差异及状态区分。最后说明了查询接口参数设置要求及客户端账单信息的展示规则与修改方式。 ###### 相关资料 - [Universal Links 配置](https://opendocs.alipay.com/open/0b9qzi.md): 本文档主要介绍如何对接AlipaySDK以支持Universal Links支付功能。首先，要求将AlipaySDK升级至15.8.12及以上版本。其次，详细说明了Universal Links的配置要求：必须支持HTTPS、paths路径不能带query参数且需以通配符`/*`结尾，并需在Xcode中配置Associated Domains。文档还提供了通过Safari验证配置生效的方法。最后，文档给出了支付接口的调用示例，并强调需同时实现Universal Link回跳处理（使用`handleOpenUniversalLink`接口）和Scheme回跳处理（使用`processOrderWithPaymentResult`接口），以兼容不同iOS版本及跳转异常场景。 - [更新日志](https://opendocs.alipay.com/open/074rk8.md): 本文档记录了支付宝支付产品从2022年至2026年的更新日志。核心内容包括：持续优化账单下载查询接口，新增限流、无数据等多种错误码；针对iOS、Android及鸿蒙系统更新集成流程，通过增加商户APPID注册提升唤起速度与安全性，并完善鸿蒙单框架接入文档；退款接口新增指定退款账号及凭证编号字段；此外，新增了Universal Links配置、用户IP获取、商户风险联防及沙箱联调等指引，全面提升产品安全性与接入效率。 ##### 手机网站支付 - [产品介绍](https://opendocs.alipay.com/open/00f7nf.md): 本文档介绍了支付宝“手机网站支付”产品，支持商家在移动端网页展示商品，用户确认后跳转至支付宝完成付款。产品支持企业、个人及个体工商户申请，要求网站正常访问且ICP备案主体一致。费率依行业而定，非特殊行业0.6%，特殊行业1.0%，服务费按单笔计算。交易资金默认实时结算至余额，新签约商家可能面临T+1结算。退款需在交易后12个月内原路退回，且不退还服务费。商家需完成签约与技术集成方可使用。 - [接入准备](https://opendocs.alipay.com/open/00f7ng.md): 本文档介绍了支付宝产品的两种接入方式：商家自研和服务商代开发。商家自研模式需创建应用并配置接口加签、应用网关等必填项，提交审核上线后绑定账号并开通产品。服务商代开发模式需创建第三方应用，协助商家开通产品并获取授权令牌，以此代商家调用接口。此外，文档还提供了服务端SDK集成指引，详细说明了公钥模式与公钥证书模式下的AlipayClient初始化配置及关键参数含义。 ###### 接入指南 ###### 基础功能 - [界面规范](https://opendocs.alipay.com/open/01arn9.md): 该文档主要介绍了支付宝收银台的视觉规范及设计素材下载。文档列举了收银台展示的关键设计要点，包括标准LOGO的使用、支付方式应置于选择首位、默认勾选设置、以及推荐角标的应用规范。为确保商家或开发者在接入支付宝收款及相关产品时保持用户体验的一致性，文档建议使用标准设计资源。支付宝提供了包含支付宝、花呗及花呗分期的标准Logo、Icon及功能按钮标识供下载使用。最后，文档提供了“支付宝收银台视觉规范和素材.zip”文件的下载入口，方便开发者获取相关资源进行功能实现。 - [手机网站支付快速接入](https://opendocs.alipay.com/open/00f7nh.md): 本文档主要介绍支付宝手机网站支付产品的接入指引，涵盖支付、退款、异步通知处理及对账全流程。在支付环节，商家服务端通过调用alipay.trade.wap.pay接口生成表单，由前端唤起支付宝客户端完成支付，并通过异步通知或主动查询接口确认最终结果，不可仅依赖前台跳转。退款支持全额和部分退款，需在交易成功后12个月内调用alipay.trade.refund接口，部分退款需传入唯一请求号。此外，文档提供了对账单下载接口的使用说明，强调了版本兼容性、验签机制及Java代码示例，帮助开发者实现安全可靠的支付集成。 - [异步通知说明](https://opendocs.alipay.com/open/00f7nj.md): 本文档主要阐述了支付宝手机网站支付异步通知的处理机制与技术规范。支付宝通过POST请求将支付结果发送至商户系统，为防止因网络异常导致的通知丢失或用户重复支付，商户必须同时接入交易查询接口并在重试支付前检查原订单状态。文档详细列出了异步通知的参数定义，包括基础信息、交易金额、身份标识及优惠券明细等。同时，明确了四种交易状态及其触发条件，规定了通知重试策略与URL配置要求。最后，重点强调了RSA验签流程及业务校验规范，要求商户严格验证订单号、金额、商户ID及应用ID，确保状态为TRADE_SUCCESS或TRADE_FINISHED时才认定支付成功，并需具备过滤重复通知的能力。 ###### 扩展功能 - [手机网站支付转Native支付（推荐）](https://opendocs.alipay.com/open/00f7nn.md): 本文档介绍了支付宝“手机网站支付转 Native 支付”方案，旨在帮助商家在 App 内嵌 H5 页面中，通过拦截支付 URL 并调用支付宝 SDK，以极低成本将 H5 支付转化为 Native 支付。相比纯 H5 支付，该方案能显著提升支付成功率与用户体验，支持指纹、免密等功能；若未安装支付宝客户端，则回退至 SDK 内置 Web-view 支付。文档详细提供了 iOS 和 Android 双端的接入指南，包括 SDK 配置、权限设置、混淆规则，以及核心的“拦截+支付二合一”接口（payInterceptorWithUrl）的调用方法、参数说明、返回值处理逻辑，并附带了沙箱环境联调说明。 - [手机网站支付通过alipays协议唤起支付宝APP](https://opendocs.alipay.com/open/00f7nk.md): 本文档介绍了商家App内嵌H5接入手机网站支付时，通过alipays协议唤起支付宝App以提高支付成功率的解决方案。核心逻辑是在WebView中拦截“alipays://”或“alipay://”开头的URL请求。iOS端需在WKWebView或UIWebView的代理方法中识别协议并调用openURL，若跳转失败则提示用户安装；Android端需在shouldOverrideUrlLoading方法中处理，通过Intent唤起，异常时引导下载。文档建议若唤起受阻可接入App支付产品，未安装客户端时引导用户下载。 - [旧版手机网站支付升级为新版指南](https://opendocs.alipay.com/open/00f7nm.md): 本文档详细说明了支付宝手机网站支付产品从旧版升级为新版的技术指导。主要内容包括：升级后旧版接口仍生效但建议重新接入新版。密钥配置方面，新版新增支持RSA2签名方式，并通过开放平台控制台进行密钥管理。技术接入上，新版变更了请求网关地址，推荐使用服务端SDK进行签名验签，并大幅调整了请求参数、异步通知参数及交易辅助接口的命名和定义。此外，新版支持沙箱环境联调，而旧版不支持。开发者在升级过程中需重点关注接口参数差异及签名验签逻辑的变化，以确保顺利迁移。 - [对账说明](https://opendocs.alipay.com/open/03axlq.md): 该文档详细介绍了支付宝对外对账的两种常用方式：商家平台手动下载和接口自动调用。商家平台方式支持下载资金账单和交易账单，涵盖日账单与月账单查询，数据最早追溯至2013年。接口方式适用于自动化对账，支持收款账号接入和主账号授权接入两种模式。核心流程为调用接口获取有效期30秒的下载链接，随后通过HTTP请求下载CSV文件。文档还提供了Java SDK示例代码、关键参数说明，以及业务账单与账务账单的结构解析和字段映射关系，并说明了自定义下载设置的方法。 - [商户风险联防指引](https://opendocs.alipay.com/open/01og7y.md): 该文档详细阐述了支付宝联防机制在治理被动欺诈与赌博风险中的应用场景与技术实现。联防模式通过商户回传订单与账户数据，结合支付宝内部数据，提升风险识别与可信交易保护能力，实施交易拦截或提醒等管控措施。文档明确了适用产品范围，重点说明了数据集成规范，要求商户通过`business_params`字段回传关键风控信息，包括账户信息、网络环境、设备信息等，并详细列出了各类参数的定义及必填项。此外，文档规定敏感数据需采用AES算法加密传输，确保数据仅用于风险管控，保障信息安全。 - [用户下单 IP 获取指引](https://opendocs.alipay.com/open/05zjrm.md): 本文档旨在指导商家正确获取支付宝支付场景所需的用户下单IP（mc_create_trade_ip），以提升支付安全性。该IP指用户在商家侧发起下单时的客户端IP。文档根据网络环境区分了两种获取方式：无代理场景下，直接通过`getRemoteAddr`获取建连IP，严禁读取易被伪造的HTTP头部字段；有代理场景下，需配置Nginx或Apache记录真实IP，后端从请求头中提取。文档提供了Java/PHP代码示例及配置范例，并通过案例分析强调了识别伪造IP及验证IP来源的重要性，以防安全防护失效。 ###### 集成工具 - [沙箱调试说明](https://opendocs.alipay.com/open/00f7np.md): 支付宝沙箱环境是为开发者提供的与生产环境完全隔离的联调测试环境，支持手机网站支付能力调试。其核心优势在于允许开发与商务签约并行，提升交付效率。沙箱拥有独立数据体系，不支持浏览器支付，需以生产环境逻辑为准。功能上支持支付、查询、退款及关闭等接口，但退款需全额且限一次，不支持银行卡相关通知。参数配置方面，超时时间限制为15小时，且不支持花呗分期与指定买家。测试仅支持余额支付，Android端可唤起沙箱钱包，iOS仅支持H5模拟。开发者需使用指定沙箱网关进行配置调试。 - [SDK & Demo 获取](https://opendocs.alipay.com/open/00f7no.md): 文档介绍了开放平台服务端SDK及手机网站支付Demo的相关资源。服务端SDK包含JAVA、PHP和.NET三种语言版本，封装了签名验签和HTTP接口请求等基础功能，旨在辅助开发者调用开放接口。此外，文档提供了手机网站支付Demo的下载信息，涵盖JAVA、PHP和.NET三个版本，并分别明确了其运行环境要求：JAVA版需jdk1.5及以上，PHP版需php5.5及以上，.NET版需.NET 2010及以上，供开发者按需下载使用。 ###### API 列表 ###### 交易 - [手机网站支付接口2.0](https://opendocs.alipay.com/open/02ivbs.md): 本文档详细介绍了支付宝手机网站支付接口的调用规范。该接口旨在帮助外部商户生成支付跳转链接，用户可通过浏览器在支付宝页面完成订单支付。文档核心内容包括公共请求参数（如应用ID、签名、时间戳等）与业务请求参数的详细定义，其中商户订单号、金额、标题及产品码为必填项。同时，文档提供了Java、C#、PHP三种语言的SDK集成示例，展示了服务端生成支付表单的具体流程。此外，还涵盖了业务扩展参数配置（如花呗分期、买家身份校验）、响应参数说明、常见错误码解析及异步通知类型，为开发者提供了完整的接入指南。 - [统一收单交易退款接口](https://opendocs.alipay.com/open/02ivbx.md): 该文档详细阐述了支付宝统一收单交易退款接口的功能与使用规范。卖家可通过此接口将支付款原路退还给买家，支持全额及多次部分退款，但累计退款额不得超原交易金额。文档强调了重试时需保持退款请求号不变以实现幂等性，并列出了请求间隔、参数合规、禁止混用其他退款产品等关键注意事项。特别指出需依据返回字段`fund_change=Y`判断退款真正成功，且涉及分账的退款需接收方预先授权。文档还详细说明了请求参数、响应结构、常见错误码及多语言代码示例。 - [收单退款冲退完成通知](https://opendocs.alipay.com/open/02ivby.md): 该文档详细说明了退款至银行卡场景下的消息通知接口规范。当退款发起时传入了特定参数，收单系统会依据银行回执发送退款完成通知。文档界定了公共请求参数，涵盖通知ID、时间戳、接口名称、应用ID及签名信息等。核心消息属性包含支付宝交易号、商户订单号、退款请求号、银行卡冲退状态及金额等关键数据。文档还规定了通知应答机制，商户需响应“success”确认成功，否则系统将按照策略在25小时内进行最多8次重试投递。 - [统一收单交易关闭接口](https://opendocs.alipay.com/open/02ivbu.md): 该文档详细介绍了支付宝交易关闭接口的使用规范。该接口旨在关闭用户创建后未支付的订单。文档列出了必要的公共请求参数（如app_id、method、sign等）及业务参数，其中业务参数要求传入支付宝交易号或商户订单号，并规定了优先级规则。提供了包括Java、PHP、C#、Node.js及cURL在内的多种语言调用示例。响应部分说明了公共与业务响应参数的结构，并给出成功与失败的响应示例。此外，文档还列举了如“交易不存在”、“交易状态异常”等常见业务错误码及其解决方案，以及交易关闭后触发的异步通知类型。 - [统一收单交易退款查询接口](https://opendocs.alipay.com/open/02ivbv.md): 本文档详细介绍了支付宝商户退款查询接口的功能与使用规范。该接口供商户查询退款请求的执行结果。文档特别指出，接口返回码10000仅代表查询成功，唯有refund_status字段返回REFUND_SUCCESS才代表退款成功。建议商户在发起退款10秒后进行查询，若需重试退款，务必保持请求号和金额一致。请求参数中，out_request_no为必选，trade_no与out_trade_no二选一。响应信息涵盖退款状态、金额、资金渠道、银行卡冲退详情及优惠券信息等。文档还提供了Java、PHP、C#等多种语言的SDK示例及常见的业务错误码处理建议。 - [统一收单交易查询接口](https://opendocs.alipay.com/open/02ivbt.md): 该文档详细说明了支付宝订单查询接口的功能与使用方法。该接口支持商户主动查询订单状态，适用于处理支付通知缺失、系统异常或需确认交易状态等场景。文档定义了公共请求参数（如app_id、签名、时间戳）和业务请求参数（商户订单号或支付宝交易号），并支持定制查询选项。文档提供了cURL、Java、C#、PHP及Node.js等多种语言的SDK调用示例。响应结果包含详细的交易状态、金额信息、买家资料及资金渠道等。最后，文档列举了系统错误、交易不存在等常见业务错误码及其解决方案，为商户系统集成提供了完整指南。 ###### 账单 - [查询对账单下载地址接口](https://opendocs.alipay.com/open/02ivbw.md): 本文档介绍了支付宝商户离线账单下载地址查询接口，旨在支持商户通过API快速查账。接口核心功能是根据指定条件返回账单文件的下载地址。请求参数分为公共参数和业务参数。公共参数包含应用ID、签名、时间戳等基础信息；业务参数主要涉及必选的账单类型和账单日期。账单类型涵盖交易、资金变动、营销活动、直付通及结算明细等多种场景。账单日期支持日账单和月账单，遵循T+1或T+月规则，最早可查询近6年数据。响应参数中，关键信息为账单下载链接，该链接有效期为30秒。此外，响应中还包含状态码用于标识空数据文件等情况。文档提供了Java、PHP、C#及cURL的请求示例，并展示了正常与异常调用的响应JSON结构，涵盖了网关返回码和业务错误码的说明，供开发者参考集成。 - [常见问题](https://opendocs.alipay.com/open/05a2y9.md): 本文档主要解答支付宝手机网站支付的相关常见问题。首先，收款额度依据商家资质决定，若受限可通过补全信息提升。其次，当商家主体与网站备案主体不一致时需提供授权函。第三，支持通过参数配置可用或禁用的支付渠道，如余额、花呗、信用卡等。针对微信环境无法唤起支付宝的问题，建议引导用户转至系统浏览器支付。若支付成功未收到异步通知，需检查notify_url配置。此外，安卓与iOS因唤端机制不同表现有异，创建应用时的网址URL仅作记录，后续无需更换。 - [更新日志](https://opendocs.alipay.com/open/074q0t.md): 该文档记录了支付宝开放平台从2022年至2026年的关键更新。核心内容包括：多次更新账单下载查询接口，新增限流、账单不存在等多类错误码；优化交易查询与退款接口，调整参数可选性并增加退款账号指定及凭证字段；改进手机网站支付接口，扩展quit_url支持场景；新增用户下单IP获取、商户风险联防及沙箱环境联调指引，提升安全性与规范性；同时补充了退款到卡消息通知接口及支付额度等常见问题。这些更新旨在增强接口功能、优化错误处理并提升业务安全性。 ##### 电脑网站支付 - [产品介绍](https://opendocs.alipay.com/open/00dn7j.md): 该文档介绍了支付宝“电脑网站支付”产品，这是一种用户在商户电脑网页确认支付后跳转至支付宝页面完成付款的产品，需签约并技术集成后方可使用。申请支持企业、个人及个体工商户账号，要求网站可正常访问、有经营内容且通过ICP备案，备案主体需与账号主体一致。产品费率为单笔0.6%，支持余额、银行卡及花呗等支付方式，服务费四舍五入保留两位小数。退款周期为交易后12个月内，资金原路退回但不退手续费。资金默认实时结算至签约账号余额，新签约商家可能面临次日结算的限制。商户可通过平台申请开通并参考开发文档进行接入。 - [接入准备](https://opendocs.alipay.com/open/01didh.md): 该文档详细介绍了商家或服务商接入支付宝产品的两种模式：商家自研和服务商代开发。商家自研模式涵盖创建应用、配置加签方式与应用网关等参数、应用上线、绑定商家账号及开通产品等步骤。服务商代开发模式包括创建第三方应用、协助商家开通产品、获取授权令牌及接口调用。此外，文档还提供了服务端SDK的集成指南，重点阐述了公钥模式与公钥证书模式下的AlipayClient对象初始化配置及关键参数说明，为开发者提供完整的技术接入指引。 ###### 接入指南 ###### 基础功能 - [界面规范](https://opendocs.alipay.com/open/01arn8.md): 该文档主要介绍了支付宝收银台的视觉规范与设计资源使用标准。核心内容涵盖两部分：首先，明确了收银台支付方式的展示要求，包括使用标准Logo、置于首位、默认勾选及添加推荐标记，以优化用户体验。其次，提供了设计资源下载服务，建议开发者使用支付宝官方提供的标准Logo、Icon及按钮素材，以确保支付功能的视觉一致性和规范性，相关素材可通过指定压缩包获取。 - [电脑网站支付快速接入](https://opendocs.alipay.com/open/00dn7k.md): 本文档提供了支付宝“电脑网站支付”产品的接入指引，涵盖支付、退款、关闭交易及对账四大核心功能。支付流程通过`alipay.trade.page.pay`接口实现，文档强调了需以异步通知或查询接口结果为准，并详细说明了验签与参数校验机制。退款功能支持12个月内资金原路退回及银行卡退款通知，提供了退款查询接口。此外，文档介绍了用于处理未支付订单的关闭交易接口和用于财务核对的对账单下载接口。最后，文档提供了Java SDK代码示例及沙箱环境接入注意事项，指导开发者完成从开发到上线的全过程。 - [异步通知说明](https://opendocs.alipay.com/open/00dn7l.md): 该文档介绍了支付宝PC网站支付结果的异步通知机制。核心在于解决通知丢失导致的订单状态异常，要求商户配合使用查询接口并预防重复支付。通知参数包含公共与业务两类，涵盖订单号、金额、状态及优惠券明细。交易状态分为四种，仅TRADE_SUCCESS和TRADE_FINISHED视为付款成功。文档详述了重试策略，并重点强调了验签与业务校验流程，包括签名验证及对订单号、金额、商户ID的一致性检查，确保交易安全与业务闭环。 ###### 扩展功能 - [花呗分期接入](https://opendocs.alipay.com/open/00dn7m.md): 该文档说明了电脑网站支付接入花呗分期的配置方法，涵盖新版与旧版接口。接入方式分为“标准收银台模式”和“单通道模式”。标准收银台模式仅支持用户承担手续费，无需额外开发；单通道模式支持将分期渠道前置，允许商家或用户承担手续费。单通道模式需传入分期数（仅限3、6、12期）和卖家承担比例（仅限100或0）。新版接口通过JSON格式传参，旧版接口则使用特定字符串格式，且单通道模式下花呗支付失败可启用其他渠道。 - [对账说明](https://opendocs.alipay.com/open/03axlt.md): 支付宝提供两种主要对账方式：商家平台手动下载和接口调用自动下载。商家平台方式支持下载资金账单和交易账单，日账单于次日生成，月账单于次月4日前生成，数据均支持回溯至2013年。接口对账方式通过调用查询账单下载地址接口获取下载链接，链接有效期仅30秒，支持收款账号接入和主账号授权接入两种模式，适合自动化处理。附录部分详细说明了账单文件包含业务与账务两类文件夹，内有明细与汇总表，且业务账单字段与支付接口字段存在明确的对应关系，商家也可自定义下载设置。 - [商户风险联防指引](https://opendocs.alipay.com/open/00dn7p.md): 本文档主要阐述了支付宝联防联控机制的业务场景、运作模式及技术接入规范。文档首先分析了被动欺诈和被动赌博两类风险场景，揭示了黑产利用商户订单进行非法资金转移的手段。随后介绍了联防模式，商户通过回传数据结合支付宝风控能力，可提升风险识别率并保障可信交易体验。文档明确了适用的支付产品，并重点规范了数据集成方式，要求通过business_params字段回传账户、网络、设备及交易等风控信息。最后，文档详细列出了各参数的定义与要求，并强调敏感数据须采用AES算法加密传输，确保数据安全。 - [用户下单 IP 获取指引](https://opendocs.alipay.com/open/05zrno.md): 本文档旨在指导商家正确获取用户在商家侧下单时的客户端 IP（mc_create_trade_ip），以提升支付宝支付安全性。该字段特指用户发起下单操作时的客户端 IP，而非支付网关流程后的 IP。获取方式主要分为无代理和有代理两种场景。无代理场景下，应直接通过 `getRemoteAddr` 等方法获取建连 IP，严禁读取易被伪造的 HTTP 头信息；有代理场景下，需配置 Nginx 或 Apache 等代理服务器传递真实 IP，并在后端解析 X-Real-IP 或 X-Forwarded-For 字段。文档提供了相应的代码示例、配置方法及伪造 IP 案例分析，强调需根据网络环境严格甄别 IP 来源的真实性。 ###### 集成工具 - [沙箱调试说明](https://opendocs.alipay.com/open/00dn7o.md): 本文档介绍了支付宝开放平台沙箱环境在电脑网站支付场景下的应用。沙箱环境作为与生产环境隔离的测试空间，允许开发者在未签约情况下并行开发，提升交付效率。文档明确了沙箱支持支付、查询、退款及关闭等核心接口，指出退款需全额且仅限一次，账单下载仅为模拟。调试时需注意：超时参数限制为15小时，不支持花呗分期与买家身份校验；支付仅限余额方式，需配合沙箱钱包或账户使用。文档强调了沙箱数据独立且非完全等同于生产环境，需使用指定网关进行配置，并最终以生产环境验收为准。 - [SDK & Demo 获取](https://opendocs.alipay.com/open/00dn7n.md): 本文档主要介绍开放平台服务端SDK及电脑网站支付Demo。SDK支持JAVA、PHP、Python、NodeJS和.NET语言，封装了签名验签与HTTP请求功能，旨在辅助开发者调用接口。文档还提供了电脑网站支付Demo的下载说明，涵盖JAVA、PHP和.NET三个版本，分别列出了Eclipse+JDK、PHP环境及Visual Studio等运行要求，并提示用户参考Demo内的readme.txt文件运行。 ###### API 列表 ###### 交易 - [统一收单下单并支付页面接口](https://opendocs.alipay.com/open/028r8t.md): 本文档介绍了支付宝电脑网站支付接口的使用方法，旨在指导开发者实现PC场景下的下单与支付功能。核心流程为在服务端调用SDK的`pageExecute`方法生成跳转表单或链接，引导用户至支付宝完成支付。文档详细说明了公共请求参数（如应用ID、签名、时间戳）及必选业务参数（商户订单号、金额、标题、产品码）。此外，还提供了丰富的可选参数配置，包括扫码支付模式、商品详情、花呗分期、二级商户信息及买家身份校验等。文档附带了Java、C#、PHP和Node.js的代码示例，并列举了常见的业务错误码及触发通知的类型，帮助开发者快速集成与排查问题。 - [统一收单交易关闭接口](https://opendocs.alipay.com/open/028wob.md): 本文档介绍了支付宝 `alipay.trade.close` 接口，用于关闭创建后一定时间内未支付的订单。接口要求传入公共参数（如 app_id、method、sign 等）及业务参数。业务参数中，`trade_no`（支付宝交易号）与 `out_trade_no`（商户订单号）二选一，若同时存在则优先取 `trade_no`。文档提供了 cURL、Java、C#、PHP 及 Node.js 的调用示例，并说明了公共与业务响应参数的结构。针对接口调用，文档列举了如“交易不存在”、“状态异常”等常见业务错误码及其解决方案，并说明了交易关闭后的异步通知机制，明确只有处于“等待买家付款”状态的交易才能被关闭。 - [统一收单交易退款接口](https://opendocs.alipay.com/open/028sm9.md): 该文档是支付宝退款接口的开发说明书，旨在指导开发者实现交易退款功能。核心功能支持卖家将款项原路退回买家，并支持单笔交易多次退款及分账退款。文档规定了严格的业务规则：交易需在有效期内，累计退款额不得超限，重试需保证退款请求号一致以防重复退款，且需通过fund_change字段判断实际退款成功与否。文档详细列举了公共请求参数与业务请求参数，如必填的退款金额及二选一的订单号。同时，提供了Java、PHP等多语言代码示例，并针对余额不足、交易关闭等常见业务错误码给出了具体的解决方案。 - [收单退款冲退完成通知](https://opendocs.alipay.com/open/029yy3.md): 该文档详细说明了支付宝“退款至银行卡完成通知”接口（alipay.trade.refund.depositback.completed）的规范。该通知仅在退款至银行卡且发起请求中包含`deposit_back_info`参数时触发。文档定义了包括通知ID、时间戳、签名信息等在内的公共请求参数，以及涵盖交易号、订单号、冲退状态、金额等关键字段的消息属性。其中，冲退状态区分成功（S）与失败（F），失败时资金转入用户余额。商户系统需同步响应“success”或“fail”，若处理失败，系统将在25小时内按递增间隔最多重试8次以确保消息送达。 - [统一收单交易查询接口](https://opendocs.alipay.com/open/028woa.md): 该文档详细介绍了支付宝统一收单交易查询接口的功能与使用方法。该接口旨在帮助商户主动查询订单状态，适用于处理支付通知丢失、系统错误或交易状态不明等异常情况。文档规定了公共请求参数（如app_id、签名类型）和业务请求参数（商户订单号或支付宝交易号二选一），并提供了cURL、Java、C#、PHP及Node.js多种语言的代码示例。响应参数涵盖交易状态、金额、买家信息等关键字段。此外，文档列举了常见的业务错误码及其解决方案，指导开发者完成接口集成与故障排查。 - [统一收单交易退款查询接口](https://opendocs.alipay.com/open/028sma.md): 该文档介绍了支付宝退款查询接口，用于商户查询退款请求是否执行成功。文档强调了三个关键注意事项：返回码10000仅代表查询操作成功，退款成功需判断refund_status字段是否为REFUND_SUCCESS；若需重试退款，必须保证退款请求号和金额一致；建议查询请求在退款发起10秒后进行。接口请求参数主要包括必选的退款请求号，以及二选一的交易号或商户订单号。响应参数详细包含了退款状态、金额、资金渠道、银行卡冲退信息及优惠券明细等。文档还提供了多种编程语言的调用示例及常见错误码解决方案。 ###### 账单 - [查询对账单下载地址接口](https://opendocs.alipay.com/open/028woc.md): 本文档介绍了支付宝商户离线账单下载接口，旨在支持商户快速查账并获取账单下载地址。文档详细说明了公共请求参数（如app_id、method、sign等）及业务请求参数（bill_type、bill_date、smid）。其中，bill_type支持交易、资金变动、营销活动等多种账单类型；bill_date需遵循特定格式且一般遵循T+1原则。响应结果包含下载链接，有效期为30秒。文中还提供了多种编程语言的调用示例及响应示例，便于开发者集成与调试。 - [常见问题](https://opendocs.alipay.com/open/03axlu.md): 该文档是对电脑网站支付常见问题的解答汇总，主要涵盖额度管理、资质审核、接口开发与页面展示四个方面。针对收款额度受限问题，文档指出额度取决于开通资质，商家可通过补全材料解除单笔和单日限额。当网站备案主体与商家主体不一致时，需上传授权函。在技术对接方面，文档明确分账查询需使用特定接口及参数；介绍了通过配置qr_pay_mode参数实现二维码个性化展示及前置模式，允许商户在iframe中嵌入支付二维码避免页面跳转；同时说明了利用return_url设置支付后跳转及通过GET请求生成支付链接的方法。 - [更新日志](https://opendocs.alipay.com/open/07128f.md): 本文档记录了支付宝开放平台2022年至2026年的产品更新日志。核心更新涉及账单下载接口的错误码扩充与参数描述优化，以及退款接口新增指定退款账号与凭证编号字段。此外，新增了用户下单IP获取指引与商户风险联防指引以提升支付安全，并发布了沙箱环境联调说明及退款到卡消息通知接口。这些变更优化了接口异常处理机制，增强了业务灵活性与系统安全性。 ##### 商家扣款 - [产品介绍](https://opendocs.alipay.com/open/06de8c.md): “商家扣款”是周期扣款的升级产品，支持商家引导用户签约后主动发起周期性扣款，适用于会员包月、租赁缴费等场景。核心规则包括单笔限额100元、扣款需在约定时间前5天内发起且仅限北京时间7:00-22:00。产品准入门槛较高，要求注册资本不低于2000万元、月活用户超300人且无经营风险的支付宝企业账号。费率为单笔0.6%-1%，支持退款退费，资金结算至余额。接入需遵循界面规范并明确交易场景与参数规则，支持支付并签约与独立签约两种模式。 ###### 权限集列表 ###### 商家扣款（必选） - [产品介绍](https://opendocs.alipay.com/open/0izsmy.md): 本文介绍了升级版“商家扣款”产品规范，该产品已于2026年3月28日完成升级。它支持商家引导用户签约后进行周期性主动扣款，适用于会员订阅、租赁缴费等场景。产品采用“支付并签约”模式，设定单笔扣款100元限额，并严格限制扣款时间与价格优惠幅度。接入门槛较高，要求企业注册资本不低于2000万元且经营状况良好，需具备相应支付能力。计费采取单笔费率模式（0.6%-1%），支持退款退费，资金一般实时到账。新接入商家需严格遵循新版文档要求。 - [接入准备](https://opendocs.alipay.com/open/0izne4.md): 本文档阐述了支付宝“商家扣款”产品的服务端SDK接入指南，涵盖商家自研与服务商代开发两种模式。自研商家需依次完成创建应用、配置加签与网关等参数、上线应用、绑定账号及开通产品。服务商需创建第三方应用，协助商家开通产品并获取代开发授权。文档最后详细介绍了SDK的集成方法，重点解析了公钥模式与公钥证书模式下的AlipayClient初始化配置及关键参数，指导开发者快速搭建开发环境并完成接口对接准备。 ###### 接入指南 - [支付并签约场景](https://opendocs.alipay.com/open/0iztfw.md): 本文档介绍了“商家扣款-支付并签约”产品的接入指引，旨在帮助商家实现用户在支付同时完成代扣协议签约。该产品仅支持自研或第三方应用代调用，不支持沙箱。文档详细阐述了三种接入场景：商家APP、支付宝小程序及PC端网页。APP和PC端通过`alipay.trade.app.pay`接口获取签约字符串，分别通过SDK唤起或扫码二维码完成流程；小程序则通过`alipay.trade.create`创建交易获取`tradeNo`后，调用`my.tradePay`唤起收银台。关键字段`product_code`需固定为`GENERAL_WITHHOLDING`，并需配置周期规则等签约参数。签约成功后，商家可使用`alipay.trade.pay`发起异步扣款，系统具备预通知机制。此外，文档还涵盖了签约与支付的异步通知处理、协议查询与解约、订单退款及对账单下载等辅助功能，确保商家能全流程管理代扣业务。 - [SDK&DEMO](https://opendocs.alipay.com/open/0izsn0.md): 本文档介绍了支付宝客户端与服务端 SDK 的功能定义及集成指引。客户端 SDK 需集成于商户 App，用于唤起支付宝 App 处理签约与支付请求，支持 iOS 和 Android 平台，并提供支付 SDK 与独立签约 SDK 两种方案以适应不同场景。服务端 SDK 需集成于商户后台，用于发起代扣、查询请求及验证结果，支持 JAVA、PHP、Python、NodeJS 和 .NET 五种语言，封装了签名验签等基础功能以辅助开发者快速接入。 - [异步通知说明](https://opendocs.alipay.com/open/0iziyx.md): 该文档详细阐述了支付宝支付结果异步通知机制。异步通知是指支付宝在支付完成后，通过POST请求将结果发送至商户指定的notify_url。为确保交易准确，文档要求商户必须同时接入主动查询接口，防止因通知丢失导致订单状态不一致或用户重复支付。核心内容包括：通知参数详解（如交易状态、金额信息）、通知重试机制（未收到success响应时按特定频率重发）、以及严格的验签与业务校验流程。商户需对通知进行RSA验签，并校验订单号、金额、商户ID等信息的真实性，仅在交易状态为TRADE_SUCCESS或TRADE_FINISHED时视为支付成功，最终返回success停止通知。 ###### API 列表 ###### 签约 - [支付宝个人协议页面签约接口](https://opendocs.alipay.com/open/08bntw.md): 本文档详细介绍了支付宝代扣协议页面签约接口的技术规范。该接口用于生成跳转链接，支持用户在支付宝H5页面完成代扣协议签约。文档说明了接口需在服务端调用SDK执行，并详细列出了公共请求参数（如app_id、method、sign等）及复杂的业务请求参数。业务参数涵盖必选的个人签约产品码与接入方式，以及周期扣款规则、商户签约号、子商户信息、用户实名信息、芝麻授权、设备信息等可选配置。文档提供了Java、C#和PHP的完整代码示例，展示了请求构建与执行过程，并说明了响应内容为用于页面跳转的HTML表单或URL，最后给出了异步通知的触发示例。 - [支付宝个人代扣协议查询接口](https://opendocs.alipay.com/open/08bntu.md): 本文档详细说明了支付宝个人代扣协议查询接口的定义与使用规范。该接口旨在帮助商户查询用户签约协议的详细信息，包括协议状态、有效期及签约主体等。文档界定了公共请求参数与业务请求参数，重点说明了用户标识字段的优先级规则，推荐使用alipay_open_id。响应参数涵盖了协议生命周期、扣款额度及周期扣款计划等关键数据。此外，文档提供了cURL、Java、C#及PHP的代码示例，并列举了系统错误与业务错误码及其解决方案，为开发者接入提供了完整的技术参考。 - [支付宝个人代扣协议解约接口](https://opendocs.alipay.com/open/08bntt.md): 本文档定义了支付宝个人代扣协议解约接口，接口名为alipay.user.agreement.unsign。接口要求传入公共参数（如app_id、签名、时间戳）及业务参数。业务参数中，用户标识支持alipay_open_id、alipay_user_id或alipay_logon_id三选一，协议标识支持agreement_no或external_agreement_no二选一。文档提供了cURL、Java、C#和PHP的集成示例，详细说明了请求与响应结构、业务错误码处理（如协议不存在、参数错误等）及异步通知机制，指导开发者正确调用接口解除用户签约关系。 ###### 支付 - [app支付接口2.0接口](https://opendocs.alipay.com/open/08bnts.md): 本文档详细介绍了支付宝App支付接口，用于生成可信签名字符串以唤起客户端完成支付与签约。接口支持普通支付及周期扣款签约功能，请求参数包含公共参数（如app_id、method、sign等）和业务参数（如订单号、金额、标题）。重点描述了签约参数配置，支持设置周期类型、执行时间、单次限额及总次数等扣款规则。文档提供了Java、C#、PHP及Node.js四种语言的SDK调用示例，指导获取用于客户端调起的orderStr。此外，还列举了常见业务错误码及解决方案，并说明了支付成功、交易关闭等状态的异步通知机制。 - [统一收单交易支付接口](https://opendocs.alipay.com/open/08bntx.md): 本文档介绍了支付宝商家扣款协议支付接口，用于商户在用户签约后进行免密代扣操作。文档详细定义了接口的公共请求参数（如app_id、method、sign等）和业务请求参数，其中业务参数必填项包括商户订单号、订单金额、标题、产品码（固定为GENERAL_WITHHOLDING）及代扣协议信息。文档提供了cURL、Java、C#、PHP及Node.js等多种语言的请求示例。在响应方面，阐述了公共与业务响应参数，包括交易号、买家信息及支付状态等。此外，文档汇总了协议失效、余额不足、系统异常等常见业务错误码及其解决方案，并说明了异步通知机制及相关参数示例，帮助开发者实现稳定的代扣功能。 - [统一收单交易查询接口](https://opendocs.alipay.com/open/08bntl.md): 本文档详细阐述了支付宝统一收单交易查询接口的功能与使用方法。该接口支持商户主动查询订单状态，适用于商户系统未接收通知、返回系统错误或需确认支付状态等场景。请求参数包含应用ID、签名等公共参数，以及商户订单号或支付宝交易号二选一的业务参数，并支持定制查询选项。响应结果涵盖交易状态、订单金额、买家信息、资金渠道及结算详情等关键数据。文档进一步提供了Java、C#、PHP等多种语言的SDK调用示例，并列出了交易不存在、参数无效等常见业务错误码及其解决方案，助力开发者高效集成与调试。 - [统一收单交易退款接口](https://opendocs.alipay.com/open/08bntn.md): 本文档详细介绍了支付宝退款接口（alipay.trade.refund）的功能与使用规范。该接口支持卖家将支付款原路退回买家，支持全额及多次部分退款，但累计金额不得超过交易总额。文档强调了退款成功的判断标准以fund_change=Y为准，并指出重试时需保持退款请求号一致以防止重复退款。此外，涉及分账的退款需接收方开启回退授权。文档还涵盖了公共与业务请求参数说明、多语言SDK调用示例及常见业务错误码解决方案，助力开发者安全高效集成退款功能。 - [统一收单交易关闭接口](https://opendocs.alipay.com/open/08bnto.md): 该文档详细介绍了支付宝“统一收单交易关闭接口”。该接口主要用于交易创建后，用户在一定时间内未进行支付时，商户可调用此接口直接关闭未付款交易。文档明确了公共请求参数（如app_id、method、sign等）及业务请求参数，其中业务参数trade_no与out_trade_no二选一，优先取trade_no。文档提供了cURL、Java、C#、PHP和Node.js五种语言的请求示例，详细说明了SDK初始化与调用流程。此外，文档还列出了公共响应参数、业务响应参数、正常及异常响应示例，并针对参数无效、交易状态异常、系统错误等常见业务错误码给出了具体的解决方案，最后说明了交易关闭与成功状态下的通知触发机制。 - [统一收单交易撤销接口](https://opendocs.alipay.com/open/08bntp.md): 本文档详细介绍了支付宝撤销交易接口的使用规范。该接口主要用于处理支付失败或系统超时的场景：若订单未支付，系统将关闭订单；若已支付，则自动退款。文档明确指出，此接口仅适用于结果未知的情况，正常退款应使用退款API。文中详细列出了公共请求参数（如app_id、签名信息）及二选一的业务参数（商户订单号或支付宝交易号）。此外，文档提供了Java、C#、PHP等多种语言的代码示例，说明了响应参数中重试标志和动作类型的含义，并列举了包括“商户余额不足”、“交易已完结”在内的多种业务错误码及其解决方案，帮助开发者正确集成和处理异常。 ###### 对账 - [查询对账单下载地址接口](https://opendocs.alipay.com/open/08bntr.md): 本文档介绍了支付宝离线账单下载接口的使用方法，旨在帮助商户通过API获取账单下载地址以快速查账。文档详细说明了公共请求参数（如app_id、method、sign等）和业务请求参数，其中业务参数包括必选的账单类型（bill_type）和账单日期（bill_date），以及可选的二级商户ID（smid）。接口支持多种账单类型，如交易账单、资金变动账单及营销账单等。文档提供了Java、C#、PHP等语言的请求示例，并说明了响应参数结构，特别指出下载链接有效期为30秒。最后，文档列举了“账单不存在”、“入参不合法”、“调用频率超限”等常见业务错误码及其对应的解决方案。 ###### 相关资料 - [支付界面规范](https://opendocs.alipay.com/open/08ayir.md): 本文档旨在为商家和开发者提供支付宝收银台的设计规范与素材资源，以确保用户体验的一致性。核心规范包括使用标准LOGO、将支付方式置于首位、默认勾选设置以及添加推荐角标和副标题。文档提供了包含支付宝、花呗及花呗分期的标准Logo、Icon及功能按钮素材的下载包，建议开发者下载并使用这些官方资源进行开发，以符合视觉标准并优化用户的支付流程与体验。 - [常见场景码值](https://opendocs.alipay.com/open/08bg92.md): 该文档说明了调用支付宝个人协议页面签约接口时，签约场景参数的填写规范。支付宝为彩票、社交、医疗、出行、餐饮等常见行业预定义了标准场景码。若商家业务不在列表中，可按规则自定义场景码，格式为“INDUSTRY|业务场景英文大写（无空格，支持下划线）”。文档提供了详细的场景码与行业对照表，涵盖民生、娱乐、金融及创新支付等多个领域，供开发者参考使用。 - [常见问题](https://opendocs.alipay.com/open/0izne6.md): 本文档是支付宝商家扣款产品的常见问题解答，核心涵盖签约管理、扣款规则与技术参数三个层面。签约方面，同一用户可在同商家下持有多套协议，但同场景限签一次，支持设置有效期与主动解约。扣款方面，商家通过接口主动发起，受限于单笔≤100元、单月≤3万元的额度管控，周期最短7天；扣款失败建议重试不超2次，成功前勿重复发起。技术方面，明确了产品码设置、Identity Hash生成规范及常见错误码处理，如日期不符、超额或超次等，为商家接入提供了详细的操作指引与风控建议。 - [更新日志](https://opendocs.alipay.com/open/08astd.md): 该文档记录了2023年7月至2026年3月期间支付宝商家产品及API接口的更新日志。核心内容包括：商家扣款产品于2026年3月完成重大升级，新接入商家须使用新版本，旧版本仅维护存量商家；该产品此前已全面开放并支持多种签约场景。文档还详细记录了账单下载、交易查询、退款等关键接口的变更，涵盖新增限流及无数据等错误码、调整业务参数及返回字段属性等。此外，平台还调整了商户准入条件（如要求账号认证时长和活跃用户数），并标准化了商户App集成签约SDK的方式。 - [更新日志](https://opendocs.alipay.com/open/08b7wh.md): 本文档主要记录了产品功能的更新日志，涵盖了两个关键时间节点的变更内容。首先，在2024年11月7日的更新中，系统对准入条件及相关说明内容进行了更新，旨在优化准入规则或说明文档。其次，回顾2023年7月15日的更新，平台新增并全面开放了商家扣款产品。该产品功能强大，支持“先签约后代扣”和“支付后签约”两种主要的业务应用场景，为商家提供了灵活的资金扣款解决方案。整体而言，文档体现了产品在功能开放与规则完善方面的持续迭代。 ##### 预授权支付 - [预授权支付产品介绍](https://opendocs.alipay.com/open/06de96.md): 预授权支付是支付宝推出的升级版支付产品，旨在替代原有的支付宝预授权与新当面资金授权。该产品允许商家在用户消费前冻结资金作为押金，消费后按实际金额扣除，剩余资金解冻返还。产品覆盖住宿、出行、租物等线上线下场景，线上支持App/H5及小程序，线下仅限酒店、租车等特定类目。商家需使用企业账号申请，开通时须精准选择交易场景。计费方面，预授权阶段免费，转支付阶段费率为0.6%-1%。资金实行T+1结算，支持12个月内退款且退还手续费。 ###### 权限集列表 ###### 预授权支付（必选） - [产品介绍](https://opendocs.alipay.com/open/064jh5.md): 预授权支付是支付宝预授权与新当面资金授权的升级产品，支持商家在用户消费前冻结资金作为押金，消费后扣款并解冻余额。该产品适用于住宿、出行、租物等押金场景，覆盖线上及特定类目的线下场所。商家需使用企业账号开通并明确选择交易场景，小程序接入需匹配APPID类型。计费方面，预授权阶段免费，转支付阶段收取0.6%-1%服务费，资金T+1日到账，退款周期12个月且手续费可退。建议旧产品用户适时迁移接入。 - [接入准备](https://opendocs.alipay.com/open/064jh6.md): 本文档介绍了使用支付宝开放平台服务端SDK接入预授权支付产品的流程，涵盖商家自研和服务商代开发两种模式。自研商家需完成创建应用、配置参数（如加签方式、应用网关）、上线应用、绑定账号及开通产品，注意选择正确的交易场景。服务商模式需创建第三方应用、协助商家开通产品并获取代开发授权令牌。文档最后详细说明了SDK的下载集成及AlipayClient初始化配置，重点解析了公钥模式与公钥证书模式下的参数设置与代码示例，帮助开发者快速实现接口调用。 ###### 接入指南 ###### 线上场景 - [快速接入](https://opendocs.alipay.com/open/064jh8.md): 本文档为支付宝预授权支付功能的接入指南，旨在指导商家和服务商实现资金的冻结、扣款及解冻流程。核心业务流程包含三个阶段：首先，商户调用冻结接口生成订单，通过客户端唤起支付宝收银台完成用户授权与资金冻结；其次，服务结束后，商户可通过“冻结转支付”接口扣除实际费用，支持自动或手动解冻剩余资金；最后，针对未消费场景，支持主动解冻或系统自动解冻。文档详细介绍了APP、H5及小程序端的接入代码、关键参数配置、异步通知处理机制，并补充了交易查询、撤销、退款及对账等相关辅助功能的接口说明与示例代码。 - [iOS 集成流程](https://opendocs.alipay.com/open/064jh9.md): 本文档是支付宝SDK在iOS端的集成使用指南。内容涵盖了SDK的导入方式及依赖库配置，支持CocoaPods和手动导入。重点阐述了支付流程：建议在服务端组装请求参数与签名，客户端调用支付接口，并通过AppDelegate配置URL处理方法来接收支付结果。文档还提供了Demo运行注意事项、Swift项目桥接配置、核心API接口说明及参数详解，强调了私钥保存在服务端的安全规范，并指引了联调问题的排查方向。 - [Android 集成流程](https://opendocs.alipay.com/open/08nz3k.md): 本文档指导开发者将支付宝 Android SDK 从旧的 AAR 依赖迁移至 Maven 依赖。主要步骤包括：移除旧的 AAR 包和依赖配置，在项目及模块的 build.gradle 中配置 Maven 仓库和 SDK 依赖。SDK 运行需配置网络相关权限。支付接口调用需在非 UI 线程通过 PayTask 对象执行 payV2 方法，传入服务端生成的订单信息和加载状态参数。支付结果可通过客户端同步回调或服务端异步通知获取。此外，文档还提供了获取 SDK 版本号的方法及联调问题排查指引。 ###### 线下场景 - [快速接入](https://opendocs.alipay.com/open/09bn1m.md): 该文档为支付宝预授权支付的快速接入指引，适用于租车、酒店等需预先冻结资金的场景。核心流程涵盖资金冻结、冻结转支付、资金解冻及退款对账。资金冻结支持“商家扫用户付款码”和“用户扫商家二维码”两种模式，分别通过调用冻结接口或发码接口实现。文档详细介绍了各业务环节的关键API，包括资金冻结、操作查询、转支付、解冻、撤销、交易查询关闭及退款等接口。针对每个接口，文档提供了完整的Java请求示例、重要入参出参说明及业务处理逻辑（如轮询查询、幂等性控制），帮助开发者安全、高效地集成预授权支付功能。 ###### API 列表 ###### 预授权 - [my.tradePay](https://opendocs.alipay.com/open/064jhf.md): 本文档介绍了支付宝小程序API `my.tradePay`的使用方法，该API用于发起支付，支持JSAPI支付和预授权支付两种模式。文档特别提示已接入旧版产品的开发者需在2024年3月1日前完成升级。JSAPI支付通过服务端获取的交易号唤起收银台，预授权支付则通过预授权参数唤起冻结页。接入流程涵盖开发设置、产品开通、账号绑定及前后端交互。文档详细说明了入参定义、回调结果码含义，并强调前端返回码9000不能作为支付成功的依据，必须以服务端异步通知或查询结果为准。此外，还解答了关于H5外跳限制及跨应用支付支持的常见问题。 - [线上资金授权冻结接口](https://opendocs.alipay.com/open/064jhe.md): 该文档介绍了支付宝资金授权订单冻结接口，用于预授权支付场景下的资金冻结。接口通过服务端生成可信签名字符串，供客户端拉起支付宝收银台。核心配置包括必填的订单号、金额、标题及固定为PREAUTH_PAY的产品码，并支持免押受理台、后付费项目、支付渠道限制及芝麻信用扩展参数等可选设置。文档提供了Java、C#、PHP的SDK调用示例，说明了响应数据的处理方式，列举了涉及权限、状态及参数校验的常见业务错误码，并定义了冻结成功、订单关闭等异步通知类型，为商户接入线上押金冻结功能提供了完整的开发指引。 - [资金授权操作查询接口](https://opendocs.alipay.com/open/064jhg.md): 本文档介绍了支付宝资金授权操作明细查询接口的使用方法。该接口用于查询单笔冻结、解冻或支付明细的详细信息。文档强调了查询不同操作类型时的传参规则：查询冻结明细默认operation_type为FREEZE；查询解冻明细需传UNFREEZE；查询支付明细时out_request_no应传入out_trade_no且operation_type为PAY；Complete模式下查询关联解冻明细需特殊处理。接口包含公共请求参数和业务请求参数，响应中区分了资金操作状态与授权单状态。文档还提供了Java、PHP等多种语言的请求示例、响应参数说明及常见业务错误码解决方案，指导开发者正确集成与调试。 - [资金授权撤销接口](https://opendocs.alipay.com/open/064jhh.md): 本文档介绍了支付宝资金授权操作撤销接口的使用规范与调用方法。该接口仅适用于业务超时或授权结果未知时的终止处理，严禁用于已确认成功的冻结操作，且撤销须在冻结后24小时内进行。文档详细定义了公共与业务请求参数，特别是订单号与操作流水号的配对规则，提供了Java、PHP等多种语言的代码示例。同时，阐述了响应参数含义，列举了系统错误、超时、权限限制等业务错误码及其解决方案，并说明了异步通知机制，帮助开发者正确实现资金授权撤销功能。 - [资金授权解冻接口](https://opendocs.alipay.com/open/064jhi.md): 本文档介绍了支付宝资金授权解冻接口，该接口用于商家在资金授权后因故将冻结资金解冻。商家需提供授权订单号、解冻金额、请求流水号等必选参数发起请求。文档详细列出了公共请求参数与业务请求参数的定义，并提供了cURL、Java、C#及PHP的调用示例。响应结果包含解冻状态、操作流水号及资金明细。此外，文档说明了系统繁忙、订单不存在、金额超限等业务错误码的处理方式，以及资金解冻成功的异步通知机制。 - [资金授权发码接口](https://opendocs.alipay.com/open/09bj50.md): 本文档详细描述了支付宝资金预授权发码接口的使用规范。该接口允许商户通过收银台或后台生成二维码，用户扫码后完成资金冻结。文档界定了公共请求参数（如应用ID、签名、时间戳）和业务请求参数，后者包含商户订单号、冻结金额、产品码及可选的免押受理台模式、支付渠道限制等。同时提供了Java、C#、PHP等语言的调用示例。响应结果包含生成的二维码码串和图片地址。文档还列举了系统繁忙、余额不足等常见业务错误码及其解决方案，并定义了资金冻结成功或订单关闭时的异步通知触发机制与参数示例。 - [资金授权冻结接口](https://opendocs.alipay.com/open/09bk7c.md): 本文档详细说明了支付宝资金授权冻结接口的使用方法，该接口用于收银员扫码后通过付款码发起资金冻结。文档涵盖了公共请求参数和详细的业务请求参数，包括必选的付款码、订单号、金额及产品码，以及可选的免押受理台模式、后付费项目和支付渠道控制等配置。响应参数中包含授权订单号、状态及预授权类型等信息。此外，文档提供了cURL、Java、C#和PHP的代码示例，列举了系统错误、商户权限错误、用户账户错误等业务错误码及其解决方案，并说明了异步通知的触发类型与示例。 ###### 交易 - [统一收单交易支付接口](https://opendocs.alipay.com/open/064jhk.md): 本文档详细说明了支付宝预授权转支付接口的定义与使用规范。该接口用于用户授权冻结资金后，商户通过授权单号发起扣款。关键请求参数包括商户订单号、金额、产品码（PREAUTH_PAY）及必填的资金预授权单号，支持设置扣款后是否解冻剩余金额。文档涵盖了公共与业务请求参数详解，提供了Java、PHP、C#等多语言调用示例。响应结果包含交易号、买家信息及资金渠道明细。此外，文档还列举了权限不足、金额超限、订单状态异常等常见业务错误码及其解决方案，并附带了异步通知类型与示例供开发者参考。 - [统一收单交易关闭接口](https://opendocs.alipay.com/open/064jhl.md): 本文档详细介绍了支付宝统一收单交易关闭接口的使用规范。该接口主要用于在交易创建后，若用户在规定时间内未完成支付，商户可调用此接口关闭未付款交易。文档明确了接口的公共请求参数（如app_id、method、sign等）及业务请求参数，重点指出需在trade_no与out_trade_no中二选一进行交易定位。文档提供了Java、C#、PHP、Node.js等多种开发语言的SDK调用示例，并解析了公共与业务响应参数的结构。此外，还列举了ACQ.TRADE_NOT_EXIST等常见业务错误码及其解决方案，强调了仅“等待买家付款”状态的交易可被关闭，同时说明了交易关闭后的异步通知机制。 - [统一收单交易退款查询接口](https://opendocs.alipay.com/open/064jhm.md): 该文档介绍了支付宝退款查询接口，用于商户查询退款请求的执行结果。核心要点包括：接口返回码10000仅代表查询操作成功，需依据refund_status字段判断退款是否成功；建议查询请求在退款发起10秒后进行；重试时需保证退款请求号与金额一致以防重复退款。文档详细说明了公共请求参数与业务请求参数，其中业务参数必填退款请求号，交易号与订单号二选一。响应数据涵盖退款状态、金额、资金渠道及银行卡冲退信息等。此外，文档还提供了Java、PHP等多种语言的调用示例及常见错误码解决方案。 - [统一收单交易查询接口](https://opendocs.alipay.com/open/064jhn.md): 本文档详细说明了支付宝交易查询接口的功能与使用方法。该接口支持商户主动查询订单状态，适用于系统异常未收到通知、返回系统错误或处理中等场景。请求需包含应用ID、签名等公共参数，业务参数中商户订单号与支付宝交易号二选一，并支持定制查询选项。响应内容涵盖交易状态、金额详情、买家信息、支付渠道及结算信息等核心数据。文档还提供了cURL、Java、C#、PHP及Node.js的代码示例，并列出了参数无效、交易不存在等常见业务错误码及其解决方案，帮助开发者快速集成与排查问题。 - [统一收单交易退款接口](https://opendocs.alipay.com/open/064jho.md): 该文档详细介绍了支付宝退款接口（alipay.trade.refund）的功能规则、参数说明及接入指引。核心功能支持卖家将支付款原路退回买家，支持单笔交易多次部分退款，但累计金额不得超过交易总额。文档强调了关键业务规则：退款需在约定时间内进行，重试时需保证退款请求号不变以防止重复退款，且同一笔交易退款间隔需大于3秒。退款成功的判断标准为返回参数`fund_change=Y`。对于涉及分账的订单，需接收方开启回退授权。文档还列举了公共与业务请求参数、响应参数结构，提供了Java、PHP等多种语言的代码示例，并汇总了常见业务错误码及其解决方案，指导开发者正确处理买家状态异常、余额不足等各类异常情况。 - [支付宝订单信息同步接口](https://opendocs.alipay.com/open/09gic4.md): 本文档详细介绍了支付宝 `alipay.trade.orderinfo.sync` 接口，用于商户向支付宝同步订单业务信息，主要适用于芝麻信用授权及履约场景。文档明确了请求需包含应用ID、签名、时间戳等公共参数，以及支付宝交易号、外部请求号、业务类型等必选业务参数。其中，外部请求号用于幂等控制，业务类型支持信用授权和信用代扣。`order_biz_info` 字段用于同步履约状态（如“COMPLETE”或“CLOSED”），需配合特定业务逻辑使用。文档还提供了Java、PHP等语言的SDK调用示例，并列举了响应参数及常见的业务错误码解决方案。 ###### 账单 - [查询对账单下载地址接口](https://opendocs.alipay.com/open/064jhr.md): 该文档详细介绍了支付宝商户离线账单下载接口的使用规范。接口`alipay.data.dataservice.bill.downloadurl.query`旨在帮助商户获取离线账单下载地址以便快速查账。文档明确了请求参数结构，包括应用ID、签名、时间戳等公共参数，以及账单类型、账单日期等业务必选参数。其中，账单类型涵盖交易、资金变动、营销活动及直付通等多种业务场景，账单日期支持日账单和月账单查询，数据最早可追溯至近6年。响应结果包含有效期为30秒的下载链接。此外，文档提供了Java、PHP、C#等语言的SDK调用示例，并列出了账单不存在、参数不合法、频率超限等常见业务错误码及其相应的解决方案，指导开发者正确集成接口。 - [常见问题](https://opendocs.alipay.com/open/064jhs.md): 该文档主要解答了支付宝预授权支付接口调用中的常见问题与处理方案。针对接口返回系统未知错误（code=20000），文档详细规定了资金授权冻结、查询、撤销及解冻等不同接口的应对措施，包括立即查询状态、重试一分钟或联系客服，强调不可随意推断业务结果。针对特定错误码（如ALIN1018031），需检查产品开通状态、功能包挂载及参数；线上资金授权冻结接口需使用sdkExecute方式调用。此外，文档还明确了预授权退款有效期为12个月，支持一次授权多次扣款，系统自动解冻默认为1年，并对转支付返回“等待付款中”的状态提供了查询建议。 ###### 相关资料 - [对账说明](https://opendocs.alipay.com/open/064jhb.md): 支付宝提供商家平台下载和接口调用两种对账方式。商家平台支持下载资金账单和交易账单，分为日账单（次日生成）和月账单（次月4日左右生成），数据支持范围始于2013年。接口对账适用于自动化场景，商户调用alipay.data.dataservice.bill.downloadurl.query接口获取下载地址，需在30秒有效期内完成下载。账单分为业务账单和财务账单，包含明细与汇总表，文档提供了关键业务字段与接口参数的对应关系说明，商家还可自定义下载设置。 - [异步通知说明](https://opendocs.alipay.com/open/064jha.md): 本文档详细阐述了支付宝异步通知机制，涵盖支付与资金授权两大场景。核心要点包括：异步通知通过POST请求发送至商户指定URL，HTTP 200状态码表示成功。为确保数据一致性，商户需接入主动查询接口以防止漏单，并建议在更换订单号前查询状态以防重复支付。文档重点解析了授权与支付通知的参数定义、状态流转及默认触发规则。在安全处理上，商户须执行严格的验签流程（推荐SDK或手动RSA验签），并校验订单号、金额与身份ID的真实性。此外，商户服务器需具备外网访问能力，且在处理完成后必须输出“success”字符，否则支付宝将在25小时内按特定频率重发通知，确保交易结果准确送达。 - [支付渠道说明](https://opendocs.alipay.com/open/08gj4x.md): 本文档提供了一份支付渠道代码与名称的标准化映射表，共包含12种支付方式。文档详细列出了支付宝生态内的工具（如支付宝红包、账户、集分宝）、商户侧资产（如商家储值卡、商户优惠券、商户红包）、通用支付工具（如折扣券、预付卡、券）、传统金融渠道（银行卡）以及理财和数字货币渠道（余额宝、数字人民币）。该表格旨在为系统识别和处理不同类型的支付交易提供统一的代码规范。 - [沙箱调试说明](https://opendocs.alipay.com/open/08o704.md): 本文档介绍了支付宝沙箱环境及其在预授权支付调试中的应用。沙箱环境是与生产环境隔离的测试环境，支持核心业务链路，允许开发者在无需签约的情况下并行开发，且不影响生产数据。文档重点阐述了三个核心业务用例：资金授权解冻、资金授权撤销以及预授权支付（含转支付和退款）。每个用例均提供了详细的接口调用序列、参数示例及响应报文，涵盖了冻结、支付通知、查询、解冻、撤销及退款等关键操作。文档提醒开发者注意沙箱与生产环境的差异及数据独立性，并在上线前进行生产环境验收。 - [更新日志](https://opendocs.alipay.com/open/064jht.md): 该文档是支付宝开放平台接口更新日志，记录了从2023年7月至2026年1月的产品迭代情况。核心更新涵盖账单下载、交易查询与退款、资金授权及预授权支付等业务。主要变更包括：多次优化账单下载接口并新增限流、数据不存在等错误码；增强交易退款功能，支持指定退款账号与凭证；调整交易查询响应参数；新增订单信息同步、资金授权冻结与发码等接口；发布预授权支付产品并调整其退分账规则；集成芝麻免押相关参数与错误码。 - [更新日志](https://opendocs.alipay.com/open/08duar.md): 2023年7月15日，新增“预授权支付”产品并全面开放。该产品是指商家在用户实际消费前，可提前冻结用户一定资金作为押金。待消费完成后，系统按实际金额从冻结资金中扣除给商家，剩余金额解冻并返还给用户。此产品旨在解决需要预付押金场景的支付需求。 ##### AI按量付费 - [产品介绍](https://opendocs.alipay.com/open/0ix1m4.md): 支付宝“AI收”是一款基于HTTP 402状态码的A2M支付方案，支持API、数字内容及算力资源直接向AI智能体收款。该方案通过402报文透传信息，利用支付宝支付skill实现无感鉴权和原生支付，无需传统登录跳转。其核心优势在于支持真正的“按用收费”，可对单次API调用精准定价。产品面向企业及个人账号开放，标准费率为1.0%，个人开发者在特定活动期可享零费率优惠。资金默认实时到账，支持退款并退回服务费。 - [接入准备](https://opendocs.alipay.com/open/0ix1mb.md): 本文档介绍了商家如何使用支付宝开放平台服务端SDK自研接入“AI收”产品。该产品不支持服务商代接入，商家需先一站式开通服务，再下载支持五种语言版本的SDK并集成至服务端。文档核心详细说明了接口调用前的alipayClient对象初始化配置，重点对比了“公钥模式”与“公钥证书模式”两种加签方式。文中提供了Java代码示例，并详细解释了网关地址、APPID、私钥、支付宝公钥、签名算法及证书路径等关键配置参数的获取方式与设置规范，帮助开发者完成SDK配置与接口对接。 - [接入指南](https://opendocs.alipay.com/open/0ix1mc.md): 本文档为“AI收”产品接入指引，该产品仅支持自研商家通过API接入，暂不支持沙箱调试。核心流程包括：商家检测到未付费请求时，返回包含签名账单的402响应；用户完成支付后携带支付凭证重试；商家调用凭证验证接口校验有效性，验证成功则返回资源并异步发送履约回执。文档详细规定了402响应头的构造规范、RSA2私钥加签方法，以及支付凭证验证与履约回执接口的调用方式和参数说明，确保交易闭环的安全与完整性。 ###### API 列表 - [A2A商家履约回执确认接口](https://opendocs.alipay.com/open/0j3wq1.md): 该文档详细介绍了支付宝接口`alipay.aipay.agent.fulfillment.confirm`，用于A2A商家履约回执确认。文档定义了请求参数，包括app_id、method等公共参数及必选的业务参数`trade_no`（支付宝交易号）。提供了C#、Java、PHP及HTTP的请求示例，展示了SDK初始化与调用流程。响应参数包含网关返回码及业务信息。文档还列举了`SYSTEM_ERROR`、`TRADE_NOT_FOUND`等业务错误码，并给出了相应的解决方案，指导开发者处理系统繁忙、参数错误、身份校验失败及交易状态异常等问题。 - [A2A商户支付凭证验证接口](https://opendocs.alipay.com/open/0j3wq2.md): 该文档详细介绍了支付宝接口`alipay.aipay.agent.payment.verify`，用于A2A场景下商户支付凭证验证。文档规定了公共参数（如app_id、sign等）及业务参数（trade_no、payment_proof等）的规范。支持C#、Java、PHP及HTTP请求，响应包含凭证有效性及交易详情。文档列举了系统错误、凭证状态异常、交易信息不匹配等多种业务错误码及解决方案，指导开发者安全、规范地完成凭证验证流程。 - [常见问题](https://opendocs.alipay.com/open/0ix1me.md): 本文档解答了服务接入中的两个关键问题。首先，加签内容不支持自定义，必须调用SDK内置util方法。在加签前，需将参数Map按key字典序排序并拼接为特定格式，且仅支持特定参数。其次，获取service_id需通过一站式开通服务工具填写并提交服务信息。注意，service_id唯有在服务信息审核成功后才正式生效，用户需留意审核进度。 - [更新日志](https://opendocs.alipay.com/open/0ix1mf.md): 本文档记录了2026年4月的产品更新日志。核心内容包括：4月15日发布新产品“智能收”，支持向访问API及数字资源的AI智能体自动收款；4月29日更新接入指南，在支付凭证验证接口中新增入参client_session；4月30日产品更名，“智能收”正式更名为“AI收”，原有接入流程保持不变。整体反映了产品发布、接口优化及品牌升级的关键变更。 #### 私域产品 ##### 支付宝电子发票 - [产品介绍](https://opendocs.alipay.com/open/0h6vh3.md): 支付宝电子发票为商家和服务商提供三大核心产品：开通乐企开票、正向开票与反向开票。“开通乐企开票”支持一站式完成税局资质申请与配置；“正向开票”由销售方为购买方开票，直连税务系统，适用于餐饮、零售、停车等场景，支持支付即开票或后续申请；“反向开票”则由购买方为销售方开票，适用于资源回收、农产品收购及灵活用工场景。服务支持接口或页面开通，免费向企业、个人及个体工商户开放，旨在提供稳定、安全、合规的开票体验。 ###### 权限集列表 ###### 开通乐企开票 - [产品介绍](https://opendocs.alipay.com/open/0h6pzn.md): 本文档介绍了“开通乐企开票”产品，该产品旨在为服务商及集团型企业提供接口授权能力，一站式完成税局乐企联用资质申请及开票配置。产品支持正向与反向开票场景的开通。核心使用流程包括企业提交申请、商家登录开通页、支付宝人工审核及税局平台授权确认四个步骤。该服务免费开放，支持支付宝企业账号、个人账号及个体工商户准入，接入方需满足地方税务局试点要求及开发规范。 - [接入准备](https://opendocs.alipay.com/open/0h6pzu.md): 本文档主要介绍使用支付宝开放平台服务端SDK快速接入“开通乐企开票”产品，支持商家自研和服务商代开发两种模式。自研商家需完成创建应用、配置关键参数（如接口加签方式、应用网关）及上线审核等流程。服务商模式需创建第三方应用并获取商家授权令牌进行接口调用。文档重点详述了SDK的集成步骤，对比了公钥模式与公钥证书模式下的AlipayClient对象初始化方法、代码示例及关键参数配置，为开发者提供了完整的技术接入指南。 - [接入指南](https://opendocs.alipay.com/open/0h6pzv.md): 本文档介绍了支付宝“开通乐企发票”产品的接入流程，支持自研商家或第三方应用代调用，不支持沙箱调试。流程包含四个阶段：一是完成企业实名认证、应用上线及产品权限申请等前置条件；二是拼接PC或移动端授权URL并引导商户操作；三是部署HTTPS回调接口接收包含授权令牌的异步通知；四是通过订阅消息或调用API查询开通结果。文中详细列出了关键参数、产品码对照表、URL拼接规范、回调接口报文示例及注意事项，如反向开票仅限企业支付宝账户等。 ###### API 列表 - [发票产品查询接口](https://opendocs.alipay.com/open/0hh1vy.md): 该文档详细介绍了支付宝接口`alipay.commerce.ec.invoice.product.query`（发票产品查询）的功能与技术规范。该接口用于查询平台已发布的发票产品信息，支持第三方代调用。文档明确了请求需包含应用ID、签名、时间戳等公共参数，以及发票产品类型（基础能力、正向开票、反向开票）这一必选业务参数。响应内容为发票产品列表，涵盖产品ID、名称、类型及描述。此外，文档提供了Java、PHP、C#及HTTP的调用示例，并列出了系统繁忙、参数有误、产品类型不存在等业务错误码及其解决方案，供开发者参考。 - [发票产品开通申请接口](https://opendocs.alipay.com/open/0hh1vx.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.invoice.merchantproduct.apply`，用于商户或第三方代商户申请开通发票产品。接口要求提供企业税号、发票产品编号及外部申请ID作为核心业务参数，支持Java、PHP、C#及HTTP等多种调用方式。响应结果包含申请流水ID、开通状态及办理链接。文档详细规定了公共请求与响应参数，并列出了系统异常、参数错误、税号不匹配、重复申请等业务错误码及其解决方案，为开发者提供了完整的接入指南。 - [发票产品开通通知接口](https://opendocs.alipay.com/open/0hh1vz.md): 该文档定义了支付宝发票产品开通通知接口（alipay.commerce.ec.invoice.merchantproduct.notify）的规范，用于通知商户发票产品开通流程的状态变更。文档详细列出了包括通知ID、时间戳、签名等在内的公共请求参数，以及产品开通流水ID、外部申请ID、状态枚举值等消息属性。消息状态涵盖了从待审核到开通成功或失败的全过程。文档确立了通知应答机制，商户需返回“success”或“fail”以确认处理结果，并设定了25小时内8次递增间隔的投递重试策略，以确保消息送达。 - [发票产品开通查询接口](https://opendocs.alipay.com/open/0hh1w0.md): 本文档案详细定义了支付宝接口`alipay.commerce.ec.invoice.merchantproductopen.query`，用于查询发票产品的开通状态，支持第三方代理调用。接口请求需包含企业税号及申请流水ID（支持内部ID与外部ID二选一）。文档提供了Java、PHP、C#及HTTP的请求示例，并详细说明了公共与业务请求参数。响应结果包含开通状态（如待审核、开通成功等七种枚举值）及开通页面链接。此外，文档还列举了系统繁忙、参数有误、税号不一致、流水不存在等多种业务错误码及其对应的解决方案，为开发者集成提供了完整的技术参考。 - [常见问题](https://opendocs.alipay.com/open/0h6pzx.md): 文档主要明确了商家开通发票产品的资格要求及税局授权校验规则。在账户要求方面，商家必须使用支付宝企业认证账户，暂不支持法人账户。在校验规则方面，提交税局授权时需满足两项条件：一是认证信息证件号必须为统一社会信用代码（通常以9开头）；二是认证名称需与税务登记名称完全一致，包括括号等标点符号。以上规定旨在确保商家资质合规及税务信息准确匹配。 - [更新日志](https://opendocs.alipay.com/open/0h6pzy.md): 文档记录了支付宝发票相关接口与功能的更新。2026年3月24日，更新了发票产品开通查询及通知接口，在flow_status字段中新增AUTH_FAIL（授权失败）枚举值，完善了授权状态的异常反馈。2025年7月14日，新增“开通乐企开票全面开放”功能，支持服务商及集团企业通过接口发起授权流程，一站式完成税局乐企联用资质申请及开票配置。 ###### 正向开票 - [产品介绍](https://opendocs.alipay.com/open/0hkkqe.md): 正向开票是基于乐企数字化平台构建的支付开票产品，核心特征是由销售方为购买方开具电子发票。该产品通过支付宝接口直连税务系统，具备高稳定性、安全性与合规性，广泛应用于餐饮、零售、酒店、停车及加油等商家收银开票场景。产品提供“支付即开”和“支付可开”两种模式：前者支持支付成功后自动开票，后者支持消费者后续手动申请开票。该服务免费，支持企业、个人及个体工商户账号接入，接入方需满足地方税务局试点要求及开发配置规范。 - [接入准备](https://opendocs.alipay.com/open/0hkkql.md): 本文档介绍了使用支付宝开放平台服务端SDK接入“正向开票”产品的流程，支持商家自研和服务商代开发两种模式。商家自研流程包括创建应用、配置关键参数（如必填的接口加签方式和应用网关）、上线应用及开通产品。服务商模式需创建第三方应用并获取商家授权令牌调用接口。文档详细说明了SDK的集成步骤，重点阐述了公钥模式与公钥证书模式下的AlipayClient初始化方法及参数配置，指导开发者完成安全的接口对接。 - [接入指南](https://opendocs.alipay.com/open/0hkkqm.md): 本文档为支付宝“正向开票”产品的接入指引，旨在指导自研商家或服务商通过API接口实现发票开具与管理。文档核心涵盖三大模块：一是开票申请流程，包括创建申请、监听状态通知、查询发票详情及针对特定错误码的48小时内重试机制；二是企业信息管理，支持查询企业配置及开票员信息的维护；三是商品管理，涉及税收分类编码查询及商品的创建、查询、修改与删除操作。接入方需注意该产品不支持沙箱调试且仅限支付宝交易场景。 ###### API 列表 ###### 开票申请 - [支付开票开票申请创建接口](https://opendocs.alipay.com/open/0hplph.md): 该文档定义了支付宝接口`alipay.commerce.ec.industryinvoice.invoiceapply.create`，用于企业或第三方代理创建支付开票申请。接口支持开具蓝票和红票（需关联原蓝票），涵盖增值税专用发票和普通发票。核心请求参数包括外部申请ID、交易信息、发票类型、企业税号、购买方信息及商品明细列表，并针对不动产租赁和旅客运输场景提供了专属字段配置。响应成功时返回开票申请ID。文档提供了Java、PHP、C#及HTTP请求示例，并列举了参数校验、余额不足、发票状态异常等业务错误码及其解决方案，指导开发者完成接口对接。 - [支付开票开票申请重试接口](https://opendocs.alipay.com/open/0hkmrz.md): 本文档详细介绍了支付宝接口 `alipay.commerce.ec.industryinvoice.invoiceapply.retry`，用于支付开票申请的异常重试。该接口支持第三方代理调用，核心功能是在开票申请失败时发起重试。请求主要包含公共参数（如app_id、method、签名等）和业务参数（开票申请ID、发票产品ID、企业税号）。文档提供了Java、PHP、C#及HTTP的请求示例，展示了SDK初始化、参数设置及调用流程。响应结果区分正常与异常情况，并列出了详细的业务错误码（如系统繁忙、参数有误、余额不足、重试次数超限等）及其解决方案，帮助开发者快速定位并处理接口调用中的各类问题。 - [支付开票开票申请查询接口](https://opendocs.alipay.com/open/0hkmry.md): 本文档介绍了支付宝接口`alipay.commerce.ec.industryinvoice.invoiceapply.query`，用于企业商户查询开票申请详情。该接口支持第三方代理调用，请求时需提供企业税号、产品ID，并二选一传入开票申请ID或外部申请ID。响应内容涵盖发票状态、买卖双方信息、发票金额、商品明细列表及不动产信息等完整数据。文档提供了Java、PHP、C#及HTTP的请求示例，并详细列出了系统错误、参数错误、申请不存在等业务错误码及其解决方案，便于开发者快速集成与故障排查。 - [支付开票开票申请状态变更通知接口](https://opendocs.alipay.com/open/0hkms0.md): 该文档定义了支付宝接口`alipay.commerce.ec.industryinvoice.invoiceapply.notify`，用于通知支付开票申请状态的变更。文档详细规定了公共请求参数（如通知ID、时间戳、签名等）和消息属性参数（包括企业税号、交易列表、发票状态等）。接口要求商户系统同步响应“success”以确认处理成功，否则若返回“fail”，支付宝将按照特定的递增间隔策略在25小时内进行最多8次重试投递，以确保消息送达。 ###### 企业信息 - [企业信息查询接口](https://opendocs.alipay.com/open/0i5lhq.md): 该文档详细介绍了支付宝接口`alipay.commerce.ec.industryinvoice.company.query`，旨在为已开通正向发票产品的企业提供信息查询服务，并支持第三方代理调用。接口请求需提供企业税号，响应包含企业名称、开票员信息及已开通产品配置等关键数据。文档提供了Java、PHP、C#及HTTP等多种语言的调用示例，详尽说明了公共参数（如app_id、sign_type）与业务参数的配置规范。此外，文档列出了请求响应的数据结构，并针对SYSTEM_ERROR、COMPANY_NOT_EXIST等常见业务错误码给出了具体的解决方案，帮助开发者快速定位并解决参数错误、权限不足或系统异常等问题，确保接口集成的顺利进行。 - [乐企开票员查询接口](https://opendocs.alipay.com/open/0i5lhp.md): 本文档详细介绍了支付宝接口`alipay.commerce.ec.invoice.clerk.query`（乐企开票员查询）的功能与调用规范。该接口专为已开通发票产品的企业设计，支持第三方代理调用，用于查询可用的乐企开票员信息。文档说明了公共请求参数（如app_id、sign等）及必选的业务参数`tax_no`（企业税号），并提供了Java、PHP、C#和HTTP的请求代码示例。响应结果包含开票员列表，具体涵盖姓名、身份标识及确认状态（如已确认、未确认等）。此外，文档还列举了系统繁忙、参数有误、企业不存在等业务错误码及其解决方案，帮助开发者快速排查问题。 - [企业开票员编辑接口](https://opendocs.alipay.com/open/0i5p7e.md): 该文档详细定义了支付宝接口`alipay.commerce.ec.industryinvoice.clerk.modify`（企业开票员编辑）的技术规范。该接口支持第三方代理调用，专为已开通正向发票产品的企业提供编辑开票员信息的功能。文档明确了公共请求参数（如app_id、method、sign等）及业务必选参数（企业税号tax_no、开票员身份标识clerk_no）。此外，文档提供了Java、PHP、C#及HTTP的详细请求示例，展示了SDK初始化、参数构建及调用流程。响应部分区分了正常与异常情况，并列举了SYSTEM_ERROR、INVALID_PARAMETER、PRODUCT_NOT_OPENED等业务错误码及其解决方案，涵盖系统异常、参数校验、企业状态核实等场景，为开发者提供了完整的接入与调试指南。 ###### 商品管理 - [税收分类编码查询接口](https://opendocs.alipay.com/open/0i5lhr.md): 本文档介绍了支付宝接口`alipay.commerce.ec.invoice.taxcategory.batchquery`（税收分类编码批量查询）。该接口支持第三方代理调用，专为已开通正向或反向发票产品的企业提供税收分类编码查询功能。文档强调核心业务规则：仅最末级的税收叶子节点可用于创建商品。接口请求需提供企业税号作为必选参数，响应结果包含税收分类编码列表，详细涵盖了商品编码、父级税编、商品名称、描述、特定要素标签以及参考增值税税率和征收率等信息。文档还提供了Java、PHP、C#及HTTP等多种语言的请求示例，并列举了系统繁忙、参数有误、企业不存在、税号不匹配及产品未开通等常见业务错误码及其相应的解决方案。 - [新增商品接口](https://opendocs.alipay.com/open/0i5kot.md): 本文档介绍了支付宝接口`alipay.commerce.ec.industryinvoice.item.add`，旨在为已开通正向发票产品的企业提供新增商品功能，支持第三方代理调用。接口请求包含公共参数和业务参数，业务参数中企业税号、外部商品ID、税收分类编码、商品名称和税率为必填项。文档详细说明了参数的校验规则，如特定类别需填商品单位、零税率需填优惠政策标识，并提供了Java、PHP、C#及HTTP的请求示例。响应结果返回企业商品ID。此外，文档列举了系统繁忙、参数有误、企业不存在、商品重复、税码无效等业务错误码及其解决方案，协助开发者排查问题。 - [删除商品接口](https://opendocs.alipay.com/open/0i5kou.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.industryinvoice.item.delete`，用于删除企业商品库中的商品。该接口支持第三方代理调用，适用于已开通正向发票产品的企业。核心功能是通过企业商品ID（`company_item_id`）对指定商品进行逻辑删除，删除后商品不可检索或开票，但历史数据不受影响。文档详细列出了公共请求参数及必须的业务参数（企业税号、企业商品ID），并提供了Java、PHP、C#及HTTP的请求示例。此外，还包含响应示例及针对系统繁忙、参数有误、商品不存在、默认商品禁止删除等常见业务错误码的解决方案。 - [修改商品接口](https://opendocs.alipay.com/open/0i5lhs.md): 该文档详细介绍了支付宝接口`alipay.commerce.ec.industryinvoice.item.modify`，旨在为已开通正向发票产品的企业提供商品信息修改功能，并支持第三方代理调用。接口要求配置公共参数及业务参数，其中企业税号、商品ID、名称和税率为必填项，商品单位和优惠政策标识在特定条件下为必填。文档提供了Java、PHP、C#及HTTP等多种语言的请求示例，并列举了系统繁忙、参数错误、商品不存在等业务错误码及其解决方案，指导开发者完成接口对接与调试。 - [分页商品查询接口](https://opendocs.alipay.com/open/0i5kov.md): 本文档详细说明了支付宝接口 `alipay.commerce.ec.industryinvoice.item.batchquery` 的功能与使用方法。该接口支持第三方代理调用，旨在帮助已开通正向开票产品的企业按条件分页查询全部商品信息。文档界定了公共与业务请求参数，其中页码、页大小与企业税号为必填项。响应结果包含商品ID、名称、规格、含税单价、税率及优惠政策标识等详细信息。此外，文档提供了Java、PHP、C#及HTTP等多种语言的代码示例，并汇总了系统异常、参数错误、企业信息不存在等业务错误码及其排查方案，为开发者集成提供了完整指引。 ###### 相关资料 - [开票申请创建接口参数枚举说明](https://opendocs.alipay.com/open/0i32us.md): 本文档详细列举了支付宝“支付开票申请创建接口”中两个关键参数的枚举值信息。文档首先提供了“购买方自然人国籍”参数的代码标识与国家或地区名称的对照表，覆盖全球两百多个国家和地区。其次，文档列举了“购买方自然人证件类型”参数的枚举值，涵盖单位证件、居民身份证、军警证件、港澳台及涉外证件、各类工作居住许可等四十余种证件类型。这些标准化的枚举值为开发者在发票申请接口中准确填写购买方身份信息提供了规范依据。 - [开票申请创建接口金额相关参数计算校验逻辑](https://opendocs.alipay.com/open/0i3ikm.md): 本文主要介绍支付宝支付开票申请创建接口的金额参数计算逻辑，内容涵盖明细行与票面两部分。明细行部分详细说明了含税金额、不含税金额、税额、单价及数量在不同入参场景下的计算公式与进位规则，并规定了各参数的精度限制及误差校验标准。票面部分阐述了价税合计、合计税额与合计不含税金额的累计计算方式，同时明确了票面数据的精度要求及允许的精度差范围，整体遵循传入则校验、不传则计算的原则。 - [常见问题](https://opendocs.alipay.com/open/0hkkqo.md): 文档针对企业开票过程中的两个常见问题进行了明确解答。首先，关于开票额度不足的问题，文档指出额度受税务系统及主管税务机关动态管控，企业需联系主管税务机关申请提额。其次，关于交易渠道支持范围，文档说明正向开票目前仅支持支付宝交易单据，第三方交易渠道暂未开放。这两点信息为企业合规开票提供了具体指引。 - [更新日志](https://opendocs.alipay.com/open/0hkkqp.md): 文档记录了支付宝发票服务的更新情况。2025年7月，“正向开票”功能上线，支持商家通过接口直连税务系统为买家开具电子发票，适用于餐饮、零售等收银场景。2025年10月，新增企业信息及商品管理功能，涵盖企业查询、开票员管理以及商品的税收编码查询与增删改查。2026年5月，开票申请创建接口更新，新增`passenger_transport_list`字段，用于传入旅客运输信息列表，进一步拓展了业务场景。 ###### 反向开票 - [产品介绍](https://opendocs.alipay.com/open/0h6onj.md): 本文档介绍了“反向开票”产品，这是一种由购买方（企业）代替销售方（自然人）开具发票的特殊方式。该产品适用于资源回收、农产品收购及灵活用工等场景，核心支持“支付即开票”功能。企业营业员通过支付宝小程序生成付款码，自然人扫码即可同步完成收款、缴税与开票。产品支持当面与远程两种订单交易模式，并允许企业灵活管控订单审核。准入对象涵盖支付宝企业账号、个人账号及个体工商户，服务免费，但接入方需满足地方税务局试点要求。 - [接入准备](https://opendocs.alipay.com/open/0h6onq.md): 本文档主要介绍了使用支付宝开放平台服务端SDK接入“反向开票”产品的流程，支持商家自研和服务商代开发两种模式。商家自研流程包括创建应用、配置应用（如接口加签、应用网关等必填项）、提交审核上线及开通产品。服务商模式需创建第三方应用，获取商家授权后代为调用接口。文档详细说明了SDK的集成步骤，重点阐述了AlipayClient对象的初始化方法，对比了公钥模式与公钥证书模式下的参数配置及代码示例，指导开发者完成安全高效的系统对接。 - [接入指南](https://opendocs.alipay.com/open/0h6onr.md): 本文档为支付宝“反向开票”产品的接入指引，适用于自研商家或服务商，暂不支持沙箱调试。接入内容涵盖五大模块：企业信息管理（推荐），提供信息查询与配置变更；营业员管理（必须），涉及营业员与开票员的创建、查询及确认，订单创建依赖此模块；供应商管理（远程订单必须），维护供应商库并需双方确认关系；商品管理（可选），构建商品库以简化订单录入；订单交易管理（必须），提供订单全生命周期服务，支持创建、审核、取消、重试及红冲流程，涵盖远程与当面付场景。此外，文档还详细说明了业务转账授权申请与提交流程，支持服务商代企业进行资金操作。 ###### API 列表 ###### 企业信息管理 - [反向企业信息查询接口](https://opendocs.alipay.com/open/0hdmgm.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.company.query`，用于查询商户反向开票产品的企业信息。接口支持第三方代理调用，请求需提供企业税号，可选更新校验信息。响应包含企业名称、已开通产品列表及其配置（计税方式、税率、票种）和校验异常详情。文档提供了Java、PHP、C#及HTTP请求示例，并列举了系统繁忙、参数有误、企业不存在等业务错误码及解决方案，指导开发者完成接口集成与故障排查。 - [反向企业产品配置变更接口](https://opendocs.alipay.com/open/0hdmgn.md): 该接口用于变更商户反向开票产品配置，支持第三方代理调用。主要功能是修改订单审核开关、票种及税率。请求需提供产品编号、企业税号及产品配置对象，后者包含计税方式（简易/一般/特殊）、票种（专票/普票）、税率及订单审核开关等参数。文档详细规定了不同回收产品类型下的税率匹配规则，并提供了Java、PHP、C#及HTTP请求示例。响应包含成功与异常示例，并列出了系统繁忙、参数有误、企业状态异常等业务错误码及其解决方案，帮助开发者排查配置变更失败的原因。 - [反向企业转账账户信息查询接口](https://opendocs.alipay.com/open/0hdmgo.md): 该文档详细介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.companyaccount.query`，用于查询反向企业转账账户信息，支持第三方代理调用。接口请求需提供企业税号和转账账户ID两个必填参数，响应包含账户类型及户名、开户行、卡号、余额等详细信息。文档提供了Java、PHP、C#及HTTP的请求代码示例，解析了公共与业务参数规范，并列出了系统繁忙、参数错误、账户不存在、税号不匹配及产品未开通等常见业务错误码及其解决方案。 ###### 营业员管理 - [企业乐企可用开票员信息查询接口](https://opendocs.alipay.com/open/0hdmgf.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.recyclinginvoice.invoiceclerk.query`，用于查询企业在税务系统中注册的开票员信息列表，支持第三方代理调用。核心请求参数为企业税号（`tax_no`），响应返回开票员列表，包含身份标识、姓名及确认状态（未确认、已确认、已拒绝、已解除）。文档提供了Java、PHP、C#及HTTP的请求示例，详述了公共参数配置与SDK初始化流程，并列举了系统繁忙、参数错误、企业不存在等业务错误码及其解决方案，指导开发者完成接口对接与异常处理。 - [反向企业营业员创建接口](https://opendocs.alipay.com/open/0hdmgu.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.recyclinginvoice.companyclerk.create`，用于反向开票场景下为企业创建营业员（含操作员和开票员）。接口支持第三方代理调用，核心参数包括企业税号、员工姓名、角色及外部ID。特定角色需满足特定条件：操作员必填手机号，开票员必填身份标识。创建成功返回营业员ID及认证链接。文档提供了Java、PHP、C#及HTTP请求示例，并详细列举了参数校验、税务信息不符、员工重复及系统异常等业务错误码的解决方案。 - [反向企业营业员变更接口](https://opendocs.alipay.com/open/0hdmgt.md): 本文档详细介绍了支付宝 `alipay.commerce.ec.recyclinginvoice.companyclerk.modify` 接口，用于反向企业营业员信息变更。该接口支持第三方代理调用，允许商户修改营业员的姓名、手机号及权限配置。核心业务参数包括企业税号、营业员ID及员工权限列表，其中权限更新为全量覆盖模式，且开票人身份标识根据角色类型有特定的必填要求。文档提供了Java、PHP、C#及HTTP的请求示例，并列举了包括参数校验失败、员工不存在、并发冲突及税务局信息同步异常等在内的多种业务错误码及其处理建议，协助开发者完成接口对接与故障排查。 - [反向企业营业员查询接口](https://opendocs.alipay.com/open/0hdmgj.md): 本文档定义了支付宝接口`alipay.commerce.ec.recyclinginvoice.companyclerk.query`，用于查询商户下的企业营业员信息，支持第三方代理调用。接口要求传入企业税号，并在员工手机号、企业营业员ID或外部营业员ID中三选一作为查询条件。响应结果包含营业员ID、姓名、手机号、角色（操作员/开票员）及状态（初始化/在职/离职）。文档提供了Java、PHP、C#及HTTP请求示例，并列出了系统繁忙、参数错误、税号不匹配及产品未开通等常见业务错误码的解决方案，供开发者集成参考。 - [企业营业员变更结果通知接口](https://opendocs.alipay.com/open/0j2r9o.md): 该文档定义了支付宝接口`alipay.commerce.ec.recyclinginvoice.companyclerk.notify`，用于通知企业营业员信息的变更结果。文档详细规定了公共请求参数（如通知ID、签名、时间戳）及消息属性（包括外部营业员ID、企业营业员ID、税号及操作类型）。操作类型涵盖新增、修改和删除三种枚举值。接口要求接收方同步返回“success”或“fail”作为应答。若处理失败，系统将在25小时内按照特定的时间间隔（如2m、10m、1h等）进行最多8次重试投递，以确保消息送达。 - [企业营业员批量查询接口](https://opendocs.alipay.com/open/0j2r9p.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.recyclinginvoice.companyclerk.batchquery`，用于批量查询企业营业员信息，支持第三方代理调用。接口请求需包含分页参数及企业税号（必填），并支持按手机号、ID或角色筛选。响应返回营业员列表详情，包括ID、姓名、角色及状态（初始化、在职、离职）。文档提供了Java、PHP、C#及HTTP的调用示例，并列举了系统繁忙、参数有误、税号不匹配等业务错误码及其解决方案，指导开发者完成接口集成与调试。 - [反向企业营业员删除接口](https://opendocs.alipay.com/open/0hdmgs.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.companyclerk.delete`，用于反向企业营业员删除。该接口支持第三方代理调用，执行后将删除营业员数据及其关联权限与角色。核心请求参数包括企业税号（`tax_no`）和营业员ID（`company_clerk_id`）。文档提供了Java、PHP、C#及HTTP的代码示例，并列举了正常与异常响应格式。常见业务错误包括系统繁忙、参数有误、员工不存在、特定角色（开票员/管理员）禁止删除、税号不匹配及产品未开通等，文档针对各类错误提供了具体解决方案。 ###### 供应商管理 - [资源回收自然人税务查询接口](https://opendocs.alipay.com/open/0ithl2.md): 本文档定义了支付宝接口`alipay.commerce.ec.recyclinginvoice.scrappednaturaltax.query`，用于查询资源回收自然人的税务开票信息，支持第三方代理调用。接口要求传入企业税号和供应商ID作为必选参数。文档详细列出了公共请求参数（如签名、时间戳）和业务响应参数（包含月份及累计开票金额），并提供了Java、PHP、C#及HTTP的代码示例。此外，还列举了系统错误、参数错误、税号不匹配、产品未开通等业务错误码及其解决方案，帮助开发者快速接入与调试。 - [供应商新增接口](https://opendocs.alipay.com/open/0hdmgw.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.companysupplier.create`，用于新增供应商信息，支持第三方代理调用。接口要求传入外部供应商ID、企业税号、姓名、支付宝账号及类型等必选参数。请求需遵循RSA2签名规范，支持Java、PHP等多种开发语言。成功调用后，系统返回唯一的供应商ID以及用于短信和端内通知的供应商关系确认激活链接。文档详细定义了公共与业务参数，并列举了包括系统异常、参数错误、账户信息不符、并发冲突及重复创建在内的多种业务错误码及其解决方案，指导用户快速排查如产品未开通、税号不匹配等常见接入问题。 - [供应商修改接口](https://opendocs.alipay.com/open/0hdmge.md): 该文档介绍了支付宝接口 `alipay.commerce.ec.recyclinginvoice.companysupplier.modify`，用于修改供应商信息，支持第三方代理调用。文档详细定义了公共请求参数和业务参数，其中供应商ID和企业税号为必填项。提供了 Java、PHP、C# 和 HTTP 的代码示例，展示了接口调用流程。同时，文档列出了正常与异常响应示例，并归纳了包括系统错误、参数校验、账户权限、并发控制及供应商状态异常在内的多种业务错误码及其解决方案，帮助开发者正确处理调用过程中的各类异常情况。 - [供应商查询接口](https://opendocs.alipay.com/open/0hdmgx.md): 本文档详细介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.companysupplier.query`，用于查询供应商信息，支持第三方代理调用。接口要求必传企业税号及分页参数，可选传供应商ID或电话进行筛选。响应数据包含供应商列表详情，如姓名、账号、状态（待确认、已确认、已拒绝）等。文档提供了Java、PHP、C#及HTTP的请求代码示例，规定了公共参数与业务参数规范，并列举了系统繁忙、参数有误、税号不匹配及产品未开通等常见业务错误码及其解决方案。 - [供应商删除接口](https://opendocs.alipay.com/open/0hdmgg.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.recyclinginvoice.companysupplier.delete`，该接口用于删除供应商信息，并支持第三方代理调用。接口请求需包含公共参数和业务参数，其中业务参数必须提供供应商ID (`supplier_id`) 和企业税号 (`tax_no`)。文档提供了Java、PHP、C#及HTTP四种语言的请求示例，展示了初始化SDK、设置参数及处理响应的流程。响应结果通过 `code` 字段判断，成功为“10000”。此外，文档列举了 `SYSTEM_ERROR`、`INVALID_PARAMETER`、`COMPANY_NOT_LEGAL` 等业务错误码，并给出了包括检查参数合法性、确认税号匹配及开通反向开票产品等相应的解决方案。 - [供应商变更结果通知接口](https://opendocs.alipay.com/open/0hdmh1.md): 本文档定义了支付宝接口`alipay.commerce.ec.recyclinginvoice.companysupplier.notify`，即供应商变更结果通知接口。该接口用于在企业新增供应商后，通知企业供应商信息的变更结果。文档详细规定了公共请求参数（如通知ID、签名、时间戳等）和消息属性（包含外部供应商ID、供应商ID、税号及确认状态）。确认状态包含待确认、已确认、已拒绝三种枚举值。文档还明确了通知应答机制：返回“success”则停止投递，返回“fail”则触发重试。重试策略为25小时内投递8次，间隔时间从2分钟至15小时逐次递增，确保消息触达。 ###### 订单交易管理 - [反向订单创建接口](https://opendocs.alipay.com/open/0hdmh0.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.order.create`，用于企业创建反向订单以便后续交易及开具反向发票，支持第三方代理调用。接口请求需包含企业税号、发票产品ID、营业员ID、外部订单号及商品明细等核心参数，其中商品明细涉及单价、数量和税收分类编码，个人所得税类型在特定场景下必传。响应结果包含系统订单号、支付即开票页面URL及二维码链接等。文档提供了Java、PHP、C#及HTTP的请求示例，并详细列出了账户余额不足、参数有误、企业/营业员状态异常、乐企授权无效、并发冲突及风控拦截等业务错误码及其解决方案，协助开发者进行接口对接与故障排查。 - [反向订单查询接口](https://opendocs.alipay.com/open/0hdmgr.md): 本文档详细介绍了支付宝反向订单查询接口`alipay.commerce.ec.recyclinginvoice.order.query`的功能与规范。该接口支持第三方代调用，主要用于查询反向订单详情并同步最新单据信息。请求参数包括企业税号、发票产品ID以及订单号或外部订单号（二选一）。响应内容涵盖订单基础信息、交易状态、发票详情（含蓝红字发票类型及明细）、税费明细、商品信息、支付状态及业务转账信息等。文档提供了Java、PHP等语言的调用示例，并明确了系统错误、参数校验、订单不存在等常见业务错误码的处理建议，帮助开发者快速集成与调试。 - [反向订单操作_审核接口](https://opendocs.alipay.com/open/0hdmgc.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.order.audit`，用于企业审核营业员创建的反向订单，支持第三方代理调用。接口要求传入企业税号、发票产品ID、订单号及商品明细等核心参数，其中商品单价、数量和金额需三选二传值。文档提供了Java、PHP、C#及HTTP的请求示例，详细说明了公共参数与业务参数的规范。此外，还列举了正常的响应结构及多种业务错误码（如系统繁忙、余额不足、订单状态错误等），并给出了相应的解决方案，指导开发者正确处理审核流程中的各类异常情况。 - [反向订单操作_取消接口](https://opendocs.alipay.com/open/0hdmgp.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.order.cancel`，用于企业或商户取消反向订单，支持第三方代理调用。文档详细定义了公共请求参数（如app_id、method、sign等）及三个必选业务参数：企业税号（tax_no）、发票产品ID（product_id）和订单号（order_id）。文中提供了Java、PHP、C#及HTTP的请求示例，展示了SDK初始化与调用流程。此外，文档还列出了正常与异常响应示例，并详细说明了系统错误、参数错误、并发冲突、订单状态异常及产品权限问题等多种业务错误码及其解决方案，帮助开发者进行调试与故障排查。 - [反向订单操作_重试接口](https://opendocs.alipay.com/open/0hdmgz.md): 该文档详细介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.order.retry`，用于反向订单操作的重试。主要应用场景是企业在开票失败或转账失败时，对反向订单重新发起尝试。该接口支持第三方代理调用。请求参数分为公共参数和业务参数，业务参数必填项包括企业税号（tax_no）、发票产品ID（product_id）和订单号（order_id）。文档提供了Java、PHP、C#及HTTP的请求代码示例。响应结果分为成功和异常两种。此外，文档详细列出了多种业务错误码及其解决方案，涵盖系统繁忙、参数错误、企业乐企授权状态异常、授信额度不足、订单状态异常及开票资格限制等情况，指导开发者进行排查和处理。 - [反向订单申请红字发票接口](https://opendocs.alipay.com/open/0hdmgy.md): 本文档定义了支付宝接口 `alipay.commerce.ec.recyclinginvoice.orderredinvoice.apply`，用于反向订单申请红字发票。该接口支持第三方代理调用，适用于订单交易成功后发现蓝字发票有误需红冲的场景。核心业务参数包括企业税号、发票产品ID和订单号。文档提供了Java、PHP、C#及HTTP的请求示例，展示了SDK初始化、参数封装及调用流程。响应结果通过代码“10000”标识成功。此外，文档列举了丰富的业务错误码，涵盖系统异常、参数错误、企业乐企授权状态异常、订单状态不符及产品未开通等情况，并提供了相应的解决方案，如检查税号、确认订单状态或刷新企业授权信息。 - [反向订单变更事件消息通知接口](https://opendocs.alipay.com/open/0hdmh4.md): 该文档定义了支付宝接口`alipay.commerce.ec.recyclinginvoice.order.notify`，用于同步反向订单状态变更信息。文档详细列出了公共请求参数（如通知ID、时间戳、签名等）及消息属性（包括订单号、订单状态、蓝字/红字发票状态、支付状态等枚举值）。接口通过HTTP POST通知商户，商户需同步响应“success”或“fail”。若处理失败，系统将在25小时内按特定时间间隔（如2m、10m、1h等）重试最多8次，以确保消息送达。 - [反向开票业务转账提交接口](https://opendocs.alipay.com/open/0jo3sj.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.biztransfer.submit`，用于反向开票业务转账提交。该接口支持第三方代理调用，适用于服务费和物流费等关联业务的转账场景（需提前完成企业授权）。文档详细规定了公共请求参数与业务请求参数，包括企业税号、转账账户ID、订单ID、业务类型（抽佣或物流费）、金额及收款人信息等必填项，并提供了Java、PHP、C#及HTTP的代码示例。响应结果包含转账单据ID、状态及失败原因等。此外，文档列举了系统错误、参数错误、余额不足及多种业务失败（如授权无效、订单异常、限额超限等）的错误码与解决方案，指导开发者正确集成与调试。 - [反向开票订单业务转账授权结果通知接口](https://opendocs.alipay.com/open/0jo3sk.md): 本文档定义了支付宝反向开票订单业务转账授权结果通知接口。该接口用于在反向开票场景下，向商户同步转账授权的处理结果。文档详细列出了请求参数，包括通知ID、时间戳、签名信息及业务报文等。核心消息属性涵盖授权流水ID、授权状态及结果，状态分为成功或取消。文档提供了HTTP请求示例，并规定了通知应答机制：商户需返回“success”确认处理成功，否则返回“fail”触发重试。重试策略为25小时内最多投递8次，间隔随次数递增。 - [反向开票订单业务转账授权申请接口](https://opendocs.alipay.com/open/0jo3sl.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.recyclinginvoice.biztransferauth.apply`，用于反向开票订单业务转账授权申请。该接口支持第三方代理调用，服务商通过提交企业税号和企业转账账户ID申请授权，由企业确认。调用成功后返回授权流水ID、授权链接及授权状态。文档提供了Java、PHP、C#及HTTP请求示例，并定义了系统异常、参数错误、产品未开通及账户信息不匹配等业务错误码的解决方案，指导开发者完成接口集成与故障排查。 ###### 商品管理 - [税收分类编码分页查询接口](https://opendocs.alipay.com/open/0hdmgq.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.taxcategory.batchquery`，用于税收分类编码的分页查询，支持第三方代理调用。接口请求需提供企业税号（tax_no）和产品ID（product_id）两个必选参数。响应结果包含税收分类编码列表，详细列出编码、父级编码、商品名称、类目名称及描述等信息。文档提供了Java、PHP、C#及HTTP的请求示例，并定义了系统异常、参数无效、企业不存在、产品未开通等业务错误码及其相应的解决方案，指导开发者完成接口集成与调试。 - [商品库新增商品信息接口](https://opendocs.alipay.com/open/0hdmh3.md): 本文档介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.item.create`，用于在商品库中新增商品信息，支持第三方代理调用。接口要求必填外部商品ID、企业税号、税收分类编码、产品ID、商品名称及单位等参数。文档详细规定了公共与业务请求参数的格式与限制，提供了Java、PHP、C#及HTTP的代码示例。接口响应包含平台生成的商品ID，文档还列举了系统繁忙、参数有误、商品重复、企业或产品不存在、税号不匹配及税收编码异常等多种业务错误码及解决方案，指导开发者正确集成与调试。 - [商品库修改商品信息接口](https://opendocs.alipay.com/open/0hdmgv.md): 本文档详细介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.item.modify`，该接口主要用于商品库中已存在商品信息的修改，支持第三方开发者代用户发起调用。接口允许修改的具体内容包括商品名称、商品单位以及规格型号，其中规格型号支持修改为空。调用时需传入企业税号、产品ID、商品ID等必选参数。文档提供了Java、PHP、C#及HTTP等多种语言的请求示例，展示了从SDK初始化到参数设置及发起请求的完整流程。在响应处理方面，接口返回成功标识或详细的错误信息，文档列举了包括系统繁忙、参数有误、企业或商品不存在、并发冲突及权限不足在内的多种业务错误码，并提供了相应的解决方案，帮助开发者进行有效的故障排查与处理。 - [商品库删除商品信息接口](https://opendocs.alipay.com/open/0hdmh2.md): 本文档介绍了支付宝接口 `alipay.commerce.ec.recyclinginvoice.item.delete`，用于在商品库中删除商品信息，并支持第三方代理调用。接口要求提供公共参数（如 app_id、签名、时间戳等）及业务参数（商品ID `company_item_id` 和企业税号 `tax_no`）。文档提供了 Java、PHP、C# 和 HTTP 的请求示例，详细展示了 SDK 初始化、参数设置及调用流程。响应结果包含正常返回与异常错误码，常见的业务错误包括系统繁忙、参数有误、企业或商品不存在、操作权限不足、税号不匹配及产品未开通等，文档针对各错误提供了相应的解决方案。 - [商品库分页商品信息接口](https://opendocs.alipay.com/open/0hdmgk.md): 该文档详细介绍了支付宝接口`alipay.commerce.ec.recyclinginvoice.item.batchquery`，用于分页查询商品库中的商品信息，并支持第三方代理调用。接口请求需包含应用ID、签名等公共参数，以及页码、页大小、企业税号等必选业务参数，支持按商品ID、名称等可选条件筛选。文档提供了Java、PHP、C#及HTTP的请求示例，展示完整的调用流程。响应结果包含分页统计信息及商品详情列表（如名称、规格、税收编码等）。此外，文档还列举了系统繁忙、参数错误、企业不存在等常见业务错误码及其解决方案，辅助开发者排查问题。 - [常见问题](https://opendocs.alipay.com/open/0h6ont.md): 本文档明确指出了企业开通“反向开票”产品的两项关键要求。首先，硬性条件规定企业的支付宝账户必须具备“支付宝企业认证”资质，这是开通功能的基础门槛。其次，为了保障业务顺利进行，文档强烈建议企业完成“交易打款认证”。文档强调了这一建议的重要性，指出完成该认证可以有效规避后续交易过程中可能出现的交易限额及风控问题，确保企业相关业务能够平稳、高效地开展。 - [更新日志](https://opendocs.alipay.com/open/0h6onu.md): 本文档记录了2025年至2026年期间系统在企业管理与税务服务方面的功能更新。主要内容涵盖：2026年4月新增企业营业员批量查询及变更通知接口，提升了企业人员管理效率与数据同步时效；2026年2月上线的报废产品收购场景下自然人开票额度查询接口，支持查询近12个月数据；以及2025年7月全面开放的反向开票功能，确立了由企业代替个人开具发票的业务模式。这些更新优化了企业服务能力，完善了税务合规支持。 ### 开发服务 #### 云监控 - [云监控产品概述](https://opendocs.alipay.com/open/00a0ha.md): 云监控是蚂蚁集团面向合作伙伴推出的免费自助监控产品，侧重行业业务监控。当业务出现异常时，它能第一时间通过短信或邮件通知相关人员，助力企业及时发现并处理问题，保障业务稳定性。目前支持监控的业务范围包括当面付、移动支付、间连ISV及小程序等。用户既可通过支付宝App搜索小程序进行移动端监控，也可登录开放平台在PC端查看。该平台还可用于分析业务趋势与质量。使用时需注意授权管理，确保数据安全。作为免费辅助工具，其对影响较小的异常可能无法感知，用户可通过邮件反馈改进建议。 ##### 用户指南 - [监控大盘-当面付](https://opendocs.alipay.com/open/00a0hc.md): 本文档介绍了当面付稳定性大盘的功能与使用方法。该大盘用于监控交易趋势、质量及异动，需在开放平台的云监控中心查看。大盘包含三大核心监控维度：交易数据（涵盖支付成功率、失败数等指标）、终端收银（监控机具心跳、失败率及耗时）及错误分布（统计失败错误码）。在数据分析方面，飘红数据需重点关注，用户可通过点击指标查看趋势，并利用区间查看和对比查看功能，快速定位数据异动时间点以解决问题。 - [监控大盘-我的商家](https://opendocs.alipay.com/open/00a0he.md): 本文档介绍了支付宝开放平台“我的商家”稳定性大盘的功能与使用方法。该大盘旨在帮助服务商监控下属商家的交易趋势、质量表现及数据异动。用户需具备服务商身份并绑定“当面付”产品，方可通过控制台的云监控中心访问该模块。大盘核心指标涵盖请求笔数、支付笔数、订单成功率、平均支付耗时及终端支付失败量，通过这些关键数据，服务商能够快速查询并掌握下属商家的具体交易情况，从而及时观察和处理业务影响。 - [监控大盘-APP支付](https://opendocs.alipay.com/open/00a0hd.md): 本文档介绍了支付宝开放平台的“APP支付稳定性大盘”功能，旨在监控快捷支付的交易趋势、质量和异动。企业需绑定APP支付产品后，方可通过控制台的云监控中心访问该大盘。大盘核心监控内容涵盖两方面：一是交易数据，详细统计支付请求、成功数、成功率、金额及分平台交易笔数等指标；二是错误分布，统计交易失败错误码以辅助快速定位和解决异常问题。 ##### 前端监控 - [前端监控概述](https://opendocs.alipay.com/open/00a0hr.md): 该文档详细介绍了前端监控服务的核心功能与应用范围。该服务广泛支持支付宝小程序、微信小程序、H5页面及Android等多种应用类型。文档重点介绍了系统的六大功能模块：一是页面资源与接口监控，提供整体数据大盘及细粒度的业务接口状态判断；二是报警管理，支持通用报警与针对关键业务的定制化报警规则；三是JS Error监控，实现错误全量采集、实时报警及多维度分析；四是自定义统计，包含求和与均值统计以监控轻量级业务交互；五是日志归档，用于实时记录与问题定位；六是页面入口来源分析，解析用户来源渠道及留存情况。这些功能共同构建了完整的前端监控与数据分析体系。 - [接入设置](https://opendocs.alipay.com/open/00a0ht.md): 文档主要介绍了云监控前端监控应用创建与初始化的全流程。首先指导用户在开放平台控制台新建应用，定义类型与名称。初始化部分重点针对小程序，详述了SDK下载、引入路径、针对httpRequest的代码修改、业务字段设置及服务器域名白名单配置等关键步骤。对于Web应用提供了配置指引，而对于Android和iOS App，因暂无专用SDK，需采用手动埋点方式按协议上报数据。文末提供了进阶用法的参考路径。 - [支付宝小程序高级用法](https://opendocs.alipay.com/open/00a0hu.md): 支付宝为小程序开发者推出实时日志功能，旨在快捷排查漏洞与定位问题。开发者可使用 monitor.logInfo() 函数打印日志，日志实时上报至云监控，并可在前端监控的应用详情页查看。该功能包含基础用法与进阶用法：基础用法类似 console.log()；进阶用法支持特殊场景的手动上报，包括页面数据（需关闭自动上报）、API 监控数据（涉及接口名称、状态、耗时等参数）及自定义监控数据（仅支持 JSON 格式，需配置 token）。此外，文档还介绍了通过配置 ignoreUrls 正则表达式来过滤 H5 页面或其他特定 URL 埋点的方法。 - [Web高级用法](https://opendocs.alipay.com/open/00a0hv.md): 本文档介绍了在无法进行静默采集的特殊场景下，采用手动上报数据的解决方案。主要包含三种上报类型：首先是手动上报页面数据，需设置 `autoReportPage` 为 false，并调用 `__bl._lg` 方法；其次是手动上报API监控数据，需关闭自动上报开关，使用 `__bl.api` 方法，该方法支持传入API名称、成功状态、执行时间、状态码及描述五个参数；最后是手动上报自定义监控数据，通过 `__bl.custom` 方法实现，需注意避开timestamp、uid等系统保留关键字，以免与日志自带的公共属性冲突。这些方法为特定业务场景下的监控数据采集提供了灵活的接口支持。 - [小程序SDK](https://opendocs.alipay.com/open/00a0hx.md): 该文档记录了小程序监控 SDK 从 v1.0.1 到 v1.2.2 的版本迭代日志。核心更新内容涵盖功能新增、性能优化及问题修复。主要新增功能包括 JS 错误监控、用户行为与来源分析、自定义日志上报及过滤机制。SDK 重构了初始化脚本，优化了弱网环境下的上报策略，并将 UID 生成改为同步模式以修复时序问题。此外，还通过并发控制与路径过滤降低了资源占用并提升了统计准确性。该 SDK 同时支持支付宝与微信小程序，旨在提供完整的前端监控与埋点分析能力。 - [Android应用接入](https://opendocs.alipay.com/open/00a0hy.md): 本文档主要介绍在Android Studio项目中接入监控SDK的操作流程。首先需在Gradle中配置阿里云Maven仓库，引入OkHttp及阿里云HA SDK依赖，并下载SendService工具类。随后通过初始化实例设置监控Token。核心功能包含三部分：一是上报页面流量以统计PV、UV；二是上报API接口状态以监控成功率、TPS及响应时长；三是支持进阶的自定义数据上报。文档为各环节提供了详尽的代码配置示例，便于开发者快速集成监控能力。 - [常见问题](https://opendocs.alipay.com/open/00hnc2.md): 本文档主要解答前端监控使用中的两个常见问题。首先，针对埋点配置后看不到数据的情况，文档指出数据存在约2分钟的延迟，并建议通过小程序IDE调试窗口查看`put.htm`请求来排查日志上报情况，其中参数“t”用于区分页面数据、接口日志及统计事件等类型。其次，文档说明了小程序云监控与前端监控的区别，指出云监控侧重于通过HTTP状态码和JS error监控应用整体运行情况，功能类似于前端监控中的通用监控与报警管理模块。 - [应用监控](https://opendocs.alipay.com/open/00a0ic.md): 该文档介绍了应用监控服务的接入流程及日志上报规范，旨在提供服务端接口和应用错误日志的实时监控与告警。接入流程包括在支付宝开放平台控制台创建应用、完成接入设置及上报日志。日志上报支持接口调用日志和Error日志两种类型。其中，接口调用日志需遵循包含时间、应用名、RpcId等14个字段的固定格式，通过SDK或Logstash上报，文档详细规定了各字段的必填项、类型说明及分隔符要求。Error日志则可直接通过Java SDK或Logstash上报。 ##### 我的告警 - [报警历史](https://opendocs.alipay.com/open/00a0hg.md): 该文档旨在指导开发者利用报警历史监控业务健康状态。用户可通过支付宝开放平台的云监控控制台进入“我的告警”页面查询。页面字段涵盖发生时间、规则名称、报警内容及合并后的告警次数等。系统支持两种关键操作：一是“查看详情”，可展示报警点前后15分钟数据以辅助分析；二是“处理”功能，允许开发者设置临时暂停报警（如1小时或自定义）或向系统反馈异常，从而优化报警准确性并减少干扰。 - [报警规则](https://opendocs.alipay.com/open/01qp4s.md): 本文档介绍了支付宝开放平台的自定义报警规则功能，旨在帮助开发者监控小程序。摘要涵盖了报警规则的创建与管理流程：用户需进入云监控监控中心，在“我的告警”下选择创建规则，类型包括前端监控、应用监控及自定义监控。创建步骤包括选择类型、填写信息及确认。创建完成后，用户可对规则进行编辑、删除、启用/停止监控以及手动触发报警设置，实现对小程序运行状态的有效监控与管理。 - [产品报警订阅管理](https://opendocs.alipay.com/open/00a0hh.md): 该文档主要介绍了云监控服务的报警规则管理功能。云监控为各类产品提供默认报警规则，开发者可直接订阅以获取业务异常通知，同时也支持自定义监控。在进行报警订阅前，必须先创建联系人。用户可在监控中心查看规则详情，并进行订阅管理，设置包括短信、邮件及钉钉机器人在内的多种通知方式、通知对象及时间段。高级配置支持设置通道沉默时间和报警回调，便于集成自有运维体系。此外，文档还说明了如何取消订阅以及如何查询报警历史记录，帮助开发者有效监控业务状态。 - [报警回调](https://opendocs.alipay.com/open/00a0hj.md): 该文档介绍了云监控的报警回调功能，旨在帮助开发者通过HTTP协议将报警通知集成至自有运维或消息体系。文档概述了功能的实现机制，即云监控通过POST请求将报警推送到指定公网URL，并说明了重试策略为重试3次、超时5秒。同时，详细阐述了创建回调的配置路径，需在支付宝开放平台的云监控控制台进行设置。文档重点解析了POST请求的参数结构，包括商家PID、产品名称、报警规则、指标名称、时间戳、报警对象、告警内容及当前值等关键信息，并提供了具体的JSON请求示例供开发者参考。 ##### 自定义监控 - [接入指引](https://opendocs.alipay.com/open/00a0i0.md): 文档主要介绍了云监控自定义监控的配置流程与数据上报方式。在创建监控项时，系统支持HTTP、API和AGENT三种数据源，用户需按顺序完成创建监控项、日志切分与指标维度配置、以及指标数据计算配置。在数据上报阶段，小程序埋点场景需采用特定自定义上报模式，服务端场景则依据所选方式，通过HTTP、API或AGENT模式将数据上报至云监控平台。 ###### 监控项管理 - [创建一个监控项](https://opendocs.alipay.com/open/00a0i2.md): 本文档介绍了云监控自定义监控的功能及创建流程，旨在帮助开发者通过清洗日志和统计指标满足定制化业务需求。创建监控项支持“新建标准模板监控”和“新建自定义监控”两种方式。标准模板监控适用于接口或错误日志，可自动生成大盘和告警；自定义监控则提供灵活的配置流程，包括命名、上报方式选择、日志切分及指标配置。文档还详述了监控项的编辑、删除及测试数据发送等管理操作，并补充了小程序端和服务器端（SDK、API、Agent等）的数据上报接入方式。 - [日志切分](https://opendocs.alipay.com/open/00a0i8.md): 该文档主要介绍了系统支持的指标数据与普通日志两种数据格式的配置方法。在文本日志切分配置中，用户可通过输入样本日志进行自动切分，并修改列属性，文档详细说明了用于判断字符串包含关系的`contains`函数和用于设置纬度列常量值的`default`函数的用法。在指标数据配置方面，用户需添加自定义指标和维度，系统将自动生成HTTP上报URL，用户根据该URL完成监控数据上报工作。 - [指标数据计算配置](https://opendocs.alipay.com/open/00a0i9.md): 文档主要介绍了“指标数据计算配置”的功能定义及接入参数。该功能旨在对日志切分后的最小单元指标和维度按业务需求重新聚合，生成新的业务指标，用于大盘展示和告警。接入配置包含五个核心参数：名称，用于自定义标识；指标，支持COUNT、SUM等运算，类似SQL的select条件；筛选，用于数据过滤，类似SQL的where条件；时间字段，指定计算时间；以及维度，用于分组聚合，类似SQL的group by条件。 ###### 数据上报方式 ###### 服务端上报方式 - [数据源配置-HTTP上报模式](https://opendocs.alipay.com/open/03kq18.md): 本文档介绍了HTTP上报模式，适用于非Java应用或不依赖SDK的场景。请求采用POST方法，需对Body参数进行URL编码，核心参数包括监控项token和上报内容biz_content。系统支持两种日志格式：指标数据需将biz_content设为包含指标名、维度、时间戳及值的JSON数组；文本日志则直接将日志内容作为biz_content值。响应结果以JSON格式返回，包含状态信息。 - [数据源配置-Agent上报](https://opendocs.alipay.com/open/03kq16.md): 本文档介绍了利用开源组件Filebeat和Logstash采集服务端日志与指标数据上报至云监控的接入方案。接入前需在云监控新增自定义监控项，否则数据将不被处理。文档推荐采用Filebeat+Logstash+云监控的部署架构，以便于在Logstash端统一管控和过滤数据，同时也介绍了Logstash直连云监控的备选方案。具体实施细节涵盖了Filebeat和Logstash的安装步骤、配置文件修改指南（包括日志路径、Token配置、输出设置等）以及前后台启动命令。此外，文档特别强调了Logstash运行需依赖JDK 1.8环境，并提供了相应的环境变量配置方法，最后针对启动时常见的Java版本报错问题给出了解决方案。 - [Log4j、Log4j2或logback上报配置](https://opendocs.alipay.com/open/03kq17.md): 本文档介绍了适用于Java应用系统的云监控SDK安装与配置方法。首先阐述了下载SDK并通过Maven部署至私有仓库或在项目中添加依赖的步骤。核心内容是日志数据上报的多种方式：推荐通过配置Log4j2的``标签实现，同时也支持修改Log4j和Logback的Appender类配置，以上方式均需设置监控项token。此外，文档还介绍了使用Client代码上报指标数据（需配置namespace和维度）及文本日志的方法，并说明了如何通过设置type属性为"error"来实现系统错误日志的监控。 ###### 小程序埋点上报方式 - [自定义埋点上报](https://opendocs.alipay.com/open/03kq1g.md): 该文档介绍了手动上报自定义监控数据的操作流程，主要用于业务或特殊场景监控，且仅支持JSON格式数据。执行前需确保已开通自定义监控权限。核心步骤包括：首先在初始化脚本`monitor.init({})`中配置`token`属性，建立日志命名与监控项token的映射；其次调用`monitor.report`接口，传入日志命名及自定义数据对象完成上报。 ###### 数据开放说明文档 - [原始日志开放](https://opendocs.alipay.com/open/00yr1l.md): 本文档定义了支付宝云监控前端日志拉取API的接口规范。接口地址为指定URL，采用POST方法请求，要求请求头包含站点ID（x-log-pid）并使用multipart/form-data格式。核心URL参数包括必填的日志类型和拉取数量，以及用于分页的可选游标。响应通过头部返回下一页游标和当前数据量。文档还详细列出了202、400、404及500等HTTP错误码及其对应的排查解决方案，并提供了示例辅助理解。 - [指标开放](https://opendocs.alipay.com/open/00yr1m.md): 该文档详细定义了支付宝开放监控平台图表数据查询接口的技术规范。接口请求地址为 `https://openmonitor.alipay.com/cloudmonitor/api/v2/charData.json`，采用 POST 方法，请求头需设置为 `multipart/form-data`。请求必须包含 `pid` 和 `queryParams` 两个参数，其中 `queryParams` 为 JSON 格式，涵盖查询数组、图表类型及时间范围等配置。接口支持折线图、饼图、表格、柱状图等多种图表类型，并明确规定查询的时间跨度（startTime 至 endTime）不得超过 1 天。当图表类型为 TABLE 时，还需通过 `groupBy` 参数指定维度。 - [授权管理](https://opendocs.alipay.com/open/00a0hk.md): 文档主要介绍了授权管理功能的现状及替代方案。该功能原用于支持签约主账号将监控权限授权给技术人员以协助数据分析，目前即将下线。文档提示用户，如需进行授权，应前往开放平台账户中心的“员工子账号管理”模块，通过添加开发者管理员来实现，具体详情可参阅员工管理相关文档。 - [集成健康度](https://opendocs.alipay.com/open/02x4f7.md): 支付宝“集成健康度”是一款面向已上线商家的产品稳定性检测工具。该产品适用于全行业，通过分析商家真实流水数据，精准定位产品运行中的逻辑异常和错误，并提供相应解决方案以完善接入规范。产品特色包括：根据严重程度生成检测规则，建议优先处理“高危”问题；明确展示异常笔数、占比及影响面；提供样例订单与改进建议辅助快速修复；采用T+1数据分析模式。商家在产品上线后即可使用，通过开放平台控制台的“云监控”入口查看检测结果并按建议优化逻辑，从而提升用户体验。 ##### 云监控移动端 - [云监控移动端](https://opendocs.alipay.com/open/00a0hl.md): 支付宝提供移动端云监控服务，旨在帮助用户快捷监控应用概况。用户可通过扫描二维码或在支付宝移动端搜索“云监控”进入。产品核心功能涵盖四大板块：数据板块支持查看JS错误、服务端资源请求异常、HTTPS证书过期预警及各类HTTP请求监控，其中证书过期需提前5个工作日处理；消息板块展示小程序通知；工具板块提供错误码排查助手；我的板块支持账户与员工管理、钉钉推送配置及反馈建议，全方位满足移动运维需求。 - [错误码排查助手](https://opendocs.alipay.com/open/00cflf.md): 错误码排查助手旨在解决开放平台错误码文档不完整、解决方案简单的问题，以提升研发及运维效能。该工具集成于支付宝云监控小程序，提供常用错误码查看、错误码检索及详情查看功能，涵盖小程序错误与支付类错误。其核心特点包括：默认展示基于日志采集的高频错误码；支持模糊搜索；详情页提供错误描述、接口信息及解决方案；结合云监控实现告警与方案一体化；支持用户反馈以优化方案质量。用户可通过支付宝云监控小程序的工具Tab、告警详情页或伙伴通小程序首页进入，快速定位并解决问题。 - [开放平台管理员授权](https://opendocs.alipay.com/open/00ceex.md): 该文档介绍了企业账号如何添加子账号以便内部员工使用云监控服务。默认情况下仅企业账号可查看数据，员工需被添加为“开发者管理员”角色方可使用。添加方式分为PC端和移动端，PC端操作需参考相关文档。移动端操作需登录特定小程序，进入员工管理页面，支持两种添加方式：一是员工扫码添加，经选择角色应用、企业授权确认完成；二是企业手动添加，经填写信息、员工确认完成。 - [质量监控中心](https://opendocs.alipay.com/open/08jkh7.md): 质量监控中心旨在为小程序线上运维环节提供质量问题发现、分析、解决的闭环能力。平台以实时数据监控为基础，提供分钟级告警和多维度分析，包含性能分析、异常监控、异动管理、运维工具四大模块。性能分析帮助定位启动与网络耗时关键阶段；异常监控覆盖白屏、JS异常、接口问题等14类质量问题；异动管理支持告警订阅与长期治理；运维工具提供挂维护、限流、挂黄条等应急处理能力。用户可通过支付宝控制台PC端或移动端助手访问，利用平台定义的性能与异常指标进行精细化质量治理。 ##### 帮助与支持 - [IoT 帮助中心](https://opendocs.alipay.com/open/00a0ih.md): 本文档主要提供了支付宝机具服务的联系方式及常见问题解答。用户可拨打咨询电话4007585858（服务时间8:00-24:00）或通过在线渠道咨询。文档重点解释了机具“近三天不在线”和“无交易”告警的原因，指出这是基于单台设备维度的检测，若设备断网断电或无交易达三天即会提醒。针对门店有交易仍收告警的情况，文档说明可能是因为门店有多台设备或设备已更换。此外，文档还提供了门店信息错误的修正指引，并明确当前机具解绑与换绑需致电客服，未来将开放服务商自助功能。 #### 行业技术组件 ##### 消息通组件 - [消息通组件](https://opendocs.alipay.com/open/00grv4.md): 该文档介绍了一款面向政务民生场景的城市服务动账消息通知产品。产品通过支付宝渠道，为公积金、社保、交管等行业提供账户变更通知服务，旨在解决机构触达渠道缺失及研发成本高的问题。产品免费开放，支持私有化独立部署，具备数据安全、高性能推送特点。接入流程包含下载组件、环境配置、服务启动及业务调试。支持HTTP接口实时推送和文件批量推送两种方式，提供详细的参数配置、SDK调用指南及常见问题排查方案，助力机构快速实现消息触达功能。 ##### 行业会员卡管理组件 - [卡管组件概述](https://opendocs.alipay.com/open/00hze0.md): 支付宝开放平台支持商家和服务商通过调用OpenAPI接入支付宝卡包与商家会员卡产品。为提升接入效率、降低理解成本并简化操作流程，支付宝对行业场景及会员卡管理功能（如发卡、领卡）进行了封装，推出了卡管系统。合作伙伴可直接部署该系统，快速完成支付宝卡产品的对接，从而有效简化接入复杂度，显著提升接入效率。 - [快速会员卡组件](https://opendocs.alipay.com/open/00hafx.md): 本文档介绍了商家自研模式下通过支付宝卡管系统接入商家会员卡产品的全流程。该系统通过封装OpenAPI降低了接入复杂度，服务免费且对支付宝企业账号开放。文档提供了新会员领卡（如门店扫码）和老会员绑定两类应用场景。接入指引包含七个核心步骤：入驻行业SaaS、添加租户成员、创建会员卡应用（含小程序创建与密钥配置）、建立卡模板、多渠道投放测试（小程序、名片、省卡）、开启隐私信息自动回填权限，以及可选的CRM系统数据同步配置，旨在帮助商家高效实现会员数字化管理。 - [政务卡组件](https://opendocs.alipay.com/open/00gt1a.md): 本文档介绍了在政务及商业场景中，以会员卡为载体聚合服务、统一入口的解决方案，旨在解决服务分散、入口不明显等问题。文档重点阐述了“商家自研模式”的接入指引，内容涵盖入驻行业SaaS、创建小程序应用、配置密钥、设计卡模板及多渠道测试等七个关键步骤。适用于支付宝企业账号及个体工商户，支持小程序、APP等多种接入方式，能显著降低研发成本并提升用户体验。 ##### 光华平台 - [服务评价组件](https://opendocs.alipay.com/open/01m840.md): 支付宝市民中心推出“服务评价”产品，旨在帮助合作伙伴评估服务体验与质量。用户在办理完业务后可对小程序进行多维度星级及主观评价，服务商据此改进服务。该功能需在业务办理完成页设置入口，评价提交后跳转回小程序首页。使用前需配置H5域名MD5文件。小程序通过拼接特定URL参数（如orgToken、appCode、serviceId等）跳转至评价组件。其中，四个维度的评分为必填项，URL及回调地址需进行编码处理。 - [支付宝市民中心服务入驻指引](https://opendocs.alipay.com/open/01ntxo.md): 本文档介绍了光华平台支持业主将服务上架至支付宝市民中心的功能及操作流程。手册面向生态合作的政府机构、商家或服务商。接入前，特定机构需联系支付宝业务人员开通权限并加入白名单，提供开放平台PID等信息。服务上架流程包括登录平台、创建服务、填写信息并提交。提交后需依次通过业务、质保、产品、UED、策略及运营等多轮审核方可自动上架。文档还详细定义了编辑中、审核中、审核未通过、使用中、已下线及维护中六种服务状态的含义与客户端展示情况。 - [支付宝市民中心服务自运营指引](https://opendocs.alipay.com/open/01ntxp.md): 本文档介绍了支付宝市民中心开放战略及光华平台的操作指南，旨在赋能政府机构和服务商实现服务的自运营与智能化管理。文档核心内容涵盖运营规则、操作步骤及数据分析三部分。运营规则明确了官方专区的服务展示逻辑与限制条件；操作步骤详细说明了从账号白名单开通、专区服务配置（添加、移除、排序）、内容运营创建与发布，到智能圈人的具体流程；数据分析部分则提供了专区运营数据的查询方法及关键指标定义，帮助服务商有效评估运营效果。 - [支付宝光华平台服务插件接入指引](https://opendocs.alipay.com/open/01nxyz.md): 光华平台是支付宝市民中心为“一网通办”服务商提供的一站式服务平台，旨在实现服务全链路管理与智能化运营。该平台核心功能包括服务拆解（含预警）和服务办结评价。接入流程涵盖创建前端监控应用、配置域名白名单、申请并集成插件模板源码等准备工作。开发实施阶段，文档详细阐述了针对小程序原生页面和嵌入H5页面两种模式的具体改造方案，包括引入上报工具、配置业务参数及处理动态数据。上线前需通过扫描二维码及云监控后台进行数据验收，确保服务名称正确显示及数据上报成功。文档还提供了技术支持渠道及常见问题解答，协助解决依赖异常、数据上报失败及登录态等问题。 - [光华平台搜索词配置审核规范](https://opendocs.alipay.com/open/036mys.md): 该文档介绍了服务搜索关键词的定义、配置规则及审核规范。关键词旨在精准描述服务内容，帮助小程序获取自然搜索流量。配置上，每个服务限设15个关键词，单词长度为2-10个中文字符。审核规范要求关键词须与服务内容强相关，严禁包含违法违规、敏感负面、他人品牌名（含阿里系词汇）、营销诱导及下载推广类词汇。此外，文档还针对政务民生、缴费代办、车辆服务及公益类等特定行业制定了专属命名要求。违规提报将面临整改或停止投放的处罚。 - [拆解办结行业参数](https://opendocs.alipay.com/open/02v9ap.md): 本文档是一份行业服务参数配置表，旨在定义不同行业在“服务拆解”与“服务办结”环节的参数代码。表格涵盖了政务一网通办、人社、税务、民政、就业、医疗、公积金、公安、文体及加油共十个行业领域。文档清晰地展示了行业与参数代码的映射关系，如政务基础参数为h5SE与taSR，细分行业则通过后缀（如_RS、_SW）进行区分。特别指出，“政务就业”与“加油”两个行业在表中显示了完全相同的参数代码（h5SE_JY与taSR_JY），提示了潜在的参数共用或命名冲突情况。 ## 工具 ### 支付宝开放平台密钥工具 - [密钥工具下载](https://opendocs.alipay.com/open/02kipk.md): 支付宝开放平台密钥工具是一款用于生成和管理应用密钥的实用工具。其主要功能包括生成应用公钥、私钥及CSR文件，支持RSA2和SM2算法，并提供密钥匹配、格式转换（PKCS1/PKCS8）、参数签名以及同步/异步验签功能。工具提供Windows和MAC版本下载。使用时需注意：Windows版不可安装在含空格路径下以防乱码；MAC版需处理系统安全验证问题。此外，RSA2默认生成Java适用的PKCS8格式，非Java环境需进行格式转换。 - [生成密钥](https://opendocs.alipay.com/open/02kipl.md): 本文档介绍了使用支付宝开放平台密钥工具生成密钥或CSR文件的方法，主要包含密钥方式和证书方式两种模式。密钥方式用于生成RSA密钥对，证书方式则额外生成CSR文件。关键注意事项包括：应用私钥需用于代码签名并严加保管，应用公钥需上传至平台；密钥与应用(APPID)必须一一对应，不可混用；RSA2算法默认生成PKCS8格式。操作流程上，密钥方式需选择算法后生成密钥文件；证书方式需输入与账号一致的组织名称（沙箱环境有特定规则），生成包含CSR在内的三个文件。 - [密钥匹配](https://opendocs.alipay.com/open/02khjq.md): 该文档主要介绍了如何校验应用私钥和应用公钥是否匹配的操作指引。用户需打开支付宝开放平台密钥工具，在左侧导航栏选择“密钥匹配”功能。操作步骤包括填入或从文件导入商家应用私钥（支持2048位RSA2，PKCS8/PKCS1格式）以及应用公钥。完成输入后，点击“公私钥匹配”按钮即可查看两者是否匹配。文档还指出，若需检验密钥证书模式，应参考其他相关指引。 - [格式转换](https://opendocs.alipay.com/open/02khjp.md): 该文档介绍了使用支付宝开放平台密钥工具进行密钥格式转换的操作指引。用户需在工具左侧选择“格式转换”，通过填入或导入商家应用私钥，实现PKCS8（Java适用）与PKCS1（非Java适用）格式私钥的相互转换。完成转换后，点击相应按钮即可生成应用公钥并自动打开文件位置，以便获取公钥。该流程旨在帮助用户快速区分并转换密钥格式，以适配不同的开发环境。 - [签名](https://opendocs.alipay.com/open/02khjm.md): 本文档介绍了支付宝开放平台接口的签名功能操作指引，旨在帮助开发者通过手动加签验证数据正确性。该功能仅支持新版 OpenAPI 网关接口。加签原理涉及筛选 POST 参数、按 ASCII 码排序并拼接成待签名字符串。操作时需配置请求参数（如 appid、method、charset 等），若为公钥证书模式还需添加证书 SN。开发者需填入匹配的应用私钥，选择 RSA2 签名方式及 UTF-8 或 GBK 字符集。完成设置后，系统可生成待签名内容与最终签名结果，供开发者对比调试。 - [同步验签](https://opendocs.alipay.com/open/02khjn.md): 本文介绍了支付宝开放平台密钥工具在同步响应验签中的操作指导。该工具除支持生成应用公钥和私钥外，还可用于核查自验签结果。验签操作主要分为三步：首先打开工具并在左侧导航栏选择“同步验签”；其次填入返回内容与支付宝公钥，选择对应的签名方式与字符集，点击按钮后工具将自动提取签名值并生成待验签串；最后点击“开始验签”获取最终验签结果。该流程为开发者提供了便捷的签名验证手段。 - [异步验签](https://opendocs.alipay.com/open/02khjo.md): 本文档介绍了使用支付宝开放平台密钥工具进行异步通知验签的操作方法。主要流程分为三步：首先，打开工具并在左侧导航栏选择“异步验签”功能；其次，填入符合格式要求（`key1=value1&key2=value2`）且包含`sign`参数的响应报文及支付宝公钥，设定签名方式与字符集后点击开始；最后，工具会自动提取签名并处理报文，最终显示“匹配成功”或“匹配失败”的验签结果，以此核查支付宝异步通知内容的真实性。 - [产品介绍](https://opendocs.alipay.com/open/0egww7.md): 场景钱包是支付宝通过API对外开放的账户产品，整合了账户、资金与收单能力，支持充值、提现、收支等全方位功能，旨在满足资金存管、定向使用及高效流转的需求。产品具备资金安全托管、消费场景管控及资金动向管控三大核心优势，已广泛应用于物流、游戏、保险、回收等行业。使用流程包含开户、充值及消费三个环节，其中用户充值设有额度限制。该产品免费开放，支持企业账号接入，部分功能需联系业务经理开通。 - [接入准备](https://opendocs.alipay.com/open/0egwwe.md): 本文档介绍了使用支付宝开放平台服务端SDK接入场景钱包的两种模式：商家自研和服务商代开发。商家自研流程包括创建应用、配置加签方式与网关等参数、上线应用、绑定商家账号、开通产品及配置隐私政策。服务商模式需创建第三方应用、获取商家授权令牌并代为调用接口。文档最后详细说明了SDK的集成步骤，提供了公钥模式与公钥证书模式两种加签方式下的AlipayClient对象初始化示例及关键参数配置说明，指导开发者完成服务端接口调用准备。 - [接入指南](https://opendocs.alipay.com/open/0egwwf.md): 本文档为商家和服务商提供了“场景钱包”产品的完整接入指引。该产品仅支持自研或第三方应用代调用，不支持沙箱调试。核心流程涵盖：1. **钱包开通**：创建钱包模版并邀请用户签约，支持多钱包模式；2. **资金管理**：支持用户手动充值、商家代发转账、充值退款及提现，操作前需查询限额或余额；3. **查询功能**：提供余额、流水及单据查询接口；4. **钱包核销**：支持App支付核销，可通过参数指定钱包扣款，并支持核销退款；5. **扩展模式**：介绍了直付通结算及商家代发转账的可选接入方案。文中详细列出了各环节所需的API接口、关键参数配置及异步通知机制。 ## API 列表 ### 钱包开通 - [商户创建钱包模版接口](https://opendocs.alipay.com/open/0f4gze.md): 本文档主要介绍了支付宝“商户钱包模版创建”接口的开发规范。该接口用于通用场景下商户创建钱包模版并获取模版ID。文档详细列出了公共请求参数（如app_id、method、签名类型等）及业务请求参数，后者涵盖产品码、开户场景（如商户储值卡、政企钱包等）、外部业务号及钱包使用规则等配置项。文中提供了C#、Java、PHP及HTTP等多种语言的请求示例，并说明了公共响应参数与业务响应参数，成功响应将返回钱包模版ID。最后，文档列举了系统繁忙、参数有误、未签约、模版数量超限等常见业务错误码及其解决方案，供开发者集成参考。 - [商户邀请用户开通接口](https://opendocs.alipay.com/open/0f4gzr.md): 本文档详细说明了支付宝接口`alipay.fund.wallet.token.create`的技术规范，该接口用于商户在通用场景下邀请用户开通钱包。文档界定了公共请求参数与业务请求参数，业务参数中包含销售产品码、业务场景、外部业务号、钱包模版ID及用户身份信息等关键字段。接口响应返回绑定凭证与绑定链接，用于引导用户完成开通流程。文档提供了C#、Java、PHP及HTTP的请求示例，并列举了系统繁忙、参数非法、用户状态异常等常见业务错误码及其解决方案，为开发者接入钱包开通功能提供了完整的API指导。 - [现金钱包开户完成-结果通知接口](https://opendocs.alipay.com/open/0f4gz6.md): 本文档定义了用户开户完成后OpenMQ结果通知的接口规范，接口名称为`alipay.fund.wallet.open.completed`。文档详细规定了公共请求参数，包括通知ID、时间戳、签名信息及应用ID等。核心消息属性涵盖处理结果、用户钱包ID、业务流水号及操作类型（开户/销户），并明确用户标识采用`user_id`与`open_id`二选一机制，建议新商户使用`open_id`。文档提供了HTTP请求示例，并制定了通知应答规则：商户需返回"success"确认处理成功，若返回"fail"则触发系统重试，重试策略为25小时内按特定频率共投递8次。 ### 钱包充值 - [用户充值创建订单接口](https://opendocs.alipay.com/open/0f4gzc.md): 本文档详细介绍了支付宝钱包充值订单创建接口的使用规范。该接口主要用于用户充值前的前置单据创建，是进行充值操作的必要步骤。文档说明了公共请求参数（如app_id、method、sign等）和业务请求参数，其中业务必选参数包含销售产品码、业务场景、外部订单号、充值金额及钱包ID，可选参数包含失效时间、备注及用户主体校验信息等。接口响应返回资金单据号与内部单据号。文档提供了C#、Java、PHP及HTTP等多种语言的请求示例，并列出了详细的业务错误码及其解决方案，涵盖了系统异常、账户权限、金额限制及钱包状态异常等多种情况，指导开发者正确集成与调试。 - [现金红包无线支付接口](https://opendocs.alipay.com/open/0f4gz1.md): 本文档介绍了支付宝现金红包APP支付接口（alipay.fund.trans.app.pay）的调用方法。该接口为页面跳转接口，用于商户APP唤起SDK创建现金红包单据并支付。服务端需执行SDK的pageExecute方法生成跳转数据，交由前端渲染或重定向。文档详细说明了公共请求参数（如app_id、sign等）和业务请求参数，其中业务参数需包含外部单号、金额、产品码（STD_RED_PACKET）及场景码（PERSONAL_PAY）。此外，文档提供了C#、Java和PHP三种语言的接入代码示例，并说明了响应数据的处理方式。 - [资金转账页面支付接口](https://opendocs.alipay.com/open/0f4gz2.md): 本文档详细介绍了支付宝资金转账页面支付接口。该接口用于PC场景创建资金单据并支付，通过服务端SDK的pageExecute方法生成跳转链接或表单。文档明确规定了公共请求参数（如app_id、method、sign等）及业务请求参数的配置要求，其中商户单号、转账金额、销售产品码和业务场景为必填项。业务参数支持设置详细的付款方与收款方信息、订单标题及超时时间等。文档提供了C#、Java、PHP三种语言的代码示例，演示了请求构造与执行流程。响应结果为跳转页面数据，建议使用POST方式处理。此外，文档指出了公共错误码的查询方式，并说明无特定业务错误码。 - [资金单据状态变更通知接口](https://opendocs.alipay.com/open/0f4gz3.md): 该文档定义了支付宝资金转账订单状态变更通知接口（alipay.fund.trans.order.changed）的规范。适用于单笔转账到账户或银行卡、现金红包等业务场景。通知包含公共参数（如签名、应用ID）和业务参数，业务参数涵盖商户订单号、支付宝单号、业务场景、转账金额、单据状态（如成功、失败、处理中）及收款方信息等。文档详细规定了必选与可选字段，并要求商户系统同步响应“success”以确认处理。若响应“fail”或超时，系统将在25小时内按递增间隔策略重试最多8次，确保消息送达。 - [手动关单接口](https://opendocs.alipay.com/open/0f4gzq.md): 本文档详细说明了支付宝场景钱包订单关闭接口（alipay.fund.wallet.order.close）的技术规范。该接口用于手动关闭场景钱包单据。文档列出了公共请求参数和四个必选业务请求参数（产品码、业务场景、订单号、关单原因），并提供了C#、Java、PHP及HTTP的代码示例。响应参数包含订单号及关单状态。此外，文档还列举了系统繁忙、参数有误、关单失败、资金单不存在等业务错误码及其对应的解决方案，帮助开发者正确集成接口并处理异常情况。 ### 钱包充值退款 - [钱包原路退接口](https://opendocs.alipay.com/open/0f4gz7.md): 本文档介绍了支付宝标准钱包通用场景下的原路退回接口。该接口支持商户通过设定不同的退款策略（如原路退、提现到余额、原单退）将资金退还给用户。文档详细定义了公共请求参数与业务请求参数，重点说明了销售产品码、业务场景、原充值单号等关键字段的填写要求，并提供了C#、Java、PHP及HTTP的代码示例。同时，文档规范了公共与业务响应参数的结构，列举了包括系统错误、余额不足、订单重复等在内的多种业务错误码，并给出了相应的解决方案，指导开发者正确集成与调试接口。 - [钱包账户资金退回通知接口](https://opendocs.alipay.com/open/0f4gz9.md): 该文档定义了“钱包账户原路退和销户通知”接口的技术规范。文档详细列出了支付宝发送通知时的公共请求参数（如通知ID、签名、时间戳等）及消息属性。消息属性包含必选的用户钱包ID、业务单号、操作类型（原路退或销户后退）和金额，以及可选的用户ID、资产明细等字段。文档提供了HTTP POST请求示例，并规定了商户系统的应答要求：需返回“success”确认成功。若返回“fail”或未响应，系统将在25小时内按递增间隔进行最多8次重试，以确保消息送达。 ### 钱包查询 - [资金场景钱包金额查询接口](https://opendocs.alipay.com/open/0f4gz4.md): 本文档详细阐述了支付宝标准钱包信息查询接口的调用规范与实施细则。该接口名称为alipay.fund.wallet.consult，核心功能是查询用户钱包信息，支持钱包查询、提现查询及退卡查询三种业务场景。文档明确了公共请求参数与业务请求参数的具体要求，包括必选的销售产品码、业务场景及查询类型等字段。同时提供了C#、Java、PHP及HTTP等多种开发语言的SDK调用示例，展示了从初始化配置到发送请求的完整流程。响应参数包含钱包ID、卡号、总余额、可用金额等核心数据。此外，文档还列举了系统繁忙、钱包不存在、未签约等常见业务错误码及其对应的解决方案，为开发者集成提供了全面的参考依据。 - [钱包操作流水查询接口](https://opendocs.alipay.com/open/0f4gzb.md): 本文档介绍了支付宝“钱包操作流水查询”接口，用于查询用户钱包的资金变动记录。文档详细说明了公共请求参数（如应用ID、签名、时间戳等）与业务请求参数，后者包括产品码、业务场景、钱包ID、分页信息、时间范围及业务类型（如充值、提现、核销等）。提供了C#、Java、PHP和HTTP的代码示例。响应参数包含分页信息及钱包操作详情（业务类型、金额、时间、订单号）。此外，文档列举了系统错误、参数无效、权限不足等业务错误码及其解决方案。 - [场景钱包单据查询接口](https://opendocs.alipay.com/open/0f4gzj.md): 本文档详细介绍了支付宝钱包单据查询接口，用于查询充值、充值退和提现单据信息。文档明确了公共请求参数（如app_id、method、sign等）及业务请求参数（包括产品码、场景码、钱包ID、单据号和类型）。接口支持多种单据类型，如充值、退款、提现及钱包互转。响应参数包含交易状态、金额、处理时间及详细的资金流转信息。文档提供了C#、Java、PHP和HTTP的请求示例代码，并列出了常见的业务错误码及其解决方案，指导开发者进行接口调用与故障排查。 ### 钱包提现 - [用户发起提现接口](https://opendocs.alipay.com/open/0f4gzf.md): 本文档详细介绍了支付宝标准钱包提现接口的使用规范，旨在实现钱包资金提现到余额的功能。文档首先定义了公共请求参数，涵盖应用ID、接口名称、签名方式及时间戳等必要信息。核心业务参数部分详细说明了产品码、场景码、提现金额、外部业务号及用户钱包ID等关键字段，并提供了钱包营销规则等可选配置。此外，文档提供了C#、Java、PHP及HTTP等多种编程语言的请求示例，便于开发者快速集成。响应部分列出了公共与业务响应参数，并给出了正常与异常响应的JSON示例。最后，文档列举了系统繁忙、钱包不存在、余额不足等常见业务错误码及其对应的解决方案，帮助开发者排查接口调用中的问题。 - [钱包提现异步通知接口](https://opendocs.alipay.com/open/0f4gz5.md): 本文档定义了用户提现成功后的异步通知接口规范，用于在提现完成后向商户发送通知。文档详细规定了公共请求参数，包括通知ID、时间戳、签名信息、版本号及字符集等关键字段，并区分了必选与可选参数。业务请求参数包含用户钱包ID、商户单号、操作类型及提现金额等核心数据。接口要求接收方返回特定响应值：“success”表示接收成功无需重试，“fail”表示失败并触发重试。文档同时提供了完整的消息示例以供参考。 ### 钱包核销 - [用户核销异步通知接口](https://opendocs.alipay.com/open/0f4gza.md): 该文档定义了“用户核销异步通知”的接口规范，旨在指导商户系统接收并处理用户核销结果。文档详细规定了公共请求参数，包括通知ID、时间戳、签名机制及应用ID等基础信息。核心消息属性涵盖了交易号、订单金额、救助金消费金额、商家信息、操作类型及用户钱包ID等关键业务数据，并明确要求用户标识需在user_id与user_open_id中二选一。此外，文档提供了HTTP请求示例，并制定了严格的通知应答机制：商户需返回“success”以确认处理成功，否则系统将在25小时内按特定频率进行最多8次重试，以确保消息送达。 [/FULL_SUMMARY] 本文档详细阐述了通用场景下“用户核销异步通知”的技术接口规范，主要用于指导商户系统接入并处理支付宝发送的用户核销业务结果通知。文档内容结构清晰，涵盖了公共请求参数定义、消息属性详细说明、请求报文示例以及通知应答与重试机制四个核心部分。 首先，公共请求参数部分定义了异步通知消息的基础结构，所有参数均为必选。`notify_id`（最大长度50）作为通知唯一标识；`utc_timestamp`（13位）记录服务端发送时间；`msg_method`标明接口名称；`app_id`指定消息接收方应用ID；`version`区分消息版本（1.0或1.1）；`biz_content`承载具体的业务消息报文；`sign`与`sign_type`（如RSA2）用于验证消息来源的真实性与完整性；`charset`则规定了验签和解密所需的字符编码集（如UTF-8）。 其次，消息属性部分详细解析了`biz_content`中的业务字段，包含多个必选参数及可选参数。必选参数全面覆盖了交易与业务信息，包括：`trade_no`（支付宝交易号）、`biz_fee`（订单金额）、`wallet_fee`（救助金消费金额）、`wallet_fee_change_date`（钱包消费时间）、`merchan_id`（商家ID）、`merchan_name`（商家名字）、`merchan_station`（商家行政区域）、`mcc_type`（消费类型）、`good_title`（商品名字）、`operate_type`（操作类型，支持PAYMENT或REFUND）、`user_wallet_id`（用户钱包ID）及`out_biz_no`（外部单号）。文档特别指出，用户标识字段需在`user_id`（旧版）与`user_open_id`（新版推荐）中二选一传入，并建议新商户启用Open ID配置。可选参数则补充了`digital_shop_id`（数字化门店ID）、`mall_id`（商圈ID）和`biz_type`（场景信息）等扩展信息。文档还附带了一个标准的HTTP POST请求示例，直观展示了参数封装格式。 最后，文档规范了通知应答处理逻辑与重试策略。商户系统需根据处理结果同步返回响应报文：若返回字符串“success”，消息服务判定处理成功并停止投递；若返回“fail”，则判定处理失败并触发重试机制。重试策略设定为在25小时内完成最多8次通知，除首次实时投递外，后续重试间隔依次为2分钟、10分钟、10分钟、1小时、2小时、6小时及15小时。这一机制有效保障了在网络抖动或系统异常情况下的消息最终一致性，为商户系统的稳定对接提供了可靠依据。 [/FULL_SUMMARY] ### 钱包销户 - [钱包销户接口](https://opendocs.alipay.com/open/0f4gzm.md): 该文档介绍了支付宝“用户钱包账号销户”接口（alipay.fund.wallet.destroy）的调用规范。文档详细说明了公共请求参数与业务请求参数，重点包括必选的产品码、业务场景及金额，并建议新商户使用principal_open_id替代即将废弃的principal_id。文档提供了C#、Java、PHP及HTTP的请求示例代码，展示了完整的接入流程。响应参数包含销户单号、金额等信息。此外，文档列举了系统繁忙、余额非空禁止销户、钱包不存在等业务错误码，并提供了相应的解决方案，指导开发者正确接入与调试。 - [常见问题](https://opendocs.alipay.com/open/0egwwh.md): 本文档针对钱包业务的两个核心场景提供了常见问题解答。在钱包开通方面，若商家未收到开通结果的异步通知，建议首先排查消息订阅状态；若通知失败，可通过调用商户邀请开通接口获取钱包ID，但需确保外部业务号等参数与原邀请时一致。在钱包充值方面，针对创建订单与下单加签的参数错误问题，文档明确了充值流程的四个步骤，并重点强调了参数校验规范：创建订单响应中的fund_order_id需作为下单加签的order_id，两者的out_biz_no需保持一致且唯一，且amount需与trans_amount一致。 - [更新日志](https://opendocs.alipay.com/open/0egwwi.md): 2024年12月4日，支付宝宣布“场景钱包”全面开放。作为一款通过API开放的账户产品，场景钱包整合了账户、资金与收单能力，具备收款、付款、充值、提现等全功能。该产品旨在满足用户资金存管、定向使用及支付诉求，实现资金高效运转，现已覆盖物流、游戏、保险、回收、采购等多个行业领域。 --- llms.txt:用于快速了解预览 llms-full.txt:建议先阅读llms.txt，再查看llms-full.txt获取详细说明