分账申请

POST

https://api.tipay.tianhecloud.com/api/v1/yb/divide/apply

接口描述

订单支付成功后，服务商可通过此接口代商户发起分账请求，将收款资金分给分账接收方。可应用于交易抽成、上下游供应商结算等场景。

使用说明

建议在接收支付成功结果5秒后，再调用此接口申请分账，另外在需要退款的活动场景（如：拍卖、求购）时，建议等活动结束后在进行申请分账，避免退款失败

此接口会同步返回分账状态，如同步获取的分账状态为处理中（PROCESSING），可通过查询分账结果接口获取分账最终结果。

一次分账请求中，有任意一个分账接收方分账失败，则这次分账请求的全部分账明细处理均会失败。

分账金额不能超过订单可分账金额，超过则申请分账失败
手续费 = 订单金额 * 0.0075 保留两位小数，第三位小数四舍五入
可分账金额 = 订单金额 - 手续费
也可以调用查询订单接口获取剩余可分账金额（unSplitAmount）

请求参数

Header 参数

ti-appid

string

必需

天河链开放平台商户Id

示例值:

tichain000000

ti-timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

示例值:

1647751123703

ti-signature

string

必需

API 签名：SHA256(ParamsJson+Timestamp+AppKey)

示例值:

644dbdb0137f1f3add30eca4c9e582da5c6e45d77fea51ab76fbd10ef3442f6b

Body 参数application/json

merchantNo

string

收款商户编号

必需

orderId

string

商户收款请求号

必需

商户请求收款的交易单号

uniqueOrderNo

string

易宝收款订单号

必需

收款交易对应在易宝的收款单号

divideRequestId

string

商户分账请求号

必需

divideDetail

string

分账详情

必需

JSON字符串； ledgerNoFrom：分账发起方编号，非必填。不填默认为收款商编。 ledgerNo：分账接收方编号，必填。分账属性为分账给商户时，为接收分账资金的易宝商户编号；分账属性为分账给个人会员时，为接收分账资金的易宝会员 amount ：分账金额，必填，两位小数 divideDetailDesc ：分账说明，非必填。 ledgerType：分账属性，非必填。可选项如下：MERCHANT2MERCHANT（分账给商户），MERCHANT2MEMBER（分账给个人会员）。不填默认分账给商户。只支持分账给一个个人会员。示例值：[{"amount":"100.00","ledgerNo":"10000466938","ledgerType":"MERCHANT2MERCHANT","divideDetailDesc":"供应商结算"},{"amount":"100.00","ledgerNo":"212345678912","ledgerNoFrom":"10000466938","ledgerType":"MERCHANT2MEMBER"}]

示例

{
    "merchantNo": "occaecat",
    "orderId": "71",
    "uniqueOrderNo": "sint dolore aute ad",
    "divideRequestId": "87",
    "divideDetail": "44",
    "accountLinkInfo": "et pariatur"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tipay.tianhecloud.com/api/v1/yb/divide/apply' \
--header 'ti-appid: tichain000000' \
--header 'ti-timestamp: 1647751123703' \
--header 'ti-signature: 644dbdb0137f1f3add30eca4c9e582da5c6e45d77fea51ab76fbd10ef3442f6b' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantNo": "occaecat",
    "orderId": "71",
    "uniqueOrderNo": "sint dolore aute ad",
    "divideRequestId": "87",
    "divideDetail": "44",
    "accountLinkInfo": "et pariatur"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

success

boolean

必需

data

object

必需

orderId

string

商户收款请求号

必需

uniqueOrderNo

string

易宝收款订单号

必需

divideRequestId

string

商户分账请求号

必需

status

string

分账状态

必需

PROCESSING:处理中 SUCCESS:分账成功 FAIL:分账失败

divideDetail

string

分账详情

必需

JSON字符串； divideDetailNo:易宝分账明细单号 ledgerNo 分账接收方编号 amount 分账金额 divideDetailDesc 分账说明

msg

string

必需

示例

{
    "code": 200,
    "success": true,
    "data": {
        "orderId": "59",
        "uniqueOrderNo": "aliquip ullamco occaecat nisi",
        "divideRequestId": "99",
        "status": "sit fugiat ipsum",
        "divideDetail": "86"
    },
    "msg": "操作成功"
}

查询订单

分账结果查询

分账申请

接口描述#

使用说明#

请求参数

示例代码

返回响应

接口描述

使用说明