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

进件状态查询

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

注意事项

  1. 如果进件接口没有返回 merchan_id,可以使用原参数重新进件。

接口地址

请求URL

https://developer.toutiao.com/api/apps/ecpay/saas/query_merchant_status

请求方式

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

小程序平台分配商户号

69824283230789983130

sub_merchant_id

string

64

商户 id,用于接入方自行标识并管理进件方。由服务商自行分配管理

69560302266147330860

sign

string

344

签名,详见签名DEMO

14784648abca76344b87135fe810247b

请求示例

{
  "app_id": "ttdb96ad2b44aeff3301",
  "sign": "c639b06f45e74c7b8025acbb45f04bb1",
  "merchant_id": "69824283230789983130",
  "sub_merchant_id": "",
  "thirdparty_id": "ttc4a8b2155b82682f"
}

响应参数

公共响应参数

参数

类型

是否必填

最大长度

描述

示例值

err_no

number

-

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

2008

err_tips

string

-

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

签名校验异常,请使用正确的签名和 json 传参

业务响应参数

参数

类型

是否必填

最大长度

描述

示例值

wx

number

-

微信渠道进件状态枚举值

0: 未进件

1: 进件成功

2: 进件失败

3: 审核中

4: 冻结中

1

alipay

number

-

支付宝渠道进件状态枚举值

0: 未进件

1: 进件成功

2: 进件失败

3: 审核中

1

hz

number

-

抖音支付(合众)渠道进件状态枚举值

0: 未进件

1: 进件成功

2: 进件失败

3: 审核中

1

merchant_status_info

map<string,MerchantStatusInfo>

-

渠道状态信息

以渠道名为key

参照示例

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "",
  "wx": 1,
  "alipay": 1,
  "hz": 0,
  "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"
    }
  },
  "yeepay": 0
}

异常响应示例

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

错误码

err_no

err_tips

解决方案

0

成功


1000

内部错误

系统异常,请使用相同参数稍后重试

1004

未知异常

请原参数重试

2008

验签异常

请检查参数,详见验签异常DEMO

1005

频率控制

请降低调用频率

2010

参数错误: 参数MerchantType不正确

请使用正确的参数重新调用

参数错误: 进件渠道为空

参数错误: 未知类型(Invalid Type)

参数错误:maAppID或者sub_merchant_id为空

参数错误:thirdPartyID为空

参数错误:thirdPartyID或maAppID或sub_merchant_id为空

参数错误:thirdPartyID或sub_merchant_id为空

参数错误: 参数:MerchantName 为空

参数错误: 参数:MerchantShortName 为空

参数错误: 没有合众营业执照

参数错误: 没有微信营业执照

参数错误: 没有支付宝营业执照

参数错误: 营业执照有效期起止时间错误

参数错误: 进件微信、合众或者进件支付宝且支付宝结算类型为银行卡时,开户银行不可为空

参数错误: 参数:店铺名称 为空

参数错误: 参数:店铺链接 为空

参数错误: 参数:签约的支付宝账户 为空

参数错误: 参数:OutOrderId 为空

参数错误:当管理员类型为法人时,管理员姓名和身份证号需要和法人的姓名和身份证号一致

7001

存在流程进行中的申请单或者已经进件成功

可通过查询申请单状态查看此申请单的申请状态,或更换business_code提交新的申请单

7002

申请单不存在

确认入参,传入正确的申请单编号

7003

商户重复入驻

商户更换文件后,重新调用

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助