发起预扣费通知
接口说明
开发者可以使用该接口,在发起代扣前通知用户(预扣费通知)。
- 仅当签约单在服务中(SERVING)状态可发起代扣。
- 需要模板已配置预通知能力且抖音渠道签约的协议才可调用该接口进行预扣费通知。
- 为保证用户体验,避免打扰用户,每天仅在7:00-22:00的时间内可发起预扣费通知。
- 某些场景下,签约后立即调用预通知接口会返回32010错误码,开发者可识别该错误码,继续执行扣费。
- 支持传入预扣费的金额,传入的金额需不大于周期代扣模板上配置扣款的金额;并需要保证后续发起代扣的扣费金额不大于预通知时的金额。
- 如小程序有多个收款商户号,预通知时需要指定merchant_uid,且需要和发起代扣接口中传入的merchant_uid保持相同。
- 一次扣费前,预通知接口仅需调用一次,调用完成后,可于d+2到d+8日的7:00-22:00多次调用扣款接口进行扣费,直到扣费成功(如2025.01.01发起预通知,则可在2025.01.03-2025.01.09时间段内进行扣费)。
- 预通知成功后,在完成扣费前原则上不应该再次调用此接口,如继续调用字节服务端会直接返回,不会重复通知。
- 需要联系对接客服申请对应的测试模板进行预扣费通知测试,在开发者完成测试发布前,系统不会修改原有模板的扣费逻辑。因此建议开发者在系统中配置两条链路,链路A走原逻辑扣款,链路B走通知后扣款,当链路B经过充分测试并上线后,开发者可和客服沟通原有模板的切换时间节点,一旦抖音侧完成切换,对应模板会强制要求预通知后才可扣费,开发者也应及时将对应模板的扣费逻辑切换到链路B。
使用限制
无
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/trade_auth/v1/developer/pre_notify/ |
HTTP Method | POST |
Scope | trade_auth.developer.cycle |
权限要求 | 无 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例:application/json
固定值"application/json"
Body
amount