> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 账单分账

## 添加分账方

**请求地址**: `https://xlink.91xft.cn/profit/add/receivers`

**请求参数**

| 字段              | 是否必选 | 字段类型   | 字段说明             |
| --------------- | ---- | ------ | ---------------- |
| `app_id`        | 是    | String | app\_id          |
| `merchant_code` | 是    | String | 商户编号             |
| `channel`       | 是    | String | 支付渠道             |
| `receiver`      | 是    | String | 分账接收方信息, json 格式 |
| `sign_type`     | 是    | String | 签名类型             |
| `sign`          | 是    | String | 签名值              |

**响应参数**

| 字段             | 是否必选 | 字段类型   | 字段说明         |
| -------------- | ---- | ------ | ------------ |
| `result_code`  | 是    | String | SUCCESS/FAIL |
| `receiver`     | 是    | String | 分账接收方信息      |
| `failure_code` | 是    | String | 业务参数 code    |
| `failure_msg`  | 是    | String | 业务结果描述       |
| `sign_type`    | 是    | String | 签名类型         |
| `sign`         | 是    | String | 签名值          |

**分账接收方信息（receiver）**

| 字段        | 是否必选 | 字段类型   | 字段说明                         |
| --------- | ---- | ------ | ---------------------------- |
| `type`    | 是    | String | 分账方类型，固定传1                   |
| `account` | 是    | String | 分账账户 type=1:商户号；type=2:个人微信号 |
| `name`    | 是    | String | 分账名称                         |

## 移除分账方

**请求地址**: `https://xlink.91xft.cn/profit/remove/receivers`

请求参数及响应同上。type 伟业传1，个人传2。

## 分账申请

**请求地址**: `https://xlink.91xft.cn/profit/sharing1`

**请求参数**

| 字段               | 是否必选 | 字段类型   | 字段说明    |
| ---------------- | ---- | ------ | ------- |
| `app_id`         | 是    | String | app\_id |
| `merchant_code`  | 是    | String | 商户编号    |
| `out_trade_no`   | 是    | String | 商户交易订单号 |
| `share_trade_no` | 是    | String | 分账订单号   |
| `receivers`      | 是    | String | 分账明细列表  |
| `remark`         | 否    | String | 分账备注    |
| `sign_type`      | 是    | String | 签名类型    |
| `sign`           | 是    | String | 签名值     |

**分账明细列表**：`type`, `account`, `amount`(分、int)。

**响应参数**：`result_code`, `out_trade_no`, `failure_code`, `failure_msg`, `sign_type`, `sign`。

## 分账查询

**请求地址**: `https://xlink.91xft.cn/profit/sharing/query`

请求参数: `app_id`, `merchant_code`, `channel`, `out_trade_no`, `sign_type`, `sign`。

**响应参数**：`result_code`, `receivers`(json), `failure_code`, `failure_msg`, `sign_type`, `sign`。

**分账接收方列表（receivers）**

| 字段            | 是否必选 | 字段类型   | 字段说明                                                     |
| ------------- | ---- | ------ | -------------------------------------------------------- |
| `type`        | 是    | String | 1:企业 2:个人                                                |
| `account`     | 是    | String | 分账账户                                                     |
| `amount`      | 是    | int    | 分账金额（分）                                                  |
| `description` | 是    | String | 分账描述                                                     |
| `result`      | 是    | String | PENDING/SUCCESS/ADJUST/RETURNED/CLOSED/CANCELED/REFUNDED |
| `finish_time` | 是    | String | 分账完成时间                                                   |
| `fail_reason` | 否    | String | 分账失败原因                                                   |

## 分账撤销

**请求地址**: `https://xlink.91xft.cn/profit/sharing/cancel`

请求参数: `app_id`, `merchant_code`, `out_trade_no`, `share_trade_no`, `sign_type`, `sign`。

响应参数：`result_code`, `receivers`, `failure_code`, `failure_msg`, `out_trade_no`, `third_trade_no`, `sign_type`, `sign`。