行业交易系统流程简介
接入说明
本文档主要对行业交易系统基础能力的接入流程进行介绍说明。
前端能力说明
交易系统针对小程序开发者提供了交易系统前端模板组件和 JS API 两套方案,请按照需求和要求接入。
进件
选择解决方案后按照担保支付接入指引完成进件流程即可,两种不同解决方案进件指引详见:
预下单
注意
行业交易系统无自动扣减商品库存和商品限购功能,需要开发者自行处理商品库存校验和限购。
JS API 下单
关键步骤说明:
- •步骤 2:JS API 可通过 tt.createOrder 发起下单。
- •步骤 4:JS API 发起下单时,抖音开放平台交易系统请求开发者的预下单扩展点,将下单信息传递给开发者服务。
- •步骤 7:抖音客户端在拿到预下单结果后,调起收银台。
模板组件下单
关键步骤说明:
- •步骤 2:开发者可通过交易模板组件 pay-button 传入商品信息发起下单。
- •步骤 4:抖音开放平台交易系统请求开发者的预下单扩展点,将下单信息传递给开发者服务。
- •步骤 7:抖音客户端在获取到预下单结果后,调起收银台。
接口下单(只适用于低版本小程序)
关键步骤说明:
- •步骤 3:开发者调用开发者发起下单接口进行下单。
- •步骤 6:开发者小程序在获取到预下单的返回结果后,使用 tt.pay 调起收银台。
支付
关键步骤说明:
- •步骤 4:用户支付完成后,抖音开放平台交易系统请求开发者的支付结果回调接口将支付结果通知开发者。
- •步骤 6:回调可能存在延时,开发者也可以通过查询订单信息接口及时获取支付结果。
退款
用户退款
关键步骤说明:
- •步骤 2:开发者可通过调用 plugin.applyRefund 接口传入退款信息。
- •步骤 6:用户通过交易模板发起退款后,抖音开放平台交易系统请求开发者的退款申请扩展点,通知开发者用户发起退款。
- •步骤 9:步骤 6 的扩展点请求信息中,包含退款单是否需要审核信息,对于需要审核的退款单,需要开发者完成退款单的审核,开发者在审核完成后将审核结果通过同步退款审核结果接口通知给抖音开放平台交易系统。
- •步骤 12:抖音开放平台交易系统在收到开发者的审核成功结果后,发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- •步骤 14:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
过期自动退
关键步骤说明:
- •步骤 2:订单过期触发自动退逻辑后,抖音开放平台交易系统请求开发者的退款申请扩展点,通知开发者该笔订单发起退款。
- •步骤 6:步骤 2 的扩展点请求信息中,包含退款单是否需要审核信息,对于需要审核的退款单,需要开发者在审核完成后将审核结果通过同步退款审核结果接口通知给抖音开放平台交易系统。
- •步骤 9: 抖音开放平台交易系统在收到开发者的审核成功结果后,发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- •步骤 11:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
抖音客服强制退款
关键步骤说明:
- •步骤 2:客服发起退款后,抖音开放平台交易系统请求开发者的退款申请扩展点,通知开发者该笔订单发起退款。
- •步骤 6:抖音开放平台交易系统在收到开发者的退款受理结果后,发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- •步骤 8:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
开发者退款
关键步骤说明:
- •步骤 1:当开发者需要替用户发起退款时,可调用发起退款接口发起退款。
- •步骤 4:开发者可以通过步骤 1 的响应结果判断,对于需要审核的退款单,需要开发者完成退款单的审核,开发者在审核完成后将审核结果通过同步退款审核结果接口通知给抖音开放平台交易系统。
- •步骤 7: 抖音开放平台交易系统在收到开发者的审核成功结果后,发起资金退款,在资金退款完成后请求开发者退款结果通知接口将退款结果通知给开发者。
- •步骤 9:回调可能存在延迟,开发者也可以主动通过查询退款结果接口及时获取退款结果。
核销
三方码核销
关键步骤说明:
抖音码核销
关键步骤说明:
- •步骤 4:抖音码核销需要先调用验券准备接口获取可用券列表。
- •步骤 7:获取可用券列表后,开发者需要自行选择需要核销的券数据,将该券数据通过验券接口进行核销。
- •步骤 9:开发者可调用查询券状态信息接口获取卡券状态信息 ,如已核销,已退款等状态。
分账
关键步骤说明:
- •步骤 1:订单到达分账周期后,开发者可通过调用发起分账接口发起分账,将该订单产生的资金结算给各个分账方。
- •步骤 3:分账完成后,抖音开放平台交易系统请求开发者通知分账结果接口将分账结果通知给开发者。
- •步骤 5:分账回调可能存在延迟,开发者也可以主动调用分账查询接口获取分账结果。
提现
关键步骤说明:
- •步骤 1:开发者/服务商可以调用商户余额查询接口获取可提现余额。
- •步骤 3:开发者/服务商在获取可提现余额后,可以调用提现接口进行提现,将资金从可提现账户提现到开发者/服务商的银行卡或支付宝账户。
- •步骤 4:抖音开放平台在提现完成后,调用商户的提现回调接口通知开发者/服务商提现结果。提现成功或者失败都会回调通知开发者,回调可能存 在延迟或丢失,建议开发者通过查询接口主动获取提现结果。
- •步骤 7:开发者/服务商也可以主动调用提现结果查询接口获取提现结果。
Bug & Tip
•Tip:未完成进件步骤无法进行支付下单
