更新时间：2025-07-25 16:37:06集成工具收藏订阅更新我的文档设置返回文档完成 后，商家/服务商可根据本文指引快速接入 商家转账。说明：●商家转账 支持自研商家通过 自研应用，调用 api 接入。●商家转账 支持沙箱调试，详情可查看 。●商家转账 必须使用 公钥证书 模式加签，配置详情可查看 接入准备 > 开发设置。建议使用 ，获得更好的技术对接体验。1 调用流程注意：●单笔转账接口仅支持自研应用调用，不支持服务商通过第三方应用代商家调用。●配置ip白名单：为提高商户访问开放平台的安全性，避免商户因应用私钥或证书泄漏等原因导致业务受损，开放平台可以基于商户配置的 ip 白名单，校验商户请求的来源 ip。若来源 ip 不在配置的 ip 白名单范围内，开放平台将拦截掉对应请求。配置详情可查看 开放平台 ip 白名单接入指南。●接口升级兼容：支付宝将来可能会对接口、消息做优化升级，即新增接口、消息的返回参数，开发者的系统逻辑需要兼容此类升级。1.1 业务规则判断是否转账成功：●同步判断： alipay.fund.trans.uni.transfer（单笔转账接口）返回 10000，success 且 status=success（该笔转账交易成功）。●异步判断：alipay.fund.trans.common.query（转账业务单据查询接口）或者蚂蚁消息alipay.fund.trans.order.changed（资金单据状态变更通知）返回的 status（转账单据状态）=success 表示转账成功。2 余额查询2.1 账户余额查询商家可调用 查询请求发起方（即商户自己）的支付宝账户余额，该接口只能查询调用账号的余额，不得查询非请求账号余额。注意：新接入商户不再支持第三方调用。2.1.1 调用流程2.1.2 关键入参参数类型最大长度是否必填参数说明alipay_user_id（alipay_open_id）string18必选蚂蚁统一会员 id。必须等于请求发起方的 pid，可通过 会员信息产品 获取。account_typestring30必选查询的账号类型，固定值为 acctrans_account。2.1.3 关键出参参数具体类型最大长度是否必填参数说明available_amountstring15必选账户可用余额，单位元，精确到小数点后两位。示例值：26.452.1.4 sdk 调用请求示例响应示例 2.2 额度查询2.2.1 转账可用额度查询商家可调用 查询单笔转账到户、单笔转账到卡和现金红包额度信息。调用流程接入说明●接口限制 tps 为 10。●如果返回系统异常或未明确的错误码，请保持原始请求信息重试。●商户服务端请求测试必须使用 公钥证书方式，推荐使用官方的生成证书。●服务端 sdk 接入方案详情可查看 服务端 sdk。●销售产品码与业务场景码必填，无限额场景额度不会被消耗。●如用户通过提额或者安全限制改变了自定义额度，本次查询结果仅作为参考，实际额度限制以接口请求结果为准。3 转账和通知3.1 单笔转账到支付宝账户请求发起方调用 将支付宝账户中的资金转账给收款方支付宝账户中。3.1.1 调用流程3.1.2 接入说明●如果返回系统异常或未明确的错误码，请保持原始请求信息重试。●单笔转账 out_biz_no（转账订单号）不变，响应参数幂等返回。●接口限制 tps 为 100。●商户服务端请求测试必须使用 公钥证书方式，推荐使用官方的生成证书。●新接入商户不支持第三方调用。●服务端 sdk 接入方案详情可查看 服务端 sdk。●单笔转账接口的收款方不支持国外支付宝账户。3.1.3 关键入参参数类型最大长度是否必填参数说明out_biz_nostring64必选商家侧唯一订单号，由商家自定义。对于不同转账请求，商家需保证该订单号在自身系统唯一。示例值：20190619000000001trans_amountstring16必选订单总金额，单位为元，不支持千位分隔符，精确到小数点后两位，取值范围[0.1,100000000]。注意：最小可传金额 0.1 元，最大可传金额 100000000 元，如超过最小或最大金额限制，可能会导致金额超限等接口报错。示例值：1.68product_codestring64必选销售产品码。单笔无密转账固定为 trans_account_no_pwd。biz_scenestring64必选业务场景。单笔无密转账固定为 direct_transfer。payee_infoparticipant-必选收款方信息。└ identity_typestring64必选收款方的标识类型，目前支持如下枚举：●alipay_user_id：支付宝会员的用户 id，可通过 获取会员信息 能力获取。●alipay_logon_id：支付宝登录号，支持邮箱和手机号格式。●alipay_open_id：支付宝会员的用户 id，可通过 获取会员信息 能力获取。└ identitystring64必选收款方的标识 id。●当 identity_type=alipay_user_id 时，填写支付宝用户 id。●当 identity_type=alipay_logon_id 时，填写支付宝登录号。●当 identity_type=alipay_open_id 时，填写支付宝用户 id。└ namestring256可选收款方真实姓名。如果非空，将校验收款支付宝账号姓名一致性。当 identity_type=alipay_logon_id 时，本字段必填。若传入该属性，则在支付宝回单中将会显示这个属性。order_titlestring64必选转账业务的标题，用于在支付宝用户的账单里显示。示例值：201905代发remarkstring200可选业务备注。示例值：201905代发business_paramsstring 2048 可选转账业务请求的扩展参数，支持传入的扩展参数如下：●payer_show_name_use_alias：是否展示付款方别名，可选，收款方在支付宝账单中可见。枚举支持：○true：展示别名，将展示商家支付宝在商家平台 > 商户基本信息 页面配置的 商户别名。○false：不展示别名。默认为 false。示例值：{\"payer_show_name_use_alias\":\"true\"}3.1.4 关键出参名称类型最大长度必填描述out_biz_nostring64必选商户订单号。示例值：20190619000000001order_idstring64必选支付宝转账订单号。示例值：20190619110070000006800000025890pay_fund_order_idstring64必选支付宝支付资金流水号。示例值：20190801110070001506380000251556statusstring32可选转账单据状态。示例值：success，代表该笔转账交易成功trans_datestring32可选订单支付时间，格式为yyyy-mm-dd hh:mm:ss。示例值：2019-08-21 00:00:003.1.5 sdk 调用请求示例响应示例3.2 蚂蚁消息：转账单据状态变更通知转账单据状态变更后，支付宝将调用 触发通知，发送变更信息至商家应用网关地址。3.2.1 调用流程3.2.2 接入说明●设置方式：需根据 订阅消息 指引，在应用开发设置的from平台订阅 ，http接入模式需额外设置应用网关作为通知接收地址。●验签：商户系统接收到异步通知以后，必须通过验签（验证通知中的 sign 参数）来确保支付通知是由支付宝发送的。详细验签规则可查看 异步通知验签。●支付宝开放平台消息服务接入，可查看 开放平台消息服务 文档。本消息接口同时支持 http(s)方式和支持 websocket 长连接，推荐使用 websocket 的长连接通道，性能更优。3.2.3 通知触发条件触发条件名触发条件描述触发条件默认值status=success转账成功true（触发通知）/转账失败false（不触发通知）3.2.4 消息示例 参数说明参数类型最大长度是否必填描述out_biz_nostring64必选商户端的唯一订单号。示例值：201806300001product_codestring32必选销售产品码，商家和支付宝签约的产品码。单笔无密转账固定为 trans_account_no_pwd。biz_scenestring32必选描述特定的业务场景。示例值：direct_transferorigin_interfacestring64必选请求来源的接口。示例值：alipay.fund.trans.uni.transferpay_fund_order_idstring64可选支付宝支付资金流水号。示例值：20190801110070001506380000251556order_idstring64必选支付宝转账单据号。示例值：20190624110075000006530000014566statusstring16必选转账单据状态。可能出现的状态如下：success：转账成功；action_typestring32必选资金订单的操作类型，取值如下：finish- 订单处理已完结。trans_amountstring20必选转账金额。示例值：32.00pay_datestring20可选支付完成时间。示例值：2013-01-01 08:08:08响应值响应值描述是否重试fail消息获取失败重试success消息获取成功不重试3.2.5 消息验签在公钥证书模式下，支付宝开放平台 sdk 提供了 alipaysignature.rsacertcheckv1 方法，可以使用该方法对通知报文验签。以 java 语言为例，按照服务端 sdk 中提供的工具类，进行接收通知及验签，可查看 公钥证书验签示例代码。3.3 转账单据查询商家可调用 查询单笔转账至支付宝账户的订单信息。3.3.1 调用流程3.3.2 接入说明●查询入参 out_biz_no、order_id 与 pay_fund_order_id 三者不可同时为空，三者优先级为 pay_fund_order_id > order_id > out_biz_no，高优先级与低优先级参数同时给出时，用高优先级参数查询，忽略低优先级参数。●新接入商户不再支持第三方调用。●建议以转账调用结果返回后 3 ~ 5 分钟后的查询结果为准，避免极端情况造成资损。3.3.3 关键入参参数类型最大长度必填参数说明order_idstring64特殊必填支付宝转账单据号。●本参数和商户转账唯一订单号、支付宝支付资金流水号三者不能同时为空。●当本参数和商户转账唯一订单号、支付宝支付资金流水号三者同时提供时，将用支付宝支付资金流水号进行查询，忽略其余两者。●当本参数和支付宝支付资金流水号同时提供时，将用支付宝支付资金流水号进行查询，忽略本参数。●当本参数和商户转账唯一订单号同时提供时，将用本参数进行查询，忽略商户转账唯一订单号。示例值：20190619110070000006800000025890pay_fund_order_idstring64特殊必填支付宝支付资金流水号。●本参数和支付宝转账单据号、商户转账唯一订单号三者不能同时为空。●当本参数和支付宝转账单据号、商户转账唯一订单号同时提供时，将用本参数进行查询，忽略本参数。●当本参数和支付宝转账单据号同时提供时，将用本参数进行查询，忽略支付宝转账单据号。●当本参数和商户转账唯一订单号同时提供时，将用本参数进行查询，忽略商户转账唯一订单号。示例值：20190801110070001506380000251556out_biz_nostring64特殊必填商户转账唯一订单号：发起转账来源方定义的转账单据 id。●本参数和支付宝转账单据号、支付宝支付资金流水号三者不能同时为空。●当本参数和支付宝转账单据号、支付宝支付资金流水号同时提供时，将用支付宝支付资金流水号进行查询，忽略本参数。●当本参数和支付宝转账单据号同时提供时，将用支付宝转账单据号进行查询，忽略本参数。示例值：20190619000000001product_codestring64特殊必填销售产品码，如果传了 out_biz_no，则该字段必传。单笔无密转账固定为trans_account_no_pwd。biz_scenestring64特殊必填描述特定的业务场景，如果传递了out_biz_no 则该字段为必传。单笔无密转账固定为direct_transfer。3.3.4 关键出参名称类型最大长度是否必填参数说明order_idstring64必选支付宝转账单据号。示例值：20190703110075000006530004756875pay_fund_order_idstring64可选支付宝支付资金流水号。转账失败不返回。示例值：20190801110070001506380000251556out_biz_nostring64必选商户转账唯一订单号。使用 out_biz_no 查询时，必须传 product_code 和 biz_scene。示例值：20190619000000001pay_datestring-可选支付时间，格式为yyyy-mm-dd hh:mm:ss，转账失败不返回。示例值：2013-01-01 08:08:08statusstring64必选转账单据状态。示例值：success3.3.5 sdk 调用请求示例 响应示例4 回单和下载4.1 获取账单&电子回单电子回单是支付宝提供的用于证明收付款双方发生了相关资金交易行为的凭证文件。商家可根据 常见问题 > 指引，获取电子账单及电子回单作为转账成功的依据。
