支付宝商家分账问题相关12345 [复制链接]

接入准备

更新时间：2020-10-21 16:47:13

本文展示了如何从零开始，使用支付宝开放平台服务端 SDK 快速接入商家分账产品，完成与支付宝对接的部分。
注意：
文档中的代码示例和 Demo 是用来阐述 API 基本使用方法的，仅针对大众场景，供 ISV 参考。特殊情况还请 ISV 自行扩展，确保符合自身业务需求。

创建应用


若要在应用中接入商家分账能力，需要先登录支付宝开放平台（open.alipay.com），在开发者中心中创建登记应用，并提交审核。审核通过后会生成应用唯一标识（APPID），并且可以申请开通开放产品使用权限。通过 APPID 该应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。


配置应用




添加能力并签约


应用创建完成后，系统会自动跳转到应用详情页面。开发者可以在 能力列表 中点击 添加能力 来添加商家分账能力。待应用上线后，开发者可以给添加的功能进行签约。详细步骤可以参考 添加应用功能，第三方应用可以 代替商户签约。


配置密钥


为了保证交易双方（商家和支付宝）的身份和数据安全，开发者在调用接口前，需要配置双方密钥，对交易数据进行双方校验。RSA 密钥包含应用私钥（APP_PRIVATE_KEY）、应用公钥（APP_PUBLIC_KEY）。生成密钥后，开发者需要在开放平台开发者中心进行密钥配置，配置完成后可以获取支付宝公钥（ALIPAY_PUBLIC_KEY），配置的详细步骤请参考《配置应用环境》。您还可以通过观看 快速签名教程 学习密钥的配置。
说明： 支付宝开放平台 SDK 封装了签名和验签过程，只需配置账号及密钥参数，建议开发者使用。开发者还可以通过 自助排查流程 和 验签教程 自助排查配置应用过程中遇到的问题。


集成并配置 SDK


要接入商家分账，开发者需要集成服务端 SDK。服务端 SDK 需要商户集成在自己的服务端系统中，用于后续的服务端接口调用。


下载服务端 SDK


为了帮助开发者调用开放接口，我们提供了 开放平台服务端 SDK，包含 JAVA、PHP、NodeJS、Python 和 .NET 五种，封装了签名&验签、HTTP 接口请求等基础功能。请先下载对应语言版本的 SDK 并引入您的开发工程。


接口调用配置


在 SDK 调用前需要进行初始化，以 JAVA 代码为例：[backcolor=rgba(228, 228, 228, 0.75)]AlipayClient alipayClient =  new  DefaultAlipayClient(URL,APP_ID,APP_PRIVATE_KEY,FORMAT,CHARSET,ALIPAY_PUBLIC_KEY,SIGN_TYPE);
关键参数说明:

配置参数	示例值解释	获取方式/示例值
URL	支付宝网关（固定）。	https://openapi.alipay.com/gateway.do
APPID	APPID 即创建应用后生成。	获取见上方 创建应用
APP_PRIVATE_KEY	开发者私钥，由开发者自己生成。	获取见 配置密钥
FORMAT	参数返回格式，只支持 json。	json（固定）
CHARSET	编码集，支持 GBK/UTF-8。	开发者根据实际工程编码配置
ALIPAY_PUBLIC_KEY	支付宝公钥，由支付宝生成。	获取详见配置密钥
SIGN_TYPE	商户生成签名字符串所使用的签名算法类型，目前支持 RSA2 和 RSA，推荐使用 RSA2。	RSA2

接下来，就可以用 alipayClient 来调用具体的 API 了。alipayClient 只需要初始化一次，后续调用不同的 API 都可以使用同一个 alipayClient 对象。
注意：
ISV /开发者可以通过 第三方应用授权 得到商户授权令牌（app_auth_token）作为请求参数传入，实现代商户发起请求的能力。

商户分账接入流程说明





一、文档地址

商户分账接入文档地址详见官方产品文档

注：（1）该产品支持第三方方式调用。
（2）该产品不支持沙箱环境测试。


二、产品介绍

产品说明	（1）商家分账，指资金在到达商家的支付宝账号后，开放平台根据商家传入的分账规则，将相应的资金从商家的支付宝账号划转至分账对象的支付宝账号。 （2）案例：服务商从商家账户抽取佣金等
注意事项	（1）商家分账只支持企业支付宝账户签约 （2）目前商家分账支持：当面付，电脑网站支付，手机 APP 支付，手机网站支付、小程序支付、周期扣款、新当面资金预授权、支付宝预授权等。 不支持：收钱码。

