生活服务交易系统(账号融合版)流程简介
收藏
我的收藏接入说明
本文档主要对交易系统新版本基础能力的接入流程进行介绍说明。对于不同行业,实际使用中的一些流程差异可参考各行业接入指南进行调整。
前端能力说明
交易系统针对小程序开发者提供了交易系统前端模板组件和 JS-API 两套方案,请按照需求和要求接入。
进件
选择解决方案后按照担保支付接入指引完成进件流程即可,两种不同解决方案进件指引详见
- •担保支付|企业版接入指引
- •担保支付|普通版接入指引
预下单
- 1.注意行业交易系统无自动扣减商品库存和商品限购功能,需要开发者自行处理商品库存校验和限购。
JSAPI 下单
关键步骤说明:
- •步骤2: JS API可通过调用tt.createOrder发起下单
- •步骤4: JS API发起下单时,抖音开平交易系统会请求开发者的预下单扩展点,将下单信息传递给开发者服务
- ◦开发者需要先完成预下单扩展点设置才能接收抖音扩展点请求,扩展点设置请参考行业模板配置文档
- •步骤7:抖音客户端在拿到预下单结果后,会调起收银台
模板组件下单
关键步骤说明:
- •步骤2: 开发者可通过交易模板组件pay-button传入商品信息发起下单
- •步骤4: 模板组件下单时,抖音开平交易系统会请求开发者的预下单扩展点,将下单信息传递给开发者服务
- ◦开发者需要先完成预下单扩展点设置才能接收抖音扩展点请求,扩展点设置请参考行业模板配置文档
- •步骤7:抖音客户端在拿到预下单结果后,会调起收银台
接口下单(只适用于低版本小程序)
关键步骤说明:
- •步骤3: 接口下单需要开发者通过调用发起预下单接口进行下单
- •步骤6:开发者小程序在拿到预下单的返回结果后,需要调用tt.pay能力拉起收银台
支付
关键步骤说明:
- •步骤4: 用户支付完成后,抖音开平交易系统会请求开发者的支付结果回调接口将支付结果通知开发者。
- ◦开发者需要完成回调地址配置才能接收抖音支付回调通知,回调地址设置请参考 行业模板配置文档
- •步骤6: 回调可能存在延时,开发者也可以通过查询订单信息接口及时获取支付结果。
退款
用户退款
关键步骤说明:
- •步骤2:开发者可通过调用JS-API的tt.applyRefund接口或者接入模板组件跳转到退款页面。
- •步骤6:用户发起退款后,抖音开平交易系统会请求开发者的退款申请扩展点,通知开发者用户发起退款
- ◦开发者需要先完成退款申请扩展点设置才能接收抖音扩展点请求,扩展 点设置请参考行业模板配置文档
- •步骤9:步骤6的扩展点请求信息中,会包含退款单是否需要审核信息,对于需要审核的退款单,需要开发者审核完成后将审核结果通过同步退款审核结果接口通知给抖音开平交易系统。
- •步骤12: 抖音开平交易系统在收到开发者的审核成功结果后,会发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- ◦开发者需要完成回调地址配置才能接收抖音退款回调通知,回调地址设置请参考行业模板配置文档
- •步骤14:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
过期自动退
关键步骤说明:
- •步骤2:订单过期触发自动退逻辑后,抖音开平交易系统会请求开发者的退款申请扩展点 ,通知开发者该笔订单发起退款
- •步骤6:步骤2的扩展点请求信息中,会包含退款单是否需要审核信息,对于需要审核的退款单,需要开发者在审核完成后将审核结果通过同步退款审核结果接口通知给抖音开平交易系统。开发者需要先完成退款申请扩展点设置才能接收抖音扩展点请求,扩展点设置请参考行业模板配置文档
- •步骤9: 抖音开平交易系统在收到开发者的审核成功结果后,会发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- ◦开发者需要完成回调地址配置才能接收抖音退款回调通知,回调地址设置请参考 行业模板配置文档
- •步骤11:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
抖音客服强制退款
关键步骤说明:
- •步骤2:客服发起退款后,抖音开平交易系统会请求开发者的退款申请扩展点 ,通知开发者该笔订单发起退款
- •步骤6: 抖音开平交易系统在收到开发者的退款受理结果后,会发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- ◦开发者需要完成回调地址配置才能接收抖音退款回调通知,回调地址设置请参考 行业模板配置文档
- •步骤8:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
开发者退款
关键步骤说明:
- •步骤1:当开发者需要替用户发起退款时,可调用发起退款接口发起退款。
- •步骤4:开发者可以通过步骤1的响应结果判断,对于需要审核的 退款单,需要开发者在审核完成后将审核结果通过同步退款审核结果接口通知给抖音开平交易系统。
- •步骤7: 抖音开平交易系统在收到开发者的审核成功结果后,会发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- ◦开发者需要完成回调地址配置才能接收抖音退款回调通知,回调地址设置请参考 行业模板配置文档
- •步骤9:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
核销
三方码核销
关键步骤说明:
- •使用三方码核销能力请在抖音开放平台-开发-解决方案配置-生活服务中选择对应行业的能力中申请开通三方码权限,否则会默认走抖音码核销
- •步骤2:开发者系统在完成订单核销后,可以调用推送核销状态接口将核销状态推送给抖音开平交易服务。
抖音码核销
关键步骤说明:
- •使用抖音码核销能力需要找对应行业的CQC开通交易系统闭环核销白名单
- •使用抖音码核销,需要通过JSAPI下单或者模板组件下单
- ◦JSAPI下单需要在tt.createOrder的callbackData字段中增加{"use_trade_delivery": 1}
- ◦模板组件下单需要在pay-button的bind:getgoodsinfo的extra字段中增加{"use_trade_delivery": 1}
- •步骤4:抖音码核销需要先调用验券准备接口获取可用券列表。
- •步骤7:获取可用券列表后,开发者需要自行选择需要核销的券数据,将该券数据通过验券接口进行核销。
- •步骤9:开发者可调用查询券状态信息接口获取卡券状态信息,如已核销,已退款等状态。
预约
关键步骤说明:
- •步骤3:用户购买预售类产品支付成功后,开发者可调用创建预约单接口创建预约单
- •步骤6:在预约接单结果变更时,开发者可以通过同步预约接单结果接口将预约接单结果同步给抖音开平交易系统。
- •步骤9:当预约提交后一定时间内还没收到开发者的接单通知,抖音开平交易系统会请求开发者预约超时回调通知开发者接单超时。
- ◦开发者需要完成回调地址配置才能接收抖音预约回调通知,回调地址设置请参考 行业模板配置文档
- •步骤12:当预约完成后,抖音开平交易系统会请求开发者预约完成通知扩展点通知开发者预约完成。
- ◦开发者需要先完成预约完成扩展点设置才能接收抖音扩展点请求,扩展点设置请参考行业模板配置文档
- •步骤14:开发者可通过商家取消预约接口取消预约
- •步骤19:用户如果需要取消预约,开发者可通过用户取消预约接口替用户发起取消预约。
- •步骤23:在用户投诉,客户取消预约后,抖音开平交易系统会请求开发者预约取消通知接口通知开发者预约订单已取消。
分账
关键步骤说明:
- •步骤1:订单到达分账周期后,开发者可通过调用发起分账接口发起分账,将该订单产生的资金结算给各个分账方。
- •步骤3:分账完成后,抖音开平交易系统会请求开发者通知分账结果接口将分账结果通知给开发者。
- •步骤5:分账回调可能存在延时,开发者也可以主动调用分账查询接口 获取分账结果。
- ◦开发者需要完成回调地址配置才能接收抖音分账回调通知,回调地址设置请参考 行业模板配置文档
提现
关键步骤说明:
- •步骤1: 开发者/服务商可以调用商户余额查询接口获取可提现余额。
- •步骤2: 开发者/服务商在获取可提现余额后,可以调用提现接口进行提现,将资金从可提现账户提现到开发者/服务商的银行卡或支付宝账户。
- •步骤3: 抖音开放平台在提现完成后,会调用商户的提现回调接口通知开发者/服务商提现结果。提 现成功或者失败都会回调通知开发者,回调可能存在延迟或丢失,建议开发者通过查询接口主动获取提现结果。提现结果通知会使用开发者请求时的提现结果通知接口字段地址
- •步骤4: 开发者/服务商也可以主动调用提现结果查询接口获取提现结果。