开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

查询分账回退结果

接口功能描述:开发者/服务商可以通过接口主动查询退分账订单状态。

请求URL

https://developer.toutiao.com/api/apps/ecpay/v1/query_return

请求方式

POST

接口频次

50QPS(小程序 app_id 维度)

参数

类型

必填

描述

Content-Type

string

固定值 "application/json"

请求参数

参数

类型

是否必填

最大长度

字段描述

示例值

app_id

string

64

小程序APPID

tt07e3715e98c9aac0

thirdparty_id

string

条件选填

64

第三方平台服务商id,服务商模式接入必传,非服务商模式留空

tta4bad2073b900000

return_no

string

64

小程序回退单号

7069590250007333000

out_return_no

string

64

开发者回退单号

7056505317450041644

sign

string

344

签名,详见地址

d98e6af1c490b36f7b72e2037f81a511

{
  "app_id": "tt07e3715e98c9aac0",
  "return_no": "7069590250007333000",
  "out_return_no": "7067781639492913452",
  "sign": "d98e6af1c490b36f7b72e2037f81a511",
  "thirdparty_id": "tta4bad2073b900000"
}

参数

类型

是否必填

最大长度

字段描述

示例值

err_no

number

-

详见错误码

0

err_tips

string

-

详见错误提示信息

成功

参数

类型

是否必填

最大长度

字段描述

示例值

return_info

returnInfo

-

分账回退基本信息

-

其中 return_info 包含如下的字段:

参数

类型

是否必填

最大长度

字段描述

示例

app_id

string

64

小程序APPID

tt07e3715e98c9aac0

settle_no

string

64

平台分账单号

7067781639492913452

out_settle_no

string

64

商户分账单号

test_settle_2004

out_return_no

string

64

商户回退单号

7056505317450041644

merchant_uid

string

32

回退商户号

XCXP_000003089

amount

number

[1,99999999999]

回退金额

100,即1元

return_no

string

64

平台回退单号

7069590250007333000

status

string

-

回退状态枚举值:

SUCCESS:成功

FAIL:失败

PROCESSING:处理中

注意:如果返回为处理中,请勿变更商户回退单号,使用相同的参数再次发起分账回退,否则会出现资金风险 在处理中状态的回退单如果5天没有成功,会因为超时被设置为已失败

SUCCESS

fail_reason

string

100

回退失败的原因,此字段仅回退结果为FAIL时存在

退分账记录不存在

finish_time

number

10

回退完成时间,Unix 时间戳,10 位,整型数,秒级

1644399124

{
  "err_no": 0,
  "err_tips": "",
  "return_info": {
    "CpExtra": "",
    "FailReason": "SUCCESS",
    "FinishTime": 1647332403,
    "MaAppID": "ttcfdbb96650e33350",
    "MerchantUID": "XCXP_000003087",
    "OutReturnNo": "ttcfdbb96650e33350",
    "OutSettleNo": "ot_settle_7067682742942583084_2",
    "ReturnAmount": 1,
    "ReturnNo": "7075228873218099500",
    "ReturnStatus": "SUCCESS",
    "SettleNo": "7075237473193855276",
    "ThirdpartyID": "tta4bad2073b9009c7"
  }
}
{
  "err_no": 2020,
  "err_tips": "非法app_id",
  "return_info": {}
}
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助