通用场景
主要用在isv代理商户签约场景，用来查询商户签约某个产品的签约状态，可以配合"第三方接入核心api"功能包里的接口使用
公共请求参数
业务请求参数
pid必选string(128)
【描述】isv要查询签约状态的商户账号，可以是支付宝账号pid（2088开头），也可以是商户的登录账号（邮箱或手机号）
【示例值】支付宝账号：2088123451234543或手机号：13811111111或邮箱：123@xxx.com
product_codes必选string[](256)
【描述】isv要查询商户签约状态的产品码，产品码是支付宝内部对产品的唯一标识。目前支持查询产品及产品码详情参见 https://opendocs.alipay.com/isv/01cv77#能力产品码 。
【示例值】i1011000100000000001
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayopenagentsignstatusqueryrequest request = new alipayopenagentsignstatusqueryrequest();
request.setbizcontent("{"
" \"pid\":\"支付宝账号：2088123451234543或手机号：13811111111或邮箱：123@xxx.com\","
" \"product_codes\":["
" \"i1011000100000000001\""
" ]"
"}");
alipayopenagentsignstatusqueryresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}说明：本示例仅供参考。
公共响应参数
业务响应参数
sign_status_list必选productsignstatusinfo[]
【描述】商户产品签约状态结果对象数组，返回本次查询的产品的签约状态
product_name必选string(32)
【描述】产品名称
【示例值】当面付收单
product_code必选string(32)
【描述】产品编码
【示例值】face_to_face_payment
status必选string(32)
【描述】none:未签约，表示还没有签约该产品
valid:已生效，表示合约已经生效，不需要再签约了
restrictvalid:受限生效，表示合约已经生效，但是资料不全，功能受限
audit:审核中，已经有合约在审核中，请等待审核完成
waitconfirm:待商户确认协议，合约已经审核通过，需要商户确认后合约才生效
auditreject:审核未通过
invalid:合约失效，曾经签过合约，但已经失效了，可以重新发起签约
restrictinvalid:受限失效，受限合约失效了
【示例值】none|valid|restrictvalid|audit|waitconfirm|auditreject|invalid|restrictinvalid
响应示例
正常示例
异常示例
{
"alipay_open_agent_signstatus_query_response": {
"code": "10000",
"msg": "success",
"sign_status_list": [
{
"product_name": "当面付收单",
"product_code": "face_to_face_payment",
"status": "none|valid|restrictvalid|audit|waitconfirm|auditreject|invalid|restrictinvalid"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| invalid_parameter | 参数有误参数有误 | 检查必填参数是否为空，或者长度是否超限 |
| query_sign_status_auth_not_match | 应用授权信息和要查询的商户信息不匹配 | 请检查应用授权token和要查询签约状态的商户是否匹配 |
| query_sign_status_not_auth | 接口自调用时不允许查询其它商户的签约状态 | 接口自调用时只能查询自己的签约状态，要查询其他商户的签约状态，请先让商户进行应用授权，再使用代理方式调用 |
| invalid_parameter | 参数有误参数有误 | 请检查参数是否有误 |
| merchant_is_not_exist | 商家支付宝账号不存在 | 请确认商家支付宝账号存在、正确且有效 |
| system_error | 系统繁忙 | 系统异常，请联系凯发app官方网站的技术支持 |