查询商户某个产品的签约状态

主要用在isv代理商户签约场景，用来查询商户签约某个产品的签约状态，可以配合"第三方接入核心API"功能包里的接口使用

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/agent/signstatus/query' \ --header 'Content-Type: application/json' \ --data-raw '{ "pid": "支付宝账号：2088123451234543或手机号：13811111111或邮箱：123@xxx.com", "product_codes": "I1011000100000000001" }'

{ "sign_status_list": [ { "product_code": "FACE_TO_FACE_PAYMENT", "product_name": "当面付收单", "status": "none|valid|restrictValid|audit|waitConfirm|auditReject|invalid|restrictInvalid" } ] }

请求参数

Body 参数application/json

pid

string

可选

isv要查询签约状态的商户账号，可以是支付宝账号pid（2088开头），也可以是商户的登录账号（邮箱或手机号）

示例值:

支付宝账号：2088123451234543或手机号：13811111111或邮箱：123@xxx.com

product_codes

array[string]

可选

isv要查询商户签约状态的产品码，产品码是支付宝内部对产品的唯一标识。目前支持查询产品及产品码详情参见 https://opendocs.alipay.com/isv/01cv77#%E8%83%BD%E5%8A%9B%E4%BA%A7%E5%93%81%E7%A0%81 。

示例值:

I1011000100000000001

示例

返回响应

🟢200common response

application/json

Body

sign_status_list

array[object (ProductSignStatusInfo) {3}]

可选

商户产品签约状态结果对象数组，返回本次查询的产品的签约状态

product_code

string

产品编码

可选

示例值:

FACE_TO_FACE_PAYMENT

product_name

string

产品名称

可选

示例值:

当面付收单

status

string

可选

none:未签约，表示还没有签约该产品 valid:已生效，表示合约已经生效，不需要再签约了 restrictValid:受限生效，表示合约已经生效，但是资料不全，功能受限 audit:审核中，已经有合约在审核中，请等待审核完成 waitConfirm:待商户确认协议，合约已经审核通过，需要商户确认后合约才生效 auditReject:审核未通过 invalid:合约失效，曾经签过合约，但已经失效了，可以重新发起签约 restrictInvalid:受限失效，受限合约失效了

示例值:

🔴500请求失败