• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 交易系统
  • 担保支付(即将下线)
  • 进件
  • 发起进件请求
  • 图片上传接口
  • 进件状态查询
  • 进件状态回调
  • 支付
  • 退款
  • 结算及分账
  • 退分账
  • 提现
  • 获取对账单
  • 接口获取页面链接
  • 订单推送
  • 评价
  • 抖店绑定
  • 交易工具
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 开发者/服务商可以通过接口主动查询进件结果。

    使用限制

    接口说明

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

    基本信息

    基本信息
    HTTP URL
    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

    请求示例

    { "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
    法人验证链接,进件状态待认证下发,其他状态为空字符串
    legal_sign_url
    string
    256
    签约链接,进件状态待签约下发,其他状态为空字符串
    merchant_id
    string
    64
    商户号
    70372492201318182840

    响应示例

    正常响应示例

    { "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,具体实例如下:
    请求
    { "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
    有效信息不足,请再次输入
    有效信息不足,请再次输入