升级指南
收藏
我的收藏

说明
本文档为担保支付升级通用交易系统的指南​

差异概述​

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

增量订单升级改造​

前置准备​

能力开通​

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

公私钥生成​

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

进件、账单​

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

支付​

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

订单同步​

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

退款​

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

履约​

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

结算/分账​

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

提现​

    1.若开发者选择在页面提现,则无需对接以下接口,无需做升级改造​
    2.注:增量订单仍可使用担保支付系统的提现接口,但由于未来担保支付将下线,平台强烈建议开发者对接新系统提现相关接口。​
接口​
担保支付​
通用交易​
余额查询​
提现​
提现结果查询​
提现结果回调(需验签)​
文档待上线​

存量订单兼容处理​

前置说明​

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

存量处理​

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