查询APP支付签约状态时应使用哪个产品码?
支付小周
明确结论
查询商家的 APP 支付签约状态时,product_codes 应传入:
QUICK_MSECURITY_PAY
业务参数示例:
{
"product_codes": [
"QUICK_MSECURITY_PAY"
]
}
原因说明
product_codes 接收支付宝产品码,不接收产品的中文名称。APP 支付对应的产品码是 QUICK_MSECURITY_PAY,不能填写 APP支付、APP_PAY 等自定义值。
文档中列出的产品码通常只是部分示例,不表示接口仅支持这些产品。能否查询到签约记录,还要看目标商家是否已签约 APP 支付,以及当前调用方是否有权查询该商家的签约信息。
请求示例
调用“查询商家签约状态”接口时,业务参数可以写成:
{
"product_codes": [
"QUICK_MSECURITY_PAY"
]
}
如需同时查询多个产品,可在数组中添加对应的产品码:
{
"product_codes": [
"QUICK_MSECURITY_PAY",
"FACE_TO_FACE_PAYMENT"
]
}
实际请求还需根据接口文档填写商家标识、应用信息、签名等公共参数。具体字段以当前开放平台的接口定义为准。
结果判断
接口返回结果后,找到 product_code 为 QUICK_MSECURITY_PAY 的记录,并根据该记录的签约状态字段判断商家是否已开通 APP 支付。
接口调用成功只表示查询请求得到了正常处理,不代表目标产品已经签约。
注意事项
product_codes是数组类型。即使只查询 APP 支付,也要按数组格式传递。- 产品码必须准确拼写,并使用全大写的
QUICK_MSECURITY_PAY。 - APP 支付、手机网站支付和电脑网站支付属于不同产品,产品码不能混用。
- 如果接口返回未签约、无数据或权限不足,需要分别检查商家的签约情况、商家标识和应用授权关系。
- 如果支付宝开放平台调整了产品码或接口定义,以当前接口文档和开放平台的实际返回结果为准。
备注:内容仅供参考。
