根据业务申请单号查签约信息

更新时间:2026.04.24
||
提示:本功能目前处于灰度测试阶段、暂未开放使用,待全量开放后将通过文档门户公告同步,感谢您的理解。

商户通过预签约接口生成预签约ID,当用户通过微信SDK拉起微信支付客户端的签约页面并完成签约后,可以通过预签约ID查询到对应的签约信息和用户openid

接口说明

支持商户:【平台商户】

请求方式:【GET】/v3/ecommerce/individual-contracts/out-contract-code/{out_contract_code}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


path  路径参数

 out_contract_code  必填   string(128)

【业务申请单号】 自定义的商户唯一编号,需保证服务商下唯一,仅允许包含英文半角的数字、字母、连接线-和下划线_。


query  查询参数

 appid  必填   string(32)

【签约和付款的AppID】 调用方的AppID,获取方式详见:服务商模式开发必要参数说明

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/ecommerce/individual-contracts/out-contract-code/APPLYMENT_00000000001?appid=wxd678efh567h23787 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数
折叠全部参数

200 OK

 individual_auth_id  选填   string(128)

【授权ID】 标识一个微信用户在该商户用于对应权限的微信支付账户,平台邀请微信用户完成个人授权后获得此ID,当用户用预签约ID完成签约后返回


 signed_time  必填   string

【签约时间】 遵循RFC3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。


 auth_state  必填   string

【授权状态】 授权状态枚举

可选取值

  • AUTHORIZED:  已授权

  • UNAUTHORIZED:  未授权


 individual_openid  选填   string

【用户OpenID】 个人收款方在平台appid下的唯一标识,当用户用预签约ID完成签约后返回


 real_name_auth_result  选填   object

【实名授权结果】 仅限预签约使用了需要实名授权/实名验证的接口时,才会返回此字段。

属性

 scope  必填   string

【应用授权作用域】 商户应用实际获得授权的类型,对应实名授权/实名验证文档中的应用授权作用域。


 access_token  必填   string

【访问令牌】 用户授权应用的接口调用凭证,用于进一步调用实名授权/实名校验接口。凭证在签约时由用户授权生成、不可刷新,请留意过期时间。过期后需要按照实名授权流程重新请求用户授权。


 access_token_expire_time  必填   string

【访问令牌过期时间】 实名授权访问令牌的过期时间。遵循RFC3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。

应答示例

200 OK

1{
2  "individual_auth_id" : "1900000109",
3  "signed_time" : "2018-06-08T10:34:56+08:00",
4  "auth_state" : "AUTHORIZED",
5  "individual_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
6  "real_name_auth_result" : {
7    "scope" : "pay_realname",
8    "access_token" : "Ca5sECXTwzkWYXs_do9ZaEeueqVHOtF-nXr51yNll2O97zqk9niwJnmSWxhDJELqoDDVFws6LCBbSulnEAaxCg==",
9    "access_token_expire_time" : "2018-06-08T10:34:56+08:00"
10  }
11}
12

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

元宝AI
反馈
目录
置顶