抖音开放平台Logo
开发者文档
小程序
“/”唤起搜索
控制台
  • 交易能力
  • 支付产品介绍
  • 支付能力接入准备
  • 支付方式开通
  • 通用交易系统
  • 通用交易系统介绍
  • 通用交易系统接入指引
  • 接入规范
  • 钻石兑换
  • 钻石兑换接入指南
  • 钻石结算接入指南
  • 钻石兑换常见问题
  • 钻石兑换结算常见问题
  • 生活服务行业交易系统
  • 周期代扣
  • 资金结算
  • 历史文档合集
  • 评价能力
  • 留资订单组件
  • 广告组件
  • 线索组件配置

    • 一、钻石兑换介绍

    “钻石”是抖音平台向用户提供的仅限于在抖音平台内进行相关消费的虚拟工具。购买“钻石”后，用户可以按照平台相关页面的说明及指引使用、获得平台商品或服务。此文档主要介绍小程序开发者如何接入钻石能力，实现用户通过钻石兑换小程序内虚拟商品的功能。

    二、准入要求

    设备：当前仅支持IOS端
    该能力目前处于试点阶段，仅支持部分行业开放。
    注意
    工具行业：工具-营销工具-互动营销、工具-娱乐工具-答题/解密/测评、工具-AI工具-AI工具暂未开放。
    工具
    短剧
    长视频
    小说
    小程序需完成 ICP 备案
    小程序通过定向准入
    小程序通过定向准入
    小程序需完成 ICP 备案
    小程序需完成通用交易系统接入，交易订单 ≥ 1 笔
    小程序满足短剧类小程序运营规范
    小程序满足长视频类小程序运营规范
    小程序需完成通用交易系统接入，交易订单 ≥ 1 笔
    小程序完成试运营阶段（新手村阶段暂不支持）
    小程序需完成 ICP 备案
    小程序需完成 ICP 备案
    小程序完成试运营阶段（新手村阶段暂不支持）
    小程序上架时间 ≥ 90 天
    小程序内的短剧符合广电监管部门关于短剧内容的监管要求
    小程序需完成通用交易系统接入，交易订单 ≥ 1 笔
    小程序无过高投诉率
    小程序无过高投诉率
    小程序需完成通用交易系统接入，交易订单>=1笔
    小程序完成试运营阶段（新手村阶段暂不支持）
    开发者主体无严重违规处置记录
    小程序信用分 ≥ 80 分
    小程序完成试运营阶段（新手村阶段暂不支持）
    完成长视频内容入库
    小程序无严重违规处置记录
    开发者主体无严重违规处置记录
    小程序无过高投诉率
    钻石仅支持兑换抖音渠道会员
    小程序无侵权成立记录，且无内容风险问题
    小程序无严重违规处置记录
    小程序无严重违规处置记录
    小程序无过高投诉率
    ——
    小程序无侵权成立记录，且无内容风险问题
    开发者主体无严重违规处置记录
    小程序无严重违规处置记录
    ——
    -
    小程序无侵权成立记录，且无内容风险问题
    开发者主体无严重违规处置记录
    ——
    -
    -
    小程序无侵权成立记录，且无内容风险问题
    ——

    三、接入流程

    ​

    3.1 开通【抖音钻石支付能力】

    3.1.1开通入口指引

    入口路径：登录「抖音开放平台 -> 控制台 -> 小程序 -> 能力 -> 支付 -> 支付产品管理 -> 抖音钻石」页面，对符合准入要求的小程序，会展示开通入口指引，点击「去开通」后，填写商户信息且勾选协议后提交。
    ​

    3.1.2补充资料清单说明

    开通钻石能力需补充商户经营相关资料，填写后根据行业准入要求，将进入审批流。
    信息分类
    需要填写信息
    填写说明
    是否必填
    商户信息
    业务介绍
    详细介绍小程序出售商品或提供服务的业务场景、退款规则说明等，建议附上官方介绍链接。不少于 30 个字，不超过 200 字。
    是
    用户的购买流程图
    上传小程序首页、商品/服务详情页、订单页、购买页及购买完成页，要求图片清晰无遮挡。最多可上传 6 张，图片仅支持 BMP、JPG、JPEG、PNG 格式，大小不超过 2MB。
    是
    用户的税目和税率
    上传用户提供的发票样本图片，要求图片清晰无遮挡，需露出税目&税率。最多可上传 3 张，图片仅支持 BMP、JPG、JPEG、PNG 格式，大小不超过 2MB。
    是
    版权内容授权材料（仅针对小说行业）
    上传当前小程序内 top10 热门小说的版权授权材料。
    文件支持 PDF 格式，大小不超过 10MB。
    小说行业必填
    抖音钻石支付承诺函
    （仅针对小说行业）
    文件支持 PDF 格式，大小不超过 10MB。
    结算账户
    指钻石结算收款账户
    ​
    开户名称
    系统自动获取，无需填写 ，同开发者入驻主体一致。
    是
    银行账号
    请正确填写银行卡号，错误信息将导致打款失败。
    是
    再次输入银行账号
    请正确填写银行卡号，错误信息将导致打款失败。
    是
    开户银行
    选择总行信息。
    是
    开户支行信息
    选择该银行卡对应的开户支行，如果提示暂无数据则表示不支持该支行，请更换银行名称或开户地址，也可选择上级分行。
    是
    税率
    指开发者向用户开票的具体税率信息
    发票税率
    ​
      •一般纳税人 6%。
      •小规模纳税人 1%、3% 或免税
    是
    发票类型
    系统自动获取，无需填写 ，增值税专用发票
    是
    发票项目
    系统自动获取，无需填写，信息服务费
    是
    结算退件地址
    收件人姓名
    填写收件人姓名
    是
    联系电话
    填写收件人的联系电话
    是
    收件地区
    收件详细地址
    是
    详细地址
    收件详细地址
    是
    其他
    注册地
    营业执照的注册地址
    是
    验证方式
    支持通过手机号或邮箱验证
    是

    3.1.3能力开通资质审核流程

    审核时效如下，审核通过后系统将立即开通“抖音钻石”能力：
      •工具行业：资料补充后需经过人工审核，预计审核将在 5-7 个工作日内完成。
      •短剧/小说行业：均为系统自动审核，预计提交申请当日可完成审核。

    3.2 开通【服务费结算账户（即抖音支付账户）】

    开通此账户用于支付抖音开放平台技术服务费（如有）及小程序推广计划相关费用（如有）。若存在相关费用且未开通此账户，将影响开发者的正常结算流程。

    3.2.1开通入口指引

    登录「抖音开放平台 -> 控制台 -> 小程序 -> 能力 -> 支付 -> 支付产品管理 -> 抖音钻石」页面，会展示开通入口指引，点击「去开通」且勾选协议后，填写开发者信息并提交。
    ​

    3.2.2补充资料清单说明

    开通抖音支付账户需要填写相关信息，用于结算平台技术服务费及小程序推广计划相关费用。
    信息模块
    需要填写信息
    填写说明
    是否必填
    商户信息
    商户类型
    系统从开发者账号中心自动同步信息，需检查一致性。
    是
    商户证件类型
    是
    商户证件照片
    是
    商户名称
    是
    商户证件号码
    是
    商户证件起止日期
    是
    商户简称
    自定义
    是
    商户所属行业
    根据实际经营情况自选，建议参考营业执照经营范围。
    是
    法人信息
    法人证件类型
    ​
    支持的证件类型：
      •商户类型为“党政机关”，仅可选择身份证。
      •商户类型为“个体户/企业/事业单位/社会组织”：身份证、护照、港澳居民来往内地通行证、台湾同胞来往大陆通行证、外国人居留证、港澳居民证、台湾居民证。
    是
    法人证件照片
    根据选择的证件类型上传对应证件照片，系统识别证件照片后自动填充信息，需核对与证件内容一致性。
    是
    法人姓名
    系统从开发者账号中心自动同步信息，需检查一致性。
    是
    法人证件号码
    系统识别证件照片后自动填充信息，需确保与证件照片信息一致。
    是
    法人证件起止日期
    是
    管理员信息
    管理员类型
    可选择法人或者经办人（非法人）
    是
    管理员手机号
    请填写有效手机号用于接收商户号相关通知。
    是
    结算信息
    结算方式
      •商户类型为个体工商户时，可以选择对私银行卡或者对公银行卡。
      •商户类型为其他时，只能选择对公银行卡。
    是
    银行卡开户名
    系统自动获取信息，开发者需检查是否一致。
      •对私银行卡：银行卡开户名需要与法人姓名一致。
      •对公银行卡：银行卡开户名需要与商户名称一致。
    是
    银行名称
    选择总行信息
    是
    开户地址
    选择开户城市
    是
    开户支行名
    选择该银行卡对应的开户支行，若提示暂无数据表示该支行不可用，需更换银行/开户地或选择上级分行。
    是
    银行卡号
    填写银行卡号
    是
    特殊行业补充资料
    补充材料
    开发者所属行业为特殊行业时需要补充对应材料（请参照详细的特殊行业补充资质材料）。
    是

    3.2.3账户开通资质审核

    审核时效：通过后即开通结算账户。所有行业均为系统自动审核，预计当日完成。
    ​

    3.3改造交易链路

    支持的交易系统
    通用交易系统
    展示「钻石」产品条件
      •用户下单时对应操作系统为 iOS
      •此单收款账户对应主体为小程序主体
      •已完成钻石产品开通
    交易链路改造
    ​
      ◦新增 data.currency字段，iOS 必须指定 currency=DIAMOND（Android 可不传此字段）
      ◦可自主定价，当currency=DIAMOND时，将钻石金额(数量)传入原data.totalAmount和data.skuList.price字段
      ◦因钻石退款拆分问题，暂不支持一笔订单下多份商品（即skuList.quantity仅能为1）
      ◦新增data.currency字段，当用户以钻石兑换时，currency=DIAMOND
      ◦新增data.total_currency_amount和data.item_order_list.item_order_currency_amount字段，当用户以钻石兑换时，该字段会填充对应的钻石数量
      ◦msg新增currency字段，当用户以钻石兑换时，currency=DIAMOND
      ◦原msg.pay_channel字段，当用户以钻石兑换时，pay_channel=20
      ◦原msg.total_amount字段，当用户以钻石兑换时，会填充为钻石数量
      ◦新增currency字段，钻石订单发起退款必须指定currency=DIAMOND
      ◦原则上用户支付成功后不可退款，发起退款的 API 接口支持支付完成后 7 日内处理特殊退款请求。如有超过 7 日的钻石订单需退款，需通过线下方式或联系平台运营申请原路退回
      ◦产生退款订单，将在结算单内产生逆向单，结算时予以扣除
      ◦新增currency字段，钻石订单退款currency=DIAMOND
      ◦原refund_total_amount和 refund_amount，钻石订单退款会填充退钻石数量
    获取交易账单接口
    接口文档：获取交易账单，请求参数商户号信息传入null即可

    3.4钻石余额组件接入

    3.4.1余额组件介绍

    钻石余额组件，支持开发者在任意小程序页面上进行集成，可为小程序下用户展示其抖音钻石账户余额，并可支持随时充值，以提升场景下钻石兑换交易转化
    适用场景：为提升钻石交易转化，可提前在小程序首页、提单页或用户中心等大流量场景集成该组件，引导用户提前完成钻石充值。用户拥有钻石余额后，后续钻石兑换场景转化更高，提升整体变现效率

    3.4.2示例

    3.4.3接入方式

    diamond-balance钻石充值与余额组件_小程序_抖音开放平台

    3.4.5重点接入说明

      •适用场景：
    为提升钻石交易转化，可提前在小程序首页、提单页或用户中心等大流量场景集成该组件，引导用户提前完成钻石充值。用户拥有钻石余额后，后续钻石兑换场景转化更高，提升整体变现效率
      •钻石充值后的应用场景：
    通过余额组件完成充值后，用户的抖音钻石账户会完成入账，后续可以在抖音内任意支持钻石兑换的场景（如直播间、小程序、小游戏）内，兑换相关的服务
      •用户在余额组件完成充值后，是否可以收到相关回调
    是，可通过扩展点消息获取，复用通用交易系统支付通知

    四、资金结算流程说明

    详见：钻石结算接入指南