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

    • 什么是钻石兑换

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

    示例展示

    准入要求

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

    接入流程

    ​

    第一步：开通产品能力

    符合准入标准后，开发者需开通抖音钻石能力以支持用户使用钻石兑换虚拟商品。

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

    开通入口指引

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

    补充资料清单说明

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

    能力开通资质审核流程

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

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

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

    开通入口指引

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

    补充资料清单说明

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

    账户开通资质审核

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

    第二步：改造交易链路

    支持的交易系统
    通用交易系统
    展示「钻石」产品条件
      •用户下单时对应操作系统为 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即可
    ​

    第三步：资金结算

    在约定结算周期内，平台会统计结算周期内开发者应获得的收入，并生成对应的结算单。开发者可以根据结算单中的「结算总金额」开具发票，平台审核发票后完成结算。

    结算说明

    结算总金额
    ​
    结算总金额 =（开发者收入分成 - 呆坏账）× (1 + 开发者开具发票的增值税税率) / 1.06
    特殊说明：即开发者需向平台开具发票的金额。
    开发者收入分成 = 订单净额 * 开发者收入分成比，具体开发者收入分成比详见小程序合作协议。
    订单净额 = 结算周期内的订单总金额 - 退款金额
    呆坏账：包括但不限于[未成年人退款]、[经司法/行政主管部门要求的退款]、[任何一方综合考虑用户体验/舆论影响等因素而决定的退款]等特殊场景
      •超过退款周期（7 个自然日）的特殊退款场景，需向用户退还抖音钻石对应的人民币金额
      •退款超过退款周期时，平台技术服务费不予退还。超过小程序推广计划任务最长退款周期时，小程序推广服务费不予退还
    发票税率：开发者可自行进行设置，需与发票实际税率一致
    已结金额
    小程序推广计划相关费用和抖音开放平台技术服务费，该部分已入账，不通过本次流程打款支付。
    应结金额
    开发者实际完成结算后可以获得的平台打款金额。应结金额=结算总金额-已结金额。
    结算周期
    前一个月 20 日 0 时至本月 19 日 24 时。公司有权依据协议约定的情况延长结算周期.

    结算流程

    ​

    结算单生成

      1.结算周期：前一个月 20 日至本月 19 日为一整个结算周期。
      2.一般情况下，系统会在每月开始的 10 个工作日内生成上月结算单，若遇节假日等特殊情况，系统将顺延生成结算单。

    结算单查看与核对

    结算单生成后，开发者可在指定后台查看结算单相关信息并进行核对。
    具体操作
    进入路径
    页面展示
    进入支付结算单管理页面，查看每月生成的结算单
    ​
    路径：能力-支付-抖音钻石-收入结算
    ​
    ​
    进入结算单详情页面，查看并核对结算单具体信息无误。
    主要需核对结算单税率、收款账户、退件地址等信息
    ​
    路径：能力-支付-抖音钻石-收入结算-结算单详情
    确认结算单无误后进行下载盖章
    点击【下载结算单】将结算单打印后加盖公司圆形公章
    路径：能力-支付-抖音钻石-收入结算-结算单详情
    ​
    ——

    结算单信息修改

    进入支付结算单管理页面，核对结算单税率、收款账户、退件地址等信息后，如发现内容有误，请根据以下提示修改并重新生成对应月份结算单。
    修改信息
    操作流程
    结算单税率
    操作流程：修改税率→重新生成对应月份结算单
    当开发者为企业主体时，可重新选择企业类型、并修改发票税率。
    特别说明：修改仅对单个小程序生效，已进入支付流程的结算单无法被作废与重新生成。
    生效时间：
    提交修改后，系统会立即作废旧结算单。
    新的结算单将在每日或次日的 17:00 重新生成，请留意站内信通知。
    账户信息
    修改权限：仅拥有者、管理员
    操作流程：修改税率→填写信息与上传变更函→等待生效→重新生成对应月份结算单
    特别说明：修改将影响当前合同下关联的全部小程序，即同“合同编号”下的所有小程序
    生效时间：收款信息修改并通过审批后，次月 1 日 0 点生效
    重新生成结算单
    修改税率、账户信息等信息后，需在后台选择对应的结算周期进行结算单的重新生成，目前只支持未进入结算审核流程的结算单进行重新生成。重新生成结算单后，目标月份的结算单会自动进行合并结算处理。
    退件地址
    由于开发者结算件可能存在票据错误、缺失、信息不明确、重复寄送等情况，请在【退件地址】中准确填写你的退件信息，以便平台及时退回。
    必填要求：目前结算退件地址为结算必填项，如你的小程序没有填写该信息，在进入结算板块时会出现无法跳过的弹窗提示，请将该信息填写完成后再进入。

    结算单和发票上传/邮寄

    结算方式

    线下结算：寄送加盖公章的结算单 + 纸质增值税专用发票
    下载结算单 → 核对信息 → 盖章结算单并开具发票 → 寄送材料 → 等待结算
    线上结算：CA 签章确认结算单 + 电子增值税专用发票
    核对结算单信息无误 → CA 确认结算单→上传电子发票 → 等待结算

    票据交付规范

    内容
    要求
    发票信息
    对应的发票购买方为【北京抖音科技有限公司】，发票信息如下： 
    公司名称：北京抖音科技有限公司
纳税人识别号：91110101MA0045N17U
地址：北京市海淀区北三环西路甲18号院4号楼2层2022
联系电话：010-58341810
开户银行名称：招商银行股份有限公司北京首体科技金融支行
开户银行账号：110921247210101
开票内容：【*信息系统服务*信息服务费】或【*信息系统增值服务*信息服务费】
发票类型：增值税专用发票（仅免税期间支持免税普通发票）
开票金额：“结算金额”（税价合计）
    纸质发票发票要求
      •增值税专用发票应包括「抵扣联」与「发票联」 两联，免税普通发票应包括「发票联」。
      •纸质发票需加盖发票专用章（电子发票无需加盖）。
      •发票价税合计金额应与结算单首页的总金额完全一致。
      •发票税率应与结算单税率一致。
      •发票应字迹清楚，尤其密码区不得压线、错格。
      •发票购买方、销售方信息完整、正确。
      •发票大小编号一致。

    票据交付流程

    类型
    交付方式
    纸质发票
    ​
      1.结算单下载打印，结算单需加盖公章（财务章或发票章均无法结算），如有两页结算单，均需盖章且加盖骑缝章。
      2.确认结算单中的税率与发票一致、结算单的结算总金额与发票价税合计金额一致、以及购买方、销售方信息全面、正确。
      3.将发票（专用发票需有「抵扣联」与「发票联」 两联）与结算单一同进行邮寄。
      4.邮寄地址：
      ◦收件地址：北京市朝阳区朝阳北路 152 号时尚万科中心 1 层小邮局
      ◦收件人：字节小程序
      ◦联系电话：18310754223 （联系电话仅供收取结算单使用，请勿拨打）

    结算进度说明

    状态
    说明
    结算单确认状态
    【已确认】
      1.如果是电子签确认结算单，确认后更新为「已确认 电子签」 。
      2.如果是纸质结算单确认，平台接收到快递并一轮审核通过后，结算单状态更新为「已确认」 。
    审批状态
    审批状态会在票据签收后 3 个工作日更新。
    说明
    每月 10 日推送结算单后的 7 个工作日为高峰期，处理效率存在一定延迟。
    【审核中】：平台财务确认票据无误后会提交付款申请，通常需要 3 个工作日完成审核。
    【审核通过】：根据预期时间打款。
    【未提交审核】：通常为票据有误。若信息有误，一般会在确认退件信息后的 3 个工作日内安排退回，请参考退回时附带的说明重新开票或补齐材料。
    【空白】：未进入结算审批流程或票据退回。
    支付状态
    审批通过后，预计 3 个工作日内打款。
    【支付中】：付款申请已通过，银行处理中，预计 1-3 工作日完成打款。
    【已支付】：平台完成支付。
    【支付失败】：可通过抖音开放平台右下角【？】—【在线咨询】进行反馈。

    注意事项

      •各方需根据相关法律自行承担税费。除另有约定外，本规则项下支付款项均以人民币结算。
      •结算金额以合同约定公式计算为准，盖章的纸质结算单（公章）打印件 1 份即可，平台不提供盖章后回寄服务。
      •结算快递请勿使用到付。

    平台打款

    结算周期受第三方服务效率、系统对账及结算周期、银行转账时长、网络环境、系统环境等因素影响，如开发者不提供发票、提供不合格发票或不及时提供发票，平台有权不支付或相应延迟支付。
    “支付中”状态的款项当周（上周六 00:00 至本周五 24:00），放行的款项需在周日 24:00 前完成处理，具体到账时间取决于银行系统处理进度。
    ​

    第四步：费用开票流程

    小程序抖音钻石支付的交易中，若产生平台技术服务费或小程序推广计划服务费，开发者可开具包含上述费用的发票，并支持按月申请开票。详细规则见文档小程序发票说明。
    小程序推广计划服务费：
      •在小程序推广计划页面，若通过「星图账户」发布任务并产生相应的推广计划服务费项，则由星图平台提供开发者发票。
      •在小程序推广计划页面，若通过「开平账户」发布任务并产生相应的推广计划服务费项，则由抖音开放平台提供开发者发票。
    开票入口：开发者登录【抖音开放平台-右上角我的-发票管理-申请开票】，新增发票抬头后，可申请开票。
    开票费用核对示例图：

    常见问题

    更多请查看钻石兑换常见问题。

    收到“小程序钻石支付结算异常通知”的站内信如何处理？不处理会有什么后果

    答：点击站内信中提供的页面链接（如下图）开通抖音支付账户。如不开通，则会影响您的钻石支付结算单生成和整体结算进度。

    小程序推广计划相关费用和抖音开放平台技术服务费如何对账

    答：小程序推广计划相关费用可在：运营-推广-小程序推广计划-任务数据中查询相关任务消耗。
    抖音开放平台技术服务费可在「能力-支付-抖音钻石-收入结算单管理-详情」中查询小程序对应的技术服务费金额。

    开通时满足要求，若后续信用分等未达标会被取消能力吗

    已开通的能力不会取消，申请时满足条件即可。

    不在上述行业中的小程序想成为试点可以吗

    目前仅支持工具类和短剧类满足要求的小程序开通，未在上述两个行业中，敬请期待后续开放通知。

    哪些类目属于工具行业，哪些属于短剧类

    一级服务类目为【工具】的属于工具行业，短剧目前平台为定向准入，具体可咨询对接直客。

    属于这两个行业，但是不满足具体的条件怎么办

    申请开通前置条件系统会自动进行校验，可保持无违规记录和达到其他要求后再申请开通。
    ​