三、开发前准备



1、签约

（1）自助签约（推荐）：点击签约商家分账选择右下角的立即接入进行签约操作
（2）签约遇到问题请到商家服务中心在线咨询或拨打商家服务热线95188咨询，服务时间为：8:00-24:00。



2、创建应用

（1）创建应用：登录开放平台创建应用，详见如何创建应用。
（2）生成密钥：根据接口加签模式，选择如何生成RSA2密钥或者如何生成公钥证书。
（3）添加功能包：点击开发者中心，根据自己的业务需求，选择对应用添加“商家分账”功能，并显示已生效。



3、SDK&Demo

服务端sdk：点击服务端sdk选择对应的语言进行下载即可。



四、对接流程



1、API调用流程




2、分账执行流程




五、接口集成代码示例



1、分账关系维护



分账绑定

分账关系绑定接口集成代码详见alipay.trade.royalty.relation.bind示例。

关键字段	是否必传	参数说明
out_request_no	是	外部请求号。32个字符以内，可包含字母、数字、下划线。 注：商户自定义，需保证在商户端不重复。
+receiver_list	是	分账接收方列表，单次传入最多20个
└type	是	分账方类型。 userId：表示是支付宝账号对应的支付宝唯一用户号； loginName：表示是支付宝登录号。
└account	是	分账方帐号。 type=userId，为2088开头的uid信息； type=loginName，为用户的支付宝登录号。
└name	是	分账方全称
└memo	否	分账关系描述

辅助接口

接口英文名	接口中文名
alipay.trade.royalty.relation.unbind	分账关系解绑接口
alipay.trade.royalty.relation.batchquery	分账关系查询接口

2、分账



分账

统一收单交易结算接口集成代码详见alipay.trade.order.settle示例。

关键字段	是否必传	参数说明
out_request_no	是	外部请求号。32个字符以内，可包含字母、数字、下划线。 注：商户自定义，需保证在商户端不重复。
trade_no	是	支付宝订单号，需疯长的该笔交易的trade_no
+royalty_parameters	是	复杂类型,需要指定资金处理类型royalty_type 和补差出资账户trans_out
└royalty_type	否	补差场景，固定传值：transfer 为空默认为分账transfer
└trans_in_type	否	userId表示是支付宝账号对应的支付宝唯一用户号uid; loginName表示是支付宝登录号； 不传默认为userId。
└trans_in	是	收入方账户，根据trans_in_type决定设置uid还是支付宝登录号等。
└trans_out_type	否	userId表示是支付宝账号对应的支付宝唯一用户号; loginName表示是支付宝登录号； 不传默认为userId。
└trans_out	否	支出方账户，根据trans_out_type决定设置pid还是支付宝登录号等。
└amount	是	分账的金额
└desc	否	分账描述

辅助接口

以当面付接口请求示例为例

接口英文名	接口中文名
alipay.trade.query	统一收单线下交易查询接口（必传"query_options":["TRADE_SETTLE_INFO"] ）
alipay.trade.refund	统一收单交易退款接口（通过 refund_royalty_parameters 传递退分佣信息）

六、注意事项

1、商家调用分账绑定接口，最多支持建立 5000 个分账关系，若需要再添加绑定，需解绑之前绑定的人员。
2、分账时一次分账最多可以分给 20 个分账收入方，但是该接口支持多次调用请求分账。
3、商家分账必须在交易仍处于trade_status=TRADE_SUCCESS（交易支付成功）是才可分账。
4、2020年3月20日之后自助签约的商家分账的最高分账比例为交易的30%，在此之前签约的商家分账最高分账比例仍然为交易的100%。
5、分账是否成功根据查询接口进行判断，详见如何判断商家分账是否成功。
6、分账成功后退款，详见商家分账如何退款退分账（支持退款、退分账、仅退分账不退款）。

• 当面付产品退款时不需要传入退分账明细；系统自动按退款金额与订单金额的比率，从收款方和分账收入方退款，不支持指定退款金额与退款方。
• 电脑网站支付、手机 APP 支付、手机网站支付产品，必须在退款请求中明确是否退分账，从哪个分账收入方退，退多少分账金额；如不明确，默认从收款方退款退分账。不支持系统按比率退款。