进件状态查询
收藏
我的收藏

开发者/服务商可以通过接口主动查询进件结果。

使用限制

无

接口说明

进件状态查询的响应参数包含有企业版和普通版的字段信息，请根据具体支付解决方案选择相应的字段。

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/ecpay/saas/query_merchant_status
HTTP Method	POST
接口频次	40QPS(小程序app_id维度或thirdparty_id维度)

请求头

名称	类型	必填	描述
Content-Type	string	是	固定值 "application/json"

请求参数

名称	类型	是否必填	最大长度	描述	示例值
app_id	string	条件选填	64	小程序 AppID 在开发者模式下必填	ttdb96ad2b44aeff3301
thirdparty_id	string	条件选填	64	服务商第三方小程序应用id 在服务商模式下必填	ttc4a8b2155b82682f
merchant_id	string	是	128	抖音开放平台分配的商户号由发起进件请求接口返回	M69824283230789983130
sub_merchant_id	string	否	64	商户 id，用于接入方自行标识并管理进件方。对应发起进件请求接口送入的sub_merchant_id	69560302266147330860
sign	string	是	344	签名，详见签名DEMO	14784648abca76344b87135fe810247b

请求示例

json复制
{ 
  "app_id": "ttdb96ad2b44aeff3301",
  "sign": "c639b06f45e74c7b8025acbb45f04bb1",
  "merchant_id": "M69824283230789983130",
  "sub_merchant_id": "",
  "thirdparty_id": "ttc4a8b2155b82682f"
}

响应参数

公共响应参数

名称	类型	是否必填	最大长度	描述	示例值
err_no	number	是	-	返回码，详见错误码及错误描述	2008
err_tips	string	是	-	返回码描述，详见错误码及错误描述	签名校验异常，请使用正确的签名和 json 传参

业务响应参数

•

因进件存在普通版和企业版等版本，下面列出各版本的开发者需要关注字段，其它字段信息可以忽略

担保支付｜普通版

•

光合信号主体

名称	类型	是否必填	最大长度	描述	示例值
new_merchant_status_info	object	是	-	光合信号主体渠道进件信息以渠道名为key，详见下面渠道进件信息参数说明	参照示例

•

抖音信息主体

名称	类型	是否必填	最大长度	描述	示例值
merchant_status_info	object	是	-	抖音信息主体渠道进件信息以渠道名为key，详见下面渠道进件信息参数	参照示例

担保支付｜企业版

名称	类型	是否必填	最大长度	描述	示例值
pay_status_info	object	是	-	担保支付企业版聚合账户支付方式的渠道信息以渠道名为key，详见下面渠道进件信息参数	参照示例

渠道进件信息参数

名称	类型	是否必填	最大长度	描述	示例值
alipay	object	条件选填	-	支付宝进件状态信息，详见下面渠道进件状态信息参数	参照下面示例
hz	object	条件选填		抖音支付进件状态信息，详见下面渠道进件状态信息参数	参照下面示例
wx	object	条件选填		微信进件状态信息，详见下面渠道进件状态信息参数	参照下面示例

渠道进件状态信息参数

名称	类型	是否必填	最大长度	描述	示例值
status	string	是	-	进件状态枚举，以下状态枚举各渠道通用： •SUCCESS：成功 •FAIL：失败 •PROCESSING 受理中以下状态枚举仅微信渠道包含： •WX_CHECKING 微信：审核中 •WX_TO_VALID 微信：待认证 •WX_TO_SIGN 微信：待签约 •WX_FROZEN 微信：冻结	SUCCESS
reject_reason	string	是	256	失败原因	Business Failed:支付宝账号不存在
legal_validation_url	string	是	256	法人验证链接，进件状态待认证下发，其他状态为空字符串	http://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=xxxx&sign=xxxx
legal_sign_url	string	是	256	签约链接，进件状态待签约下发，其他状态为空字符串	https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=xxxx&sign=xxxx
merchant_id	string	是	64	商户号	70372492201318182840

响应示例

正常响应示例

