进件状态查询

开发者/服务商可以通过接口主动查询进件结果。
进件状态查询的响应参数包含有企业版和普通版的字段信息，请根据具体支付解决方案选择相应的字段。
接口频次
40QPS(小程序app_id维度或thirdparty_id维度)

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

请求

{

"app_id": "",

"sign": "14784648abca76344b87135fe810247b",

"merchant_id": "",

"sub_merchant_id": "69560302266147330860",

"thirdparty_id": "ttd74ca1f148667a24"

}

响应

{

"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，具体实例如下：

请求

{

"app_id": "ttdb96ad2b44aeff3301",

"sign": "c639b06f45e74c7b8025acbb45f04bb1",

"merchant_id": "M69824283230789983130",

"sub_merchant_id": "",

"thirdparty_id": "ttc4a8b2155b82682f"

}

响应

{

"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"

}

异常响应示例

{

"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	有效信息不足，请再次输入	有效信息不足，请再次输入

curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/saas/query_merchant_status' \ --header 'Content-Type: application/json' \ --data-raw '{ "app_id": "ttdb96ad2b44aeff3301", "sign": "c639b06f45e74c7b8025acbb45f04bb1", "merchant_id": "M69824283230789983130", "sub_merchant_id": "", "thirdparty_id": "ttc4a8b2155b82682f" }'

{ "err_no": 0, "err_tips": "string", "merchant_status_info": { "alipay": { "status": "string", "reject_reason": "string", "legal_validation_url": "string", "legal_sign_url": "string", "merchant_id": "string" }, "hz": { "status": "string", "reject_reason": "string", "legal_validation_url": "string", "legal_sign_url": "string", "merchant_id": "string" }, "wx": { "status": "string", "reject_reason": "string", "legal_validation_url": "string", "legal_sign_url": "string", "merchant_id": "string" } }, "new_merchant_status_info": { "alipay": { "status": "string", "reject_reason": "string", "legal_validation_url": "string", "legal_sign_url": "string", "merchant_id": "string" }, "hz": { "status": "string", "reject_reason": "string", "legal_validation_url": "string", "legal_sign_url": "string", "merchant_id": "string" }, "wx": { "status": "string", "reject_reason": "string", "legal_validation_url": "string", "legal_sign_url": "string", "merchant_id": "string" } } }

请求参数

Header 参数

Content-Type

string

必需

Body 参数application/json

app_id

string

可选

小程序 AppID 在开发者模式下必填

sign

string

必需

签名，详见签名DEMO

merchant_id

string

必需

服务商第三方小程序应用id 在服务商模式下必填

sub_merchant_id

string

必需

商户 id，用于接入方自行标识并管理进件方。对应发起进件请求接口送入的sub_merchant_id

thirdparty_id

string

可选

服务商第三方小程序应用id 在服务商模式下必填

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

返回码，详见错误码及错误描述

err_tips

string

必需

返回码描述，详见错误码及错误描述

merchant_status_info

object

必需

光合信号主体渠道进件信息以渠道名为key，详见下面渠道进件信息参数说明

alipay

object

可选

支付宝进件状态信息，详见下面渠道进件状态信息参数

object

可选

抖音支付进件状态信息，详见下面渠道进件状态信息参数

object

可选

微信进件状态信息，详见下面渠道进件状态信息参数

new_merchant_status_info

object

必需

以渠道名为key，详见下面渠道进件信息参数

alipay

object

必需

object

必需

object

必需

进件状态查询

异常响应示例#

错误码#

请求参数

返回响应

异常响应示例

错误码