泛知识行业交易系统能力

更新时间 2024-07-24 02:58:49
收藏
我的收藏

介绍​

交易系统是平台对于泛知识开发者的课程售卖环节所提供的基础解决能力,包含了订单模型、订单正逆向状态机流转、订单数据结构等功能。开发者只有接入交易系统后,才能更好地在抖音里进行课程的分发和转化,进而提升用户体验。​

使用场景​

若小程序开发者希望生产的课程在抖音上进行售卖,即需要接入该能力。​
    视频售卖:​
    直播售卖:

接入准备​

接入前工具安装​

    安装字节小程序开发者工具:需安装字节小程序开发 IDE 及相关工具:小程序开发者工具。​
    准备抖音开发包:安装对应版本开发包,进行交易组件等前端组件的测试与接入工作。
    Android
    测试版:
    2080 全量后,可在各大应用商店下载抖音最新 2080 版本。
    iOS
    iOS 请在 apple store 下载抖音最新 20.8.0 版本
    由于技术原因,目前请不要使用 iOS 13.6 或 iOS 13.7 的真机进行调试。后期该问题会修复。
    20.8.0 全量后,可在 Apple Store 下载抖音最新 20.8.0 版本

接入流程​

泛知识接入整体上可以分为课程库接入以及交易系统接入两部分:​
    课程库接入后能提供泛知识课程分发管控能力,是开发者生产的课程能够售卖的所需要的先决能力。​
    交易系统接入后提供用户在购买课程时下单、支付、分账等正向能力,以及发起退款时的退款等逆向能力。​
整体接入流程图如下:​

整体架构​

架构图只专注于帮助开发者理解双方系统之间的联系,将不会涉及课程库与交易系统内部的细节设计。​

课程库接入​

从整体上讲,接入课程库主要包括上传课程资源、同步老师/机构资质、同步课程信息三步。​
其中,同步老师/机构资质及同步课程信息都需要通过审核,且同步老师/机构资质所获取的资质 ID 将作为同步课程的必要参数。​
流程图如下:​
在以上每一步,平台均提供相应主动查询接口,以查询资源上传/资质审核/课程审核的相应状态及进展,此外,开发者也可通过在课程库信息同步接口注册回调接口,来及时获取当资源上传/资质审核/课程审核等事件发生状态变更时,平台向开发者所通知的参数。​

核心交互流程​

上传资源​

添加/修改资质​

添加/修改课程​

交易系统接入​

接入交易系统前务必确保已接入泛知识课程库,只有已经绑定资质以及补充了交易字段的课程才允许进行交易,不满足条件的课程使用前端组件下单会报"商品不存在"的错误,详情请看添加课程文档中的 common_product_params 和 course_params 参数。​
    common_product_params​
    product_img_uri​
    course_params​
    teacher_id/institution_id​
    course_num​
    refund_label​
    use_label(可不填,不填则默认为「购买后永远有效」)​
更多关于交易系统的信息,请参见交易系统接入流程。​
需要注意,目前泛知识前端接入交易系统只支持 pay-button 交易按钮接入方案,还不支持小程序 api 方案​

沙盒使用须知​

沙盒环境的调用和生产环境调用通过域名区分,其他参数保持一致,沙盒环境域名:https://open-sandbox.douyin.com,开发者通过切换不同的域名即可实现对不同环境发起请求。​

功能范围​

支持的接口​

接口
说明
抖音开平交易系统在下单、退款、分账等流程中需要与开发者系统同步信息​
查询开发者设置的回调地址
查询订单的基本信息​
一笔订单完成后,开发者可以通过分账接口将这笔订单产生的资金结算给各个分账方​
开发者可通过此接口查询订单的分账记录​
开发者可用该接口替用户发起退款,开发者发起的退款流程则不会有退款申请回调​
开发者使用该接口回传退款流程中的退款审核结果​
开发者可通过此接口查询指定退款单的详情。​
营销拓展点回调配置接口,方便开发者自行按需配置​
原核销接口 自 2023-01-05 日起开发者可无需再调用,已接入该接口的开发者可自行安排下线对该接口的调用(目前继续调用亦不产生影响),该接口自即日起从文档中去除。

沙盒使用指南​

使用沙盒调试应用的具体操作步骤,请参见沙盒环境。​