json复制
{
    "err_no": 0,
    "err_tips": "",
    "merchant_status_info": {
        "alipay": {
            "status": "SUCCESS",
            "reject_reason": "",
            "legal_validation_url": "",
            "legal_sign_url": "",
            "merchant_id": "M69824283230789983130"
        },
        "hz": {
            "status": "PROCESSING",
            "reject_reason": "",
            "legal_validation_url": "",
            "legal_sign_url": "",
            "merchant_id": "M69824283230789983130"
        },
        "wx": {
            "status": "SUCCESS",
            "reject_reason": "",
            "legal_validation_url": "",
            "legal_sign_url": "",
            "merchant_id": "M69824283230789983130"
        }
    },
    "new_merchant_status_info": {
        "alipay": {
            "status": "SUCCESS",
            "reject_reason": "",
            "legal_validation_url": "",
            "legal_sign_url": "",
            "merchant_id": "69824283230789983130"
        },
        "hz": {
            "status": "PROCESSING",
            "reject_reason": "",
            "legal_validation_url": "",
            "legal_sign_url": "",
            "merchant_id": "69824283230789983130"
        },
        "wx": {
            "status": "SUCCESS",
            "reject_reason": "",
            "legal_validation_url": "",
            "legal_sign_url": "",
            "merchant_id": "69824283230789983130"
        }
    }
}

服务商查询自己的合作方，参数需传入 sign、sub_merchant_id 以及 thirdparty_id，具体实例如下：

请求

json复制
{ 
  "app_id": "",
  "sign": "14784648abca76344b87135fe810247b",
  "merchant_id": "",
  "sub_merchant_id": "69560302266147330860",
  "thirdparty_id": "ttd74ca1f148667a24"
}

响应

json复制
{ 
  "err_no": 0,
  "err_tips": "",
  "merchant_status_info": {
    "alipay": {
      "status": "SUCCESS",
      "reject_reason": "",
      "legal_validation_url": "",
      "legal_sign_url": "",
      "merchant_id": "xxxxx"
    },
    "hz": {
      "status": "PROCESSING",
      "reject_reason": "",
      "legal_validation_url": "",
      "legal_sign_url": "",
      "merchant_id": "xxxxx"
    },
    "wx": {
      "status": "SUCCESS",
      "reject_reason": "",
      "legal_validation_url": "",
      "legal_sign_url": "",
      "merchant_id": "xxxxx"
    }
  }
}

服务商查询小程序收款商户及合作方，参数需传入 app_id、sign、merchant_id 以及 thirdparty_id，具体实例如下：

请求

json复制
{ 
  "app_id": "ttdb96ad2b44aeff3301",
  "sign": "c639b06f45e74c7b8025acbb45f04bb1",
  "merchant_id": "M69824283230789983130",
  "sub_merchant_id": "",
  "thirdparty_id": "ttc4a8b2155b82682f"
}

响应

json复制
{ 
  "err_no": 0,
  "err_tips": "",
  "merchant_status_info": {
    "alipay": {
      "status": "SUCCESS",
      "reject_reason": "",
      "legal_validation_url": "",
      "legal_sign_url": "",
      "merchant_id": "M69824283230789983130"
    },
    "hz": {
      "status": "PROCESSING",
      "reject_reason": "",
      "legal_validation_url": "",
      "legal_sign_url": "",
      "merchant_id": "M69824283230789983130"
    },
    "wx": {
      "status": "SUCCESS",
      "reject_reason": "",
      "legal_validation_url": "",
      "legal_sign_url": "",
      "merchant_id": "M69824283230789983130"
    }
  }
}

异常响应示例

json复制
{ 
  "err_no": 2008,
  "err_tips": "签名校验异常，请使用正确的签名和 json 传参",
  "wx": 0,
  "alipay": 0
}

错误码

错误码 err_no	描述 err_tips	排查建议
0	成功
1	服务商无对应小程序分账授权	请检查服务商是否有小程序授权权限
2	网络异常，请稍后重试	网络错误，稍后原参数重试
1000	内部错误	系统异常，请使用相同参数稍后重试
1005	频率控制	请降低调用频率
1006	post 请求使用 json 传参	请检查请求头参数
1091	功能暂不支持	功能暂不支持
2008	验签异常	请检查参数，详见签名DEMO
2010	业务参数处理异常	检查请求参数，修改后重试
4000	商户号和小程序/应用ID不对应	检查请求参数，修改后重试
4002	有效信息不足，请再次输入	有效信息不足，请再次输入