抖音开放平台Logo
开发者文档
小程序
“/”唤起搜索
控制台
  • 交易能力
  • 支付产品介绍
  • 支付能力接入准备
  • 支付产品接入
  • 通用交易系统
  • 周期代扣
  • 生活服务行业交易系统
  • 支付方式开通
  • 生活服务交易系统（账号融合版）流程简介
  • 生活服务交易系统（全融合版）流程简介
  • 评价能力
  • 常见问题
  • 留资订单组件
  • 广告组件
  • 线索组件配置

    • 接入说明

    本文档主要对交易系统新版本基础能力的接入流程进行介绍说明。对于不同行业，实际使用中的一些流程差异可参考各行业接入指南进行调整。
    如需了解适合对接哪种交易系统，可以参见「能力-解决方案-生活服务解决方案」目录下的接入文档。

    前端能力说明

    交易系统针对小程序开发者提供了前端模板组件和 JS-API 两套方案，请按照需求和要求接入。
    前端模板组件pay-button在预下单流程，退款流程和核销流程中提供了页面模板组件，适合对流程无定制需求的开发者。
    JS-API 提供在预下单流程，退款流程中提供了基础能力调用，适合对流程有特殊需求的开发者。

    进件

    进件需要先选择支付解决方案，详见担保支付解决方案。
    选择解决方案后按照担保支付接入指引完成进件流程即可，两种不同解决方案进件指引详见：

    预下单

    注意行业交易系统无自动扣减商品库存和商品限购功能（需开发者自行处理商品库存校验和限购）。
    方式
    流程图
    关键步骤说明
    JS API 下单
      •步骤4: JS API发起下单时，抖音开平交易系统会请求开发者的预下单扩展点，将下单信息传递给开发者服务
        开发者需要先完成预下单扩展点设置才能接收抖音扩展点请求，扩展点设置请参考行业模板配置。
      •步骤 7：抖音客户端在拿到预下单结果后，会调起收银台
    模板组件下单
      •步骤 2: 开发者可通过交易模板组件 pay-button 传入商品信息发起下单。
      •步骤 4: 模板组件下单时，抖音开平交易系统会请求开发者的预下单扩展点，将下单信息传递给开发者服务。
        开发者需要先完成预下单扩展点设置才能接收抖音扩展点请求，扩展点设置请参考行业模板配置。
      •步骤 7：抖音客户端在获取预下单结果后将自动拉起收银台
    接口下单
    只适用于低版本小程序
      •步骤 3: 接口下单需要开发者通过调用预下单接口发起下单。
      •步骤 6：开发者小程序在拿到预下单的返回结果后，需要调用 tt.pay 拉起收银台。
    ​

    支付

    关键步骤说明：
      •步骤 4: 用户支付完成后，抖音开放平台交易系统会调用开发者的支付结果回调接口将支付结果通知开发者。
        开发者需要完成回调地址配置才能接收抖音开放平台支付回调通知，配置方法请参考行业模板配置文档。
      •步骤 6: 回调可能存在延时，开发者也可以通过查询订单信息接口及时获取开放平台支付结果。

    退款

    方式
    流程图
    关键步骤说明
    用户退款
      •步骤 6：用户发起退款后，抖音开放平台交易系统会通过退款申请扩展点通知开发者用户已发起退款。
        开发者需要先完成退款申请扩展点设置才能接收抖音扩展点请求，扩展点设置请参考行业模板配置。
      •步骤 9：步骤 6 的扩展点请求信息中，会包含退款单是否需要审核的信息，对于需要审核的退款单，开发者需要在审核完成后将审核结果通过同步退款审核结果接口通知给抖音开平交易系统。
      •步骤 12: 抖音开放平台交易系统在收到开发者的审核成功结果后，会发起资金退款并通过退款结果通知接口向开发者推送资金退款完成状态。
        开发者需要完成回调地址配置才能接收抖音退款回调通知，回调地址设置请参考行业模板配置。
      •步骤 14：建议主动调用查询退款结果接口实时获取退款状态（重复内容已合并）。
    过期自动退
      •步骤 2：订单过期触发自动退款逻辑后，抖音开放平台交易系统会调用开发者的退款申请扩展点，通知开发者该笔订单发起退款。
      •步骤 6：步骤 2 的扩展点请求信息中，会包含退款单是否需要审核的信息。对于需要审核的退款单，需调用同步退款审核结果接口向抖音开平交易系统提交审核结果。开发者需要先完成退款申请扩展点设置才能接收抖音扩展点请求，扩展点设置请参考行业模板配置。
      •步骤 9：抖音开放平台交易系统在收到开发者审核结果后，将通过退款结果通知接口推送资金退款完成状态。
        回调地址配置方法请参考行业模板配置文档。
      •步骤 11：建议主动调用查询退款结果接口实时获取退款状态（重复内容已合并）。
    抖音客服强制退款
      •步骤 2：客服发起退款后，抖音开放平台交易系统会调用开发者的退款申请扩展点，通知开发者该笔订单发起退款。
      •步骤 6：抖音开平交易系统在收到开发者的退款受理结果后，会发起资金退款，并通过退款结果通知接口向开发者推送资金退款完成状态。
        回调地址配置方法请参考行业模板配置文档。
      •步骤 8：建议主动调用查询退款结果接口实时获取退款状态（重复内容已合并）。
    开发者退款
      •步骤 1：当开发者需要替用户发起退款时，可调用发起退款接口发起退款。
      •步骤 4：开发者可以通过步骤1的响应结果判断，对于需要审核的退款单，需调用同步退款审核结果接口向抖音开平交易系统提交审核结果。
      •步骤 7：抖音开放平台交易系统在收到审核成功结果后，将发起资金退款并通过退款结果通知接口推送退款完成状态。
        回调地址配置方法请参考行业模板配置文档。
      •步骤 9：开发者需主动调用查询退款结果接口以实时获取退款状态。
    ​

    核销

    类型
    流程图
    关键步骤说明
    三方码核销
      •使用三方码核销能力需在抖音开放平台「开发-解决方案配置-生活服务」中选择对应行业方案申请开通权限，未开通将默认采用抖音码核销
      •步骤 2：开发者系统在完成订单核销后，可以调用推送核销状态接口将核销状态推送给抖音开平交易服务。
    抖音码核销
      •使用抖音码核销能力需联系对应行业权责人开通交易系统闭环核销白名单。
      •使用抖音码核销，需要通过JSAPI下单或者模板组件下单。
      ◦JS API下单需要在 tt.createOrder 的 callbackData 字段中增加{"use_trade_delivery": 1}。
      ◦模板组件下单需要在 pay-button 的 bind:getgoodsinfo 的 extra 字段中增加{"use_trade_delivery": 1}。
      •步骤 4：开发者需调用验券准备接口获取抖音码核销的可用券列表。
      •步骤 7：获取可用券列表后，开发者需要自行选择需要核销的券数据，将该券数据通过验券接口进行核销。
      •步骤 9：开发者可调用查询券状态信息接口获取卡券状态信息，如已核销，已退款等状态。
    ​

    预约

    关键步骤说明：
      •步骤 3：用户购买预售类产品支付成功后，开发者可调用创建预约单接口完成创建。
      •步骤 6：在预约接单结果变更时，开发者可以通过同步预约接单结果接口将预约接单结果同步给抖音开平交易系统。
      •步骤 9：当预约提交后一定时间内还没收到开发者的接单通知，抖音开平交易系统会请求开发者预约超时回调接口通知开发者接单超时。
        开发者需要完成回调地址配置才能接收抖音预约回调通知，回调地址设置请参考行业模板配置。
      •步骤 12：当预约完成后，抖音开平交易系统会请求开发者预约完成通知扩展点接口通知开发者预约完成。
        开发者需提前配置预约完成扩展点，配置方法请参照行业模板配置。
      •步骤 19：用户如果需要取消预约，开发者可通过用户取消预约接口替用户发起取消预约。
      •步骤 23：当用户取消预约时，抖音开平交易系统会调用开发者预约取消通知接口同步订单状态。

    分账

    关键步骤说明：
      •步骤 1：订单到达分账周期后，开发者可通过调用发起分账接口将该订单产生的资金结算给各分账方。
      •步骤3：分账完成后，抖音开平交易系统会调用开发者的通知分账结果接口传递分账结果。
      •步骤 5：分账回调可能存在延迟，开发者也可以主动调用分账查询获取分账结果。
        开发者需要完成回调地址配置才能接收抖音分账回调通知，回调地址设置请参考行业模板配置文档。

    提现

    关键步骤说明：
      •步骤 1: 开发者/服务商可以调用商户余额查询接口获取可提现余额。
      •步骤 2: 开发者/服务商在获取可提现余额后，可以调用提现接口将可提现账户资金转至开发者/服务商的银行或支付宝账户。
      •步骤 3: 抖音开放平台在提现完成后，会调用商户的提现回调接口通知开发者/服务商提现结果。提现成功或失败均会回调通知开发者，回调可能存在延迟或丢失，建议开发者通过查询接口主动获取提现结果。提现结果通知将使用开发者预先配置的提现结果通知接口地址。
      •步骤 4: 开发者/服务商也可以主动调用提现结果查询接口获取结果。
    ​