开放平台
首页
支付业务
首页
支付业务
  • 说明

    • 概述
    • 签名
  • 支付

    • 下单支付

      • 二维码支付
      • JSAPI支付
      • 付款码支付
      • 支付通知
      • JSAPI调起支付
  • 交易查询

    • 交易查询
    • 交易退款

      • 申请退款
      • 退款查询
  • 订单分账
    • 添加分账方
    • 请求分账

分账

分账接口文档

1. 接口概述

本文档提供了统一的分账接口,允许商户在支付成功后将资金分配给多个分账接收方。

2. 接口规则

  • 请求和响应格式:统一使用 JSON 格式进行数据交换。
  • 安全性:所有请求必须通过 HTTPS 进行,确保数据传输的安全。

3. 开发准备

3.1. 搭建和配置开发环境

开发者需要根据所使用的编程语言选择合适的开发库,并配置项目。目前支持 Java、PHP 和 Go 语言的开发库。

4. 分账流程

4.1. 添加分账接收方

在进行分账之前,商户需要先添加分账接收方。

请求参数:

  • merchant_no:商户号,字符串类型。
  • buyer_id: 支付宝用户 ID
  • openId:微信用户 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. 附录

  • 接口规则:详细描述了接口的请求和响应格式、安全性要求等。

  • 开发库文档:提供了各个语言版本的开发库使用说明。

  • 错误码列表:列出了可能遇到的错误码及其含义。

  • 增加分账方