基础能力

触达与营销

支付

交易系统

担保支付（即将下线）

进件

支付

退款

结算及分账

退分账

提现

获取对账单

接口获取页面链接

订单推送

评价

抖店绑定

交易工具

运营

生活服务

垂直行业

其它

进件状态回调
收藏
我的收藏

将进件成功或失败的消息通知给开发者/服务商。

使用限制

无

接口说明

在小程序开发者平台上的担保支付平台设置页面中，填写回调相关配置。回调 token 与回调 url。该回调地址为必填项。开发者可以在请求中动态指定回调地址，动态指定地址会覆盖默认配置。

进件请求如果包含多个渠道，每个渠道进件成功或者失败都会回调通知开发者，可以通过回调通知中的channel参数来区分渠道。

进件状态请以status为准。

开发者服务端接收到异步通知时，必须通过验签（验证通知中的 msg_signature 参数）来确保支付通知是由抖音发送的。详细验签规则详见签名DEMO。

回调可能存在延时，若实时性要求高，开发者可以通过主动请求查询进件结果接口，感知进件结果。

在开发者服务端收到回调且处理成功后，需要按以下 json 返回表示处理成功，否则小程序服务端会认为通知失败进行重试。

{
  "err_no": 0,
  "err_tips": "success"
}

通知失败的重试时间间隔:15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h。

回调参数

名称	类型	是否必填	最大长度	描述	示例值
timestamp	string	是	12	Unix 秒级时间戳，字符串类型	1646398076
nonce	string	是	4	随机数	4353
msg	string	是	-	进件信息的 json 字符串	"msg": { "status": "SUCCESS", "channel": "hz", "uid": "70372492201318182840", "apply_time": "2022-03-04 21:10:15", "apply_id": "SMA202202212156514", "sub_status": "SUCCESS", "sub_fail_reason": "" }
type	string	是	32	回调类型标记，进件成功回调为"create_merchant"	create_merchant
msg_signature	string	是	128	详见签名DEMO	a0e96a41c3fe0bb81ef527f3fb2948dad2fb2616

msg 参数

名称	类型	是否必填	最大长度	描述	示例值
status	string	是	-	进件状态枚举，进件状态判断请以该字段为准 SUCCESS：成功 FAIL：失败	SUCCESS
channel	string	是	32	渠道枚举： wx: 微信渠道 alipay: 支付宝渠道 hz: 抖音支付渠道 yzt: 担保支付企业版聚合账户	hz
uid	string	是	64	商户号	70372492201318182840
apply_time	string	是	-	进件申请时间	2022-03-04 21:10:15
apply_id	string	是	128	申请单id	SMA202202212156514
sub_status	string	是	-	渠道进件状态，进件状态判断请以status字段为准 SUCCESS：成功 FAIL：失败	SUCCESS
sub_fail_reason	string	是	-	渠道失败原因	Business Failed:支付宝账号不存在
is_new	boolean	是	-	标识抖音信息和光合信号主体 true：光合信号 false：抖音信息	true
pay_info_status	string	条件选填	-	channel为yzt的场景下必填。担保支付企业版聚合账户的渠道状态信息，详见下面渠道进件状态参数	{\"wx\":\"SUCCESS\",\"alipay\":\"SUCCESS\",\"hz\":\"SUCCESS\"}

渠道进件状态

名称	类型	是否必填	最大长度	描述	示例值
wx	string	是	-	聚合账户渠道进件状态枚举: SUCCESS: 成功 FAIL: 失败	SUCCESS
alipay	string	是	-	聚合账户渠道进件状态枚举: SUCCESS: 成功 FAIL: 失败	SUCCESS
hz	string	是	-	聚合账户渠道进件状态枚举: SUCCESS: 成功 FAIL: 失败	SUCCESS

回调示例

{
  "msg": {
    "status": "SUCCESS",
    "channel": "hz",
    "uid": "70372492201318182840",
    "apply_time": "2022-03-04 21:10:15",
    "apply_id": "SMA202202212156514",
    "sub_status": "SUCCESS",
    "sub_fail_reason": "",
    "is_new": true
  },
  "msg_signature": "a0e96a41c3fe0bb81ef527f3fb2948dad2fb2616",
  "nonce": "5269",
  "timestamp": "1646399490",
  "type": "create_merchant"
}

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "success"
}

异常响应示例

{
  "err_no": 1000,
  "err_tips": "内部错误，请稍后重试"
}

进件状态回调收藏我的收藏