分账
分账接口文档
1. 接口概述
本文档提供了统一的分账接口,允许商户在支付成功后将资金分配给多个分账接收方。
2. 接口规则
- 请求和响应格式:统一使用 JSON 格式进行数据交换。
- 安全性:所有请求必须通过 HTTPS 进行,确保数据传输的安全。
3. 开发准备
3.1. 搭建和配置开发环境
开发者需要根据所使用的编程语言选择合适的开发库,并配置项目。目前支持 Java、PHP 和 Go 语言的开发库。
4. 分账流程
4.1. 添加分账接收方
在进行分账之前,商户需要先添加分账接收方。
请求参数:
merchant_no:商户号,字符串类型。buyer_id: 支付宝用户 IDopenId:微信用户 OpenId
响应参数:
relation_id:分账关系 ID,由平台生成。
4.2. 发起支付
在支付请求中,商户需要指定是否需要分账。
请求参数:
profit_sharing:是否需要分账,布尔类型。
4.3. 请求分账
支付成功后,商户可以请求分账。
请求参数:
transaction_id:支付订单号,字符串类型。out_trade_sn:商户端分账请求单号,字符串类型。receivers:分账接收方列表,包含以下字段:type:分账接收方类型。account:分账接收方账号。amount:分账金额。description:分账描述。
响应参数:
order_id:分账订单号,由平台生成。
5. 签名和验签
所有请求必须包含有效的签名,以确保请求的合法性。开发者可以参考具体的开发库文档来实现签名和验签。
6. 错误处理
统一分账接口会返回错误码和错误信息,开发者需要根据错误码进行相应的错误处理。
7. 安全性和合规性
- 所有敏感信息,如私钥和证书,必须妥善保管。
- 遵守相关法律法规和平台政策。
8. 测试和调试
开发者可以在沙箱环境中进行接口测试和调试,确保接口的正确性和稳定性。
9. 附录
接口规则:详细描述了接口的请求和响应格式、安全性要求等。
开发库文档:提供了各个语言版本的开发库使用说明。
错误码列表:列出了可能遇到的错误码及其含义。