1. 交易（二级）
TiPay
  • 开放文档
    • Ti-Pay 支付通道快速接入
    • Q&A
    • 易宝钱包支付页面交互步骤图解
    • 交易（二级）
      • 交易下单
        POST
      • 查询订单
        GET
      • 分账申请
        POST
      • 分账结果查询
        GET
      • 申请退款
        POST
      • 退款查询
        GET
    • 数藏钱包
      • 钱包注册/登录接口
      • 钱包账户信息查询
  1. 交易（二级）

分账申请

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

接口描述#

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

使用说明#

1.
建议在接收支付成功结果5秒后，再调用此接口申请分账，另外在需要退款的活动场景（如：拍卖、求购）时，建议等活动结束后在进行申请分账，避免退款失败
2.
此接口会同步返回分账状态，如同步获取的分账状态为处理中（PROCESSING），可通过查询分账结果接口获取分账最终结果。
3.
一次分账请求中，有任意一个分账接收方分账失败，则这次分账请求的全部分账明细处理均会失败。
4.
分账金额不能超过订单可分账金额，超过则申请分账失败
手续费 = 订单金额 * 0.0075 保留两位小数，第三位小数四舍五入
可分账金额 = 订单金额 - 手续费
也可以调用查询订单接口获取剩余可分账金额（unSplitAmount）

请求参数

Header 参数

Body 参数application/json

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

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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": 200,
    "success": true,
    "data": {
        "orderId": "59",
        "uniqueOrderNo": "aliquip ullamco occaecat nisi",
        "divideRequestId": "99",
        "status": "sit fugiat ipsum",
        "divideDetail": "86"
    },
    "msg": "操作成功"
}
修改于 2023-07-31 09:30:34
上一页
查询订单
下一页
分账结果查询
Built with