抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
说明
本文档为担保支付升级通用交易系统的指南

差异概述

环节
担保支付
通用交易系统
下单支付
​
    •open_api创建支付单
    •tt.pay唤起收银台
标签规则
​
    •无
​
    •引入「交易保障」,下单必须传递标签组id,标签组承载了交易退款规则,使订单具备规则属性,保障双方交易权益
履约同步
    •无
    •部分商品类型必须接入履约同步,履约信息影响退款规则和结算账期。
申请退款
​
    •无平台退款入口
    •无需商户审核
    •订单的标签组id,决定了该笔订单的退款规则
订单同步
    •开发者必须接入订单同步服务
    •自动同步至抖音订单中心,开发者无需关心
​

增量订单升级改造

前置准备

能力开通

通用交易系统有接口维度的调用能力控制,需要先完成能力申请、配置相关回调地址、及发布

公私钥生成

通用交易系统与担保支付使用的签名算法不同,开发者需使用「应用私钥」加签和「平台公钥」验签

进件、账单

与担保支付现有能力兼容,开发者无需改造
注:增量订单仍可使用担保支付系统的账单接口,但由于未来担保支付将下线,平台强烈建议开发者对接新系统账单相关接口。(进件不受影响)

支付

接口
担保支付
通用交易
下单(需加签)
担保支付预下单
拉起支付
tt.pay唤起收银台
tt.getOrderPayment唤起收银台
支付回调(需验签)
担保支付回调
主动查询
支付结果查询

订单同步

接口
担保支付
通用交易
订单同步
订单同步接口
不需要开发者同步, 平台自动同步

退款

退款规则详见规则标签
分类
接口
担保支付
通用交易
开发者发起的退款
发起退款申请
发起退款
平台发起的退款
退款申请回调
无
同步退款审核结果
无
都有
查询退款结果
退款结果查询
退款结果通知(需验签)
退款结果回调

履约

部分商品类型需要接入履约,详见履约状态
接口
担保支付
通用交易
服务端推送履约状态
无
用户确认履约状态
无

结算/分账

若开发者选择开通自动结算 ,则无需对接以下接口,无需做升级改造
接口
通用交易
结算/分账接口
分账结果查询
分账结果通知(需验签)
增量订单(接通用交易系统)的结算账期,详见下表
担保支付
通用交易
​
​
结算账期
行业
商品类型
结算方式
结算账期
支付后7天
​
通信
​
号卡商品/定制服务
履约后结算
履约完成后7天
虚拟充值
支付后结算
支付后7天
咨询
​
普通咨询/预约咨询
履约后结算
​
履约完成后7天
​
代写文书
工具
虚拟服务
支付后结算
支付后7天
内容消费
内容充值
支付后14天
通用行业
快递物流服务
支付后结算
支付后14天
软件服务
汽车服务
中介服务
租赁服务
生活缴费
网约车服务

提现

    1.若开发者选择在页面提现,则无需对接以下接口,无需做升级改造
接口
通用交易
余额查询
提现
提现结果查询
提现结果回调(需验签)
​

存量订单兼容处理

前置说明

开发者接入新系统前,需要做好订单打标,便于区分存量订单(接担保支付的)和增量订单(接通用交易的)

存量处理

存量订单同步
​
存量订单退款
存量订单履约
    •存量订单无需处理
存量订单结算/分账
    •使用自动结算的开发者,无需处理
存量订单提现
​