查询服务商代运营操作结果接口 -凯发app官方网站

服务商代运营基础

产品介绍

接入准备

接入指南

api 列表

代运营授权

新蓝海活动报名

iot 三绑定

间连分级商户入驻接入指南

常见问题

更新日志

支持第三方代理调用

更新时间：2023-09-20 13:32:44

订阅更新

我的文档

设置

通用场景

查询服务商代运营操作（代运营授权或者账号绑定）结果。提供两种查询方式：
方式一：operate_type batch_no，提供基于操作批次的精确查询，只查询本操作批次的代运营操作结果，不反映最终代运营操作结果。方式一查询方式优先级更高。
方式二：operate_type access_product_code merchant_no alipay_account 参数组合，可以查询代运营操作最终结果，任意一个操作批次成功都会体现在最终结果中。
方式三：operate_type isv_scene_permissions merchant_no alipay_account 参数组合，可以查询代运营操作最终结果，任意一个操作批次成功都会体现在最终结果中（仅支持查询授权结果）。

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.sp.operation.result.query
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

operate_type必选string(64)

【描述】代运营操作类型。取值如下 account_bind：账号绑定； operation_auth：代运营授权。

【示例值】account_bind

batch_no特殊可选string(64)

【描述】支付宝操作批次号。
batch_no提供基于操作批次的精确查询，只查询本操作批次的代运营操作结果，不反映最终代运营操作结果。
注意：
1.access_product_code、merchant_no、alipay_account三个参数组合与传入 batch_no 为两种查询方式，不可同时为空且以 batch_no 优先。
2.access_product_code、merchant_no、alipay_account三个参数组合可以查询最终代运营操作结果。

【示例值】2020222342342

access_product_code特殊可选string(32)

【描述】接入的产品编号。未传batch_no时必填，枚举如下：
openapi_bind_default：操作类型为账号绑定；
openapi_auth_default：操作类型为代运营授权。

【示例值】openapi_bind_default

merchant_no特殊可选string(32)

【描述】支付宝商户号。支持间连、直连商户，值为2088开头。
未传batch_no时需注意：
若查询间连商户则 merchant_no 必填；
若查询直连商户，则merchant_no和alipay_account不能同时为空，都有值优先取merchant_no。

【示例值】2088912341234123

alipay_account特殊可选string(64)

【描述】支付宝登录账号，通常为手机号或者邮箱。未传batch_no时需注意：
1.当查询merchant_no为间连商户时：
* 若 operate_type=account_bind，则alipay_account必填。
* 若 operate_type=operation_auth，则alipay_account无需传入。
2.当查询merchant_no为直连商户时：
* merchant_no和alipay_account不能同时为空，都有值优先取merchant_no。

【示例值】testaccount@test.com

isv_scene_permissions可选string(1024)

【描述】场景授权列表结构结构：场景codea:权限code1,权限code2;场景codeb:权限code1,权限code2;

【示例值】shop_manage:shop_manage_base;promotion_manage:promotion_manage_base

参数	类型	是否必选	最大长度	描述	示例值
operate_type	string	必选	64	代运营操作类型。取值如下 account_bind：账号绑定； operation_auth：代运营授权。	account_bind
batch_no	string	特殊可选	64	支付宝操作批次号。 batch_no提供基于操作批次的精确查询，只查询本操作批次的代运营操作结果，不反映最终代运营操作结果。注意： 1.access_product_code、merchant_no、alipay_account三个参数组合与传入 batch_no 为两种查询方式，不可同时为空且以 batch_no 优先。 2.access_product_code、merchant_no、alipay_account三个参数组合可以查询最终代运营操作结果。	2020222342342
access_product_code	string	特殊可选	32	接入的产品编号。未传batch_no时必填，枚举如下： openapi_bind_default：操作类型为账号绑定； openapi_auth_default：操作类型为代运营授权。	openapi_bind_default
merchant_no	string	特殊可选	32	支付宝商户号。支持间连、直连商户，值为2088开头。未传batch_no时需注意：若查询间连商户则 merchant_no 必填；若查询直连商户，则merchant_no和alipay_account不能同时为空，都有值优先取merchant_no。	2088912341234123
alipay_account	string	特殊可选	64	支付宝登录账号，通常为手机号或者邮箱。未传batch_no时需注意： 1.当查询merchant_no为间连商户时： * 若 operate_type=account_bind，则alipay_account必填。 * 若 operate_type=operation_auth，则alipay_account无需传入。 2.当查询merchant_no为直连商户时： * merchant_no和alipay_account不能同时为空，都有值优先取merchant_no。	testaccount@test.com
isv_scene_permissions	string	可选	1024	场景授权列表结构结构：场景codea:权限code1,权限code2;场景codeb:权限code1,权限code2;	shop_manage:shop_manage_base;promotion_manage:promotion_manage_base

常见请求示例

默认示例

javac#phphttp

package com.java.sdk.demo;
import com.alipay.api.alipayapiexception;
import com.alipay.api.alipayclient;
import com.alipay.api.defaultalipayclient;
import com.alipay.api.certalipayrequest;
import com.alipay.api.alipayconfig;
import com.alipay.api.request.alipayopenspoperationresultqueryrequest;
import com.alipay.api.response.alipayopenspoperationresultqueryresponse;
import com.alipay.api.domain.alipayopenspoperationresultquerymodel;
import com.alipay.api.fileitem;
import java.util.base64;
import java.util.arraylist;
import java.util.list;
public class alipayopenspoperationresultquery {
    public static void main(string[] args) throws alipayapiexception {
        string privatekey = "<-- 请填写您的应用私钥，例如：miievqibadanb ... ... -->";
        string alipaypublickey = "<-- 请填写您的支付宝公钥，例如：miibijanbg... -->";
        alipayconfig alipayconfig = new alipayconfig();
        alipayconfig.setserverurl("https://openapi.alipaydev.com/gateway.do");
        alipayconfig.setappid("<-- 请填写您的appid，例如：2019091767145019 -->");
        alipayconfig.setprivatekey(privatekey);
        alipayconfig.setformat("json");
        alipayconfig.setalipaypublickey(alipaypublickey);
        alipayconfig.setcharset("utf8");
        alipayconfig.setsigntype("rsa2");
        alipayclient alipayclient = new defaultalipayclient(alipayconfig);
        alipayopenspoperationresultqueryrequest request = new alipayopenspoperationresultqueryrequest();
        alipayopenspoperationresultquerymodel model = new alipayopenspoperationresultquerymodel();
        model.setaccessproductcode("openapi_bind_default");
        model.setmerchantno("2088912341234123");
        model.setisvscenepermissions("shop_manage:shop_manage_base;promotion_manage:promotion_manage_base");
        model.setoperatetype("account_bind");
        model.setbatchno("2020222342342");
        model.setalipayaccount("testaccount@test.com");
        request.setbizmodel(model);
        alipayopenspoperationresultqueryresponse response = alipayclient.execute(request);
        system.out.println(response.getbody());
        if (response.issuccess()) {
            system.out.println("调用成功");
        } else {
            system.out.println("调用失败");
        }
    }
}

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

handle_status必选string(64)

【描述】代运营操作结果。
success：代表成功。
process：待商家确认中。
no_permission：表示当前商家支付宝账号无权限操作。需要提醒商家切换成发起授权时指定的支付宝账号。
none：表示不存在代运营绑定或授权关系。
none_account：间连商家推荐支付宝账号列表为空。

【示例值】success

bind_user_id特殊可选string(32)

【描述】商户支付宝pid。仅间连场景，且存在绑定关系时返回值。

【示例值】2088xxxx

merchant_no可选string(32)

【描述】支付宝商户号。间连场景为商户smid，直连场景为商户支付宝pid

【示例值】2088xxx

参数	类型	是否必选	最大长度	描述	示例值
handle_status	string	必选	64	代运营操作结果。 success：代表成功。 process：待商家确认中。 no_permission：表示当前商家支付宝账号无权限操作。需要提醒商家切换成发起授权时指定的支付宝账号。 none：表示不存在代运营绑定或授权关系。 none_account：间连商家推荐支付宝账号列表为空。	success
merchant_no	string	可选	32	支付宝商户号。间连场景为商户smid，直连场景为商户支付宝pid	2088xxx
bind_user_id	string	特殊可选	32	商户支付宝pid。仅间连场景，且存在绑定关系时返回值。	2088xxxx

响应示例

正常示例

异常示例

{
    "alipay_open_sp_operation_result_query_response": {
        "code": "10000",
        "msg": "success",
        "handle_status": "success",
        "merchant_no": "2088xxx",
        "bind_user_id": "2088xxxx"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}