分账

目录

• 实时分账
• 分账回调
• 延迟分账
• 退款时指定分账回退
• 添加分账接收方^*

一、实时分账

对接条件

对接分账需要申请收钱吧直连商户，请联系收钱吧商务同事了解确认。

功能描述

收钱吧移动支付接口已经支持分账能力。在完成交易时立即对订单执行分账。实现实时分账功能需要在支付接口/预下单接口/跳转接口的原有传参基础上传入以下参数信息。

实时分账请求参数

profit_sharing:

receivers:

Pay接口传参样例

{
  "terminal_sn": "xxxx",
  "total_amount": "11",
  "dynamic_id": "xxxx",
  "client_sn": "23429341",
  "subject": "苹果手机",
  "operator": "test",
  "profit_sharing": {
    "sharing_flag": "1",
    "sharing_type": "1",        // 按比例分
    "model_id": "m1230000",
    "sharing_notify_url": "https://yourdomain",
    "receivers": [
      {
        "id": "r10000000",
        "ratio": "10%"        // 比例
      },
      {
        "id": "r10000000",
        "ratio": "20%"        // 比例
      }
    ]
  }
}

precreate接口传参样例

{
  "client_sn": "hgfjjgjhg",
  "total_amount": "10",
  "payway": "3",
  "subject": "本日生鲜",
  "operator": "本日生鲜",
  "notify_url": "https://xpay-pre.xisland.cn/adminpay/api/xpay/",
  "terminal_sn": "100017170009630018",
  "profit_sharing": {
    "sharing_flag": "1",
    "sharing_type": "3",        // 按金额分
    "model_id": "m1230000",
    "sharing_notify_url": "https://yourdomain",
    "receivers": [
      {
        "id": "r1800000005",
        "sharing_amount": "1"        // 金额
      }
    ]
  }
}

分账回调：

当交易订单下的所有分账执行均处理成功或均处理失败后，会给商户发送该回调。商户接收到回调后，请返回 success 内容，返回其他内容当做回调失败。回调失败后，分账回调会进行重试，重新推送分账回调地址。重试间隔时间为1s, 5s, 30s, 600s。

sharing_books：

回调参数样例

{
  "sharing_amount": "1",
  "original_amount": "11",
  "model_id": "m1000000040",
  "type": "SHARING_PAY",
  "order_sn": "7894259257646595",
  "client_tsn": "xxxx",
  "client_sn": "xxx",
  "status": "SUCCESS",
  "sharing_books": [
    {
      "receiver_id": "r1000000029",
      "receiver_client_sn": "xxx",
      "account_no": "1493626662",
      "amount": 1
    }
  ]
}

二、延迟分账

对接条件

对接分账需要申请收钱吧直连商户，请联系收钱吧商务同事了解确认。

功能描述

交易完成后业务上并不能立即执行分账，需到达其设定条件才可以执行分账。此时业务系统主动向收钱吧发起订单分账指令并被收钱吧执行。实现延迟分账功能需要有两部分。一部分是告知该订单需延迟分账以及具体信息，在支付接口/预下单接口/跳转接口的原有传参基础上传分账参数；另一部分是发起执行该订单的分账，接口名称为“延迟分账开始分账”。

1. 延迟分账请求参数

参数与实时分账大致相同，只在profit_sharing字段内多delayed字段，表明是否延迟分账。

profit_sharing:

receivers:

接口传参样例

{
  "terminal_sn": "xxxx",
  "total_amount": "11",
  "dynamic_id": "xxxx",
  "client_sn": "23429341",
  "subject": "苹果手机",
  "operator": "test",
  "profit_sharing": {
    "sharing_flag": "1",
    "sharing_type": "1",
    "model_id": "m1230000",
    "sharing_notify_url": "https://yourdomain",
    "delayed": "true",        // 延迟分账
    "receivers": [
      {
        "id": "r10000000",
        "ratio": "10%"
      },
      {
        "id": "r10000000",
        "ratio": "20%"
      }
    ]
  }
}

2. 延迟分账开始分账

Path: {api_domain}/profitsharing/delaysharing

Method: POST

请求头和签名均可参考签名机制文档

接口概述

对交易时标记延迟分账的订单执行分账

请求参数

返回参数

三、退款时指定分账回退

功能描述

退款同时允许商户是否指定分账回退，以及指定回退方、回退金额等信息。实现指定该功能需要在退款接口原有传参的基础上传入以下参数信息。该功能目前仅支持微信直连商户下发生的交易订单退款。

请求参数

profit_sharing:

receivers:

退款接口传参样例

{
    "terminal_sn":"xxxx",
    "sn":"7894259257646595",
    "client_sn":"23429341",        // sn和client_sn二选一，参照退款接口填写
    "refund_request_no":"011",
    "operator":"test-1",
    "refund_amount":"11",
    "profit_sharing": {
      "sharing_flag": "1",    // 退款时可分账回退
      "receivers": [
        {
          "id": "r10000000",
          "sharing_amount": "1"
        }
      ]
    }
}

四、添加分账接收方^*

此功能有条件开放，需要时请提前联系您身边的收钱吧同事

Path: {api_domain}/profitsharing/addreceiver

Method: POST

请求头和签名均可参考签名机制文档

请求参数

receiver_account_list:

返回参数