接口说明
接口英文名称：alipay.open.agent.signstatus.query
请求url：https://openapi.alipay.com/v3/alipay/open/agent/signstatus/query
请求方式：post
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
通用场景
主要用在isv代理商户签约场景，用来查询商户签约某个产品的签约状态，可以配合"第三方接入核心api"功能包里的接口使用
公共请求参数
业务请求参数
body参数
pid必选string(128)
【描述】isv要查询签约状态的商户账号，可以是支付宝账号pid（2088开头），也可以是商户的登录账号（邮箱或手机号）
【示例值】支付宝账号：2088123451234543或手机号：13811111111或邮箱：123@xxx.com
product_codes必选string[](256)
【描述】isv要查询商户签约状态的产品码，产品码是支付宝内部对产品的唯一标识。目前支持查询产品及产品码详情参见 。
【示例值】i1011000100000000001
常见请求示例
默认示例
curl -x post \
https://openapi.alipay.com/v3/alipay/open/agent/signstatus/query \
-h "authorization: alipay-sha256withrsa app_id=${appid},timestamp=${now},nonce=${uuid},expired_seconds=600,sign=${sign}" \
-h "alipay-request-id: ${requestid}" \
-h "content-type: application/json" \
-d '{
"pid":"支付宝账号：2088123451234543或手机号：13811111111或邮箱：123@xxx.com",
"product_codes":[
"i1011000100000000001"
]
}'说明：本示例仅供参考。
公共响应参数
业务响应参数
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
响应示例
正常示例
异常示例
{
"sign_status_list":[
{
"product_name":"当面付收单",
"product_code":"face_to_face_payment",
"status":"none|valid|restrictvalid|audit|waitconfirm|auditreject|invalid|restrictinvalid"
}
]
}说明：本示例仅供参考。
公共错误码
前往查看业务错误码
| 状态码 | 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|---|
| 400 | invalid_parameter | 参数有误参数有误 | 检查必填参数是否为空，或者长度是否超限 |
| 400 | query_sign_status_auth_not_match | 应用授权信息和要查询的商户信息不匹配 | 请检查应用授权token和要查询签约状态的商户是否匹配 |
| 400 | query_sign_status_not_auth | 接口自调用时不允许查询其它商户的签约状态 | 接口自调用时只能查询自己的签约状态，要查询其他商户的签约状态，请先让商户进行应用授权，再使用代理方式调用 |
| 400 | invalid_parameter | 参数有误参数有误 | 请检查参数是否有误 |
| 400 | merchant_is_not_exist | 商家支付宝账号不存在 | 请确认商家支付宝账号存在、正确且有效 |
| 400 | system_error | 系统繁忙 | 系统异常，请联系凯发app官方网站的技术支持 |