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

    一、能力接入

    能力申请问题

    Q1:如何开通钻石能力?

    Q2:小程序后台没有抖音钻石支付页面,为什么?

    目前仅针对部分行业(工具短剧)开放。
    注意
    工具-营销工具-互动营销工具-娱乐工具-答题/解密/测评暂未开放。

    Q3:页面提示不满足钻石支付开通条件,为什么不满足?如何查询?

    工具行业

    工具开通要求
    核实路径
    完成 ICP 备案
    控制台 > 设置 > 备案信息,备案成功并获取备案号。
      交易订单 ≥ 1 笔
      2.查看交易记录:控制台 > 能力 > 支付 > 账单管理 > 交易记录查询,产生成功交易订单 ≥ 1 笔。
    注意
    超时未支付的不属于成功交易订单。
    完成试运营阶段(新手村阶段暂不支持)
    控制台 > 总览 > 基本信息 > 小程序状态正式运营)。
    注意
    显示为「试运营」则暂不支持接入。
    上架时间 ≥ 90 天
    控制台 > 开发 > 版本管理 > 版本日志 > 发布时间,小程序最早版本的发布时间是否 ≥ 90 天。
    无过高投诉率
    信用分 ≥ 80 分
    控制台 > 健康 > 健康概览 > 小程序信用分。
    完成试运营阶段如无违规行为,且信用分均可达到 80 分。
    无严重违规处置记录
    封禁记录:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有封禁记录。
    主体封禁记录:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有封禁记录。
    支付能力封禁:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有支付封禁记录。
    说明
    主动关闭支付方式不属于封禁范围。
    违规处置下架:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有被平台下架记录。
    说明
    主动下架不属于违规处置。
    开发者主体无严重违规处置记录
    查看开发者对应主体下所有小程序是否有违规处罚记录,如有则不满足开通条件。
    在开发者对应主体下所有小程序的站内信或控制台 > 健康 > 违规记录查看历史记录。
    无侵权成立记录
    侵权投诉 > 投诉我的是否有收到投诉成功的投诉单记录,如有记录则不符合开通条件。

    短剧行业

    短剧开通要求
    核实路径
    通过定向准入
    小程序可选择「文娱-文娱-微短剧」类目。
    说明
    当前「文娱-文娱-微短剧」为定向邀约
    满足短剧类小程序运营规范
    完成 ICP 备案
    控制台 > 设置 > 备案信息,备案成功并获取备案号。
    小程序内的短剧符合广电监管部门关于短剧内容的监管要求
      交易订单 ≥ 1 笔
      2.查看交易记录:控制台 > 能力 > 支付 > 账单管理 > 交易记录查询,产生成功交易订单 ≥ 1 笔。
    注意
    超时未支付的不属于成功交易订单。
    完成试运营阶段(新手村阶段暂不支持)
    控制台 > 总览 > 基本信息 > 小程序状态正式运营)。
    注意
    显示为「试运营」则暂不支持接入。
    无过高投诉率
    无严重违规处置记录
    封禁记录:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有封禁记录。
    主体封禁记录:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有封禁记录。
    支付能力封禁:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有支付封禁记录。
    说明
    主动关闭支付方式不属于封禁范围。
    违规处置下架:可通过站内信或控制台 > 健康 > 违规记录查看历史是否有被平台下架记录。
    说明
    主动下架不属于违规处置。
    开发者主体无严重违规处置记录
    查看开发者对应主体下所有小程序是否有违规处罚记录,如有则不满足开通条件。
    在开发者对应主体下所有小程序的站内信或控制台 > 健康 > 违规记录查看历史记录。
    无侵权成立记录
    侵权投诉 > 投诉我的是否有收到投诉成功的投诉单记录,如有记录则不符合开通条件。

    结算账户问题

    Q1:能力申请后一直审核中或提示“开发者资质账户状态异常”,如何处理?

      短剧行业:一般常见“开发者资质账户状态异常”状态,小程序主体认证过期导致,检查小程序主体对公认证是否过期,过期后重新对公认证即可,右上角账号-账户中心-资质认证位置。
      工具行业:一般常见“审核中”状态,申请后需审核预计 5-7 个工作日,同时也请同步检查小程序主体对公认证是否过期。

    Q2:抖音支付账户开通的用途是什么?我需要开通吗?与手续费账户区别?

    开通抖音支付账户主要用于结算时产生的技术服务费以及小程序推广计划中的相关费用
    若产生上述相关费用且未开通此账户,将影响开发者正常结算,结算时会提示开通抖音支付账户。
    抖音支付账户只针对钻石支付场景的支付订单产生的技术服务费和小程序推广计划相关费用使用的账户,手续费账户针对非钻石支付产生的订单收支分离使用,分账时产生的平台费用部分(包括支付手续费、CPS 达人抽佣、平台抽佣等)全部从手续费账户中抽取。

    Q3:钻石支付的结算账户想要修改其他主体,无法修改?

    目前抖音钻石支付能力依据小程序维度开通,不支持修改其他主体,系统自动默认为小程序主体。

    Q4:钻石支付的抖音支付账户商户信息想修改其他主体,无法修改?

    不支持修改其他主体,系统自动默认为小程序主体。

    Q5:抖音支付账户中信息填写错误需要修改,可以修改吗?

    目前不支持修改,信息错误不影响钻石兑换的使用,也不影响收入结算。

    Q6:用户税目&税率上传什么材料,没有开过发票提交什么?

    小程序主体历史任何渠道开过的发票样本图片(1 张即可),展示税目&税率。如果没开过发票,可提交未开过发票相关说明。

    Q7:结算账户中税率和结算账户信息填写谁的信息?

    税率和账户信息填写小程序开发者信息即可,结算账户信息主要用于开具发票结算金额使用。

    Q8:发票是谁开具,给谁开?

    发票由小程序主体开具,提供给抖音开放平台,平台进行金额结算给开发者。

    Q9:用户用钻石支付购买了小程序提供的商品,可以开发票吗,发票由谁开具?

    用户充值钻石支持开具发票,在抖音 App -钱包-钻石-开票选项中开具,无需小程序开发者进行开票,用户消耗的钻石不支持开票。

    Q10:小程序有多个商户号影响钻石支付开通吗?

    不影响,原进件的商户信息与钻石支付不相关,钻石支付结算给开通的结算账户中。

    Q11:结算退件信息一定需要填写吗?

    必填项,开发者结算件可能存在票据错误、缺失、信息不明确、重复寄送等情况、避免影响结算,在【退件地址】中准确填写你的退件信息,以便平台及时退回。

    Q12:短剧小程序开通钻石时提示绑定星图账户?

    需要绑定与小程序主体一致的星图账户。

    Q13:支持电子发票功能吗?

    支持,核对结算单信息无误后 CA 确认结算单,上传电子发票等待结算即可。

    二、能力使用

    充值结算问题

    Q1:钻石收入每个月如何结算,抖音支付账户服务费可以开发票吗?

    上月 20 日至本月 19 日为一整个结算周期。在结算周期内,平台会统计结算周期内开发者应获得的收入,并生成对应的结算单。开发者可以根据结算单中的「结算总金额」给平台开具发票,将发票递交给平台审核后,平台进行结算。
    抖音支付账户中产生的服务费由平台给开发者开票,具体可参考开票流程,开票位置:抖音开放平台-右上角我的-发票管理-开票信息。

    Q2:钻石和现金的兑换比例是多少?

    固定兑换比为钻石:现金 = 10:1,且钻石为整数,最小是 1 颗钻石,因此现金只能有一位小数。如 1 颗钻石最小现金是 0.1,商品可自主定价。

    Q3:用户充值了多少钻石可以获取到吗?

    无法获取到用户充值了多少钻石,用户购买通过消耗钻石,平台将实际收入(消耗钻石)通过接口回调同步给开发者,最终结算金额以消耗钻石为准。根据上述 Q1 中钻石现金兑换比,如 29.9 元对应 299 钻,支付面板显示 299 钻即可。

    Q4:结算金额如何计算?

    开发者应得收益 = (订单净额 × 99% -呆坏账) × (1 + 开发者开具发票的增值税税率) / 1.06
    案例
    开发者应得收益
    100 钻石大概可以结算多少人民币
    如用户消耗了 100 钻石(非充值购买 100 钻石),且无退款和呆坏账无服务费,增值税率 1% 情况下,收益如下:
    收益:(100 × 99%) × (1 + 1%) / 1.06 = 94.33
    用户花 12 元购买了 84 个钻石,支付订单花费了 66 个钻石
      用户消耗 66 个钻石,且无退款和呆坏账无服务费,增值税税率 3% 情况下,收益如下:
        收益:(66 × 99%) × (1+3%) / 1.06 = 63.49
      用户消耗 66 个钻石,无呆坏账,退 33 个钻石,增值税税率 3% 情况下,收益如下:
        收益:((66 - 33)× 99%) × (1+3%) / 1.06 = 31.74
    用户可使用 10 个钻石,实际又充值 14 个钻石,那么开发者实际到账金额是多少?
    最终看用户消耗多少钻石,如共消耗 24 个钻石,且无退款和呆坏账无服务费,增值税税率 6% 情况下,收益如下:
    收益:(24 × 99%) × (1 + 6%) / 1.06 = 23.76
    我们8月份支付钻石数量 1 万个,那么9月份给我们结算多少钱呢
    消耗 1 万个钻石,且无退款和呆坏账无服务费,增值税税率 3% 情况下,收益如下:
    收益:(10000 × 99%) × (1 + 3%) / 1.06 = 9619.81
    用户1块钱可以充 7 个钻石,钻石支付给我们的小程序商户后,如果不考虑服务费,我们可以兑换成多少钱啊?
    消耗 7 个钻石,且无退款和呆坏账无服务费,增值税税率 3% 情况下,收益如下:
    收益:(7 × 99%) × (1 + 3%) / 1.06 = 6.73
    用户用了 299 个钻石,服务费总计 12 元,撮合佣金 30 元,行业佣金 20 元,结算多少钱?
    消耗 299 个钻石,无退款和呆坏账,增值税税率 3% 情况下,收益如下:
    收益:(299 × 99% - 12) × (1 + 3%) / 1.06 - 30 - 20 = 225.97

    Q5:钻石怎么设置单位,支付面板需要调整吗?

    钻石兑换 currency 字段统一传 DIAMOND 时,调用接口下单时需要自行换算成钻石数量,支付面板调整为钻石。

    Q6:什么是呆坏账?

      1.超过退款周期,因各种原因,向用户退还抖音钻石对应的人民币金额。
      2.不论是否在退款周期,因各种原因,微播及/或其关联方向用户进行现金退款产生的所有成本(含 iOS 渠道费率、税费、手续费等);各种原因包括但不限于「iOS渠道单方核准的退款」、「未成年人退款」、「经司法/行政主管部门要求的退款」、「任何一方综合考虑用户体验/舆论影响等因素而决定的退款」和「用户未能成功支付到账的款项」。

    Q7:技术服务费是多少?

    1%。

    Q8:IOS 用户的那 30% 是我们自己承担么?还是用户承担呀?需要给用户开票吗?

    由用户承担,无需开发者开票和承担。
    Q9:钻石兑换的回调需要增加商户信息吗(merchant_uid 字段)
    钻石兑换的回调中无需增加商户 ID(merchant_uid 字段)。

    Q10:钻石充值上限是多少?

    单笔上限 5,000 钻石(500 人民币)。

    Q11:钻石订单支付失败?

    建议优先排查 tt.getOrderPayment 是否存在重复调用的情况,同时间只能调用一次该 API。

    Q12:结算单开票以哪个金额为准?

    总金额 = 应结金额 + 已结金额
      应结金额:银行卡实际收款金额
      已结金额:开发者星图账户中,平台向开发者账户(星图账户)结算了的金额。

    退款问题

    Q1:退款退的是钻石还是现金?

    退钻石。

    Q2:超过退款周期的怎么处理?

    发起退款的 API 接口支持支付 7 日内退回。如有超过 7 日的钻石退回,可以走线下或者请联系平台运营申请原路退。

    Q3:用户要退现金怎么办?

    平台支持退钻石,退现金可引导用户咨询抖音 App 客服钻石转现金。

    Q4:退款支持部分退吗?

    支持部分退。

    Q5:开发者对账接口可以对账吗?

    目前可以通过获取交易账单接口获取钻石交易账单信息。
    商户号传入 null 即可获取钻石订单,其中退款订单因存在两种形式(系统退款和强制退款)。在对账时系统退款订单支付费用原路退,强制退款金额从结算单进行扣减。

    错误码

    报错
    原因
    错误码:21050 errMsg:"requestOrder:fail
    当前订单不支持该场景下单
      1.开发者指定商户号的主体与钻石主体不一致。
      2.能力使用方式错误,请自查。
      3.【特殊情况】如果出现大批量报错,则能力被处置,需要改造能力。
      a.违规原因:现金支付能力封禁。
      b.违规话术:开发者你好,你的小程序 xxx 涉嫌违规,原因为:小程序出现 iOS 虚拟支付违规行为,不符合平台相关规范。现已封禁现金支付能力。
      c.解决方式:可以查看小程序的站内信或者「控制台 > 健康 > 违规记录」来定位违规情况,尽快完成能力整改后提审(请参考短剧类小程序 iOS 虚拟支付规范说明进行修改),整改审核通过后,通过申诉路径「控制台 > 健康 > 违规记录」申诉,申诉通过后即可解除处置。
    注意
    请谨慎使用申诉能力,在确认完成能力整改后(含错误码问题解决),再行推进能力申诉,若申诉失败,24小时后才可继续申诉。
    错误码:10000 errMsg:"requestOrder:fai
    不支持的支付场景
    PayScene 传空值即可
    错误码:26003 errMsg:"requestOrder:fail
    无下单权限
    未指定钻石路径下单

    三、审核问题

    Q1:【发版审核】小程序未接入钻石兑换,请参考短剧类小程序 iOS 虚拟支付规范说明进行修改

    开发者按照规范接入钻石兑换请参考小程序钻石兑换接入指南完成能力接入,并符合短剧类小程序 iOS 虚拟支付规范说明

    Q2:【发版审核】基于抖音开放平台运营规范,短剧类小程序在 iOS 系统中提供的商品和服务须通过抖音钻石兑换实现虚拟支付。其他直接通过非抖音钻石的方式发起交易,或者间接引导至外部第三方网页或 App 发起支付均属于 iOS 虚拟支付违规行为,具体内容可参考短剧类小程序 iOS 虚拟支付规范说明。

    能力接入不符合规范,需重新调整接入规则并通过审核。
    注意
    其他直接通过非抖音钻石的方式发起交易,或者间接引导至外部第三方网页或 App 发起支付均属于 iOS 虚拟支付违规行为,需符合短剧类小程序 iOS 虚拟支付规范说明