查询分账回退结果

开发环境

http://dev-cn.your-api-server.com

POST

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

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

基本信息

基本信息
HTTP URL	正式环境： https://developer.toutiao.com/api/apps/ecpay/v1/query_return沙盒环境： https://open-sandbox.douyin.com/api/apps/ecpay/v1/query_return
HTTP Method	POST
接口频次	50QPS(小程序 app_id 维度)

错误码

错误码err_no	描述	排查建议
0	success
1000	系统异常，请原单号重试	业务异常，请稍后使用原请求重试
2020	非法app_id	请检查请求参数然后重试
2102	回退单号长度必须在0-64之间	修改回退单号out_return_no后重试
4408	退分账记录不存在	检查传入的回退单号out_return_no或return_no是否正确

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

🟠400请求有误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/v1/query_return' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "app_id": "tt07e3715e98c9aac0",
  "return_no": "N7069590250007333000",
  "out_return_no": "7067781639492913452",
  "sign": "d98e6af1c490b36f7b72e2037f81a511",
  "thirdparty_id": "tta4bad2073b900000"
}'

响应示例

200 - 示例 1

{
    "err_no": 0,
    "err_tips": "string",
    "return_info": {
        "app_id": "string",
        "thirdparty_id": "string",
        "settle_no": "string",
        "out_settle_no": "string",
        "out_return_no": "string",
        "merchant_uid": "string",
        "return_amount": 0,
        "return_status": "string",
        "return_no": "string",
        "fail_reason": "string",
        "finish_time": 0,
        "cp_extra": "string"
    }
}

修改于 2023-12-05 02:07:11

发起退分账

商户余额查询

查询分账回退结果

基本信息#

错误码#

请求参数

返回响应

基本信息

错误码