通用场景
面向服务商,查询发起代运营授权或者账号绑定的二维码。代间联商户代运营时,推荐使用接口同步返回的recommend_accounts字段中的账号扫码确认。
公共请求参数
业务请求参数
out_biz_no必选string(64)
【描述】外部操作流水,由服务商自定义,需确保每次操作唯一。仅支持数字、字母、下划线组合。
【示例值】2020124234523465636345634
operate_type必选string(32)
【描述】代运营操作类型。取值如下:
* account_bind:账号绑定,仅支持间连商户。
* operation_auth:代运营授权,支持间连、直连商户。
* account_bind:账号绑定,仅支持间连商户。
* operation_auth:代运营授权,支持间连、直连商户。
【示例值】operation_auth
merchant_no特殊可选string(32)
【描述】支付宝商户号。注意仅支持 2088 开头的间连商户。
若被代运营者是间连商户,则 merchant_no 必填;
若为直连商户,则 merchant_no 和 alipay_account 不能同时为空,都有值优先取 merchant_no。
若被代运营者是间连商户,则 merchant_no 必填;
若为直连商户,则 merchant_no 和 alipay_account 不能同时为空,都有值优先取 merchant_no。
【示例值】2088xxxx
alipay_account特殊可选string(32)
【描述】支付宝登录账号。通常为手机号或者邮箱。
若被代运营者是间连商户,该字段无需填写。
若为直连商户,则 merchant_no 和 alipay_account 不能同时为空,都有值优先取 merchant_no。
若被代运营者是间连商户,该字段无需填写。
若为直连商户,则 merchant_no 和 alipay_account 不能同时为空,都有值优先取 merchant_no。
【示例值】xxx@gmail.com
access_product_code特殊可选string(32)
【描述】接入的产品编号。
操作类型为绑定的,填openapi_bind_default;
操作类型为授权的,填openapi_auth_default
操作类型为绑定的,填openapi_bind_default;
操作类型为授权的,填openapi_auth_default
【示例值】openapi_auth_default
isv_scene_permissions特殊可选string(1024)
【描述】场景授权列表结构结构:场景codea:权限code1,权限code2;场景codeb:权限code1,权限code2;
【示例值】shop_manage:shop_manage_base;promotion_manage:promotion_manage_base
常见请求示例
默认示例
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.alipayopenspoperationqrcodequeryrequest;
import com.alipay.api.response.alipayopenspoperationqrcodequeryresponse;
import com.alipay.api.domain.alipayopenspoperationqrcodequerymodel;
import com.alipay.api.fileitem;
import java.util.base64;
import java.util.arraylist;
import java.util.list;
public class alipayopenspoperationqrcodequery {
public static void main(string[] args) throws alipayapiexception {
string privatekey = "<-- 请填写您的应用私钥,例如:miievqibadanb ... ... -->";
string alipaypublickey = "<-- 请填写您的支付宝公钥,例如:miibijanbg... -->";
alipayconfig alipayconfig = new alipayconfig();
alipayconfig.setserverurl("https://openapi.alipay.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);
alipayopenspoperationqrcodequeryrequest request = new alipayopenspoperationqrcodequeryrequest();
alipayopenspoperationqrcodequerymodel model = new alipayopenspoperationqrcodequerymodel();
model.setaccessproductcode("openapi_auth_default");
model.setoutbizno("2020124234523465636345634");
model.setmerchantno("2088xxxx");
model.setisvscenepermissions("shop_manage:shop_manage_base;promotion_manage:promotion_manage_base");
model.setoperatetype("operation_auth");
model.setalipayaccount("xxx@gmail.com");
request.setbizmodel(model);
alipayopenspoperationqrcodequeryresponse response = alipayclient.execute(request);
system.out.println(response.getbody());
if (response.issuccess()) {
system.out.println("调用成功");
} else {
system.out.println("调用失败");
// sdk版本是"4.38.0.all"及以上,可以参考下面的示例获取诊断链接
// string diagnosisurl = diagnosisutils.getdiagnosis;
// system.out.println(diagnosisurl);
}
}
}
说明:本示例仅供参考。
公共响应参数
业务响应参数
qr_code_url必选string(1024)
【描述】二维码图片地址,urlencode处理过。
注意:
1.有效期为24h;
2.用户扫码确认授权操作(同意/拒绝)后,支付宝将通过接口发送异步通知给服务商。
注意:
1.有效期为24h;
2.用户扫码确认授权操作(同意/拒绝)后,支付宝将通过接口发送异步通知给服务商。
【示例值】http://qrcode.alipay.com/adadadad.jpg
batch_no必选string(64)
【描述】支付宝操作批次号
【示例值】2020222342342
recommend_accounts特殊可选recommendaccountdto
【描述】只针对服务商代间连商家发起代运营绑定、授权时,这个字段会返回推荐的商家支付宝账号列表,包括:支付宝账号和名称,为保护商家信息,账号和名称都按照规范脱敏。
user_name必选string(32)
【描述】推荐商家支付宝账号名称,脱敏处理
【示例值】张*
alipay_account必选string(32)
【描述】推荐商家支付宝登录账号,邮箱或手机号码,脱敏处理
【示例值】181******24
bind_account特殊可选recommendaccountdto
【描述】商家已经绑定的支付宝账号信息
user_name必选string(32)
【描述】推荐商家支付宝账号名称,脱敏处理
【示例值】张*
alipay_account必选string(32)
【描述】推荐商家支付宝登录账号,邮箱或手机号码,脱敏处理
【示例值】181******24
recommend_account_list特殊可选recommendaccountdto[]
【描述】只针对服务商代间连商家发起代运营绑定、授权时,如果传递的alipay_account不符合绑定或授权要求,这个字段会返回推荐的商家支付宝账号列表,包括:支付宝账号和名称,为保护商家信息,账号和名称都按照规范脱敏。
user_name必选string(32)
【描述】推荐商家支付宝账号名称,脱敏处理
【示例值】张*
alipay_account必选string(32)
【描述】推荐商家支付宝登录账号,邮箱或手机号码,脱敏处理
【示例值】181******24
响应示例
正常示例
异常示例
{
"alipay_open_sp_operation_qrcode_query_response": {
"code": "10000",
"msg": "success",
"qr_code_url": "http://qrcode.alipay.com/adadadad.jpg",
"batch_no": "2020222342342",
"recommend_accounts": {
"user_name": "张*",
"alipay_account": "181******24"
},
"bind_account": {
"user_name": "张*",
"alipay_account": "181******24"
},
"recommend_account_list": [
{
"user_name": "张*",
"alipay_account": "181******24"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
invalid_parameter | 参数有误请检查入参 | 请检查入参 |
system_error | 系统繁忙 | 系统异常 |
illegal_merchant_no | 商户号参数有误 | 请检查商户号是否存在 |
illegal_alipay_account | 支付宝账号参数有误 | 请检查支付宝账号是否存在 |
illegal_operate_type | 操作类型参数有误 | 请检查operate_type参数 |
illegal_product_code | 接入产品编号有误 | 请检查access_product_code参数 |
illegal_isv_user | 调用者非服务商主账号 | 请调用者入驻p站 |
illegal_bind_account | 绑定操作的商户参数有误 | 对于绑定操作,merchant_no填间连商户号,alipayaccount填支付宝账号 |
illegal_indirect_merchant | 绑定操作merchant_no需为间连商户 | 绑定操作仅支持间连商户,请确认merchant_no是否为间连商户 |
merchant_has_bound | 间连商家已经绑定了支付宝账号 | 请确认已经绑定的支付宝账号,参考返回结果bind_account,如果不正确,需要联系商家在b站先解除绑定,然后再次发起绑定 |
merchant_info_uncomplete | 间连商户信息不完整 | 请先补充间连商户信息,包括:营业执照、法人身份证等信息 |
smid_wait_bind_account_empty | 间连商户没有可绑定的支付宝账号 | 如果商家的支付宝账号是新注册账号,请48h后再重试 |
illegal_merchant_no | 商户号参数有误 | 请检查商户号是否存在 |
sp_discard | 因违反服务商管理制度已被清退 | 因违反服务商管理制度已被清退,有问题可咨询4007585858。 |
illegal_product_code_permissions | 接入产品编号和场景权限码需要有且只有一个 | 接入产品编号和场景权限码需要有,且只传一个 |
illegal_scene_or_permissions | 接入场景码或者权限码不合法 | 请检查接入场景码或者权限码 |
sp_merchant_risk_fail | 当前操作可能存在风险,为保护数据和资金安全,我们中断了此次操作。 | 当前操作可能存在风险,为保护数据和资金安全,我们中断了此次操作。 |
security_system_error | 核身服务系统异常, 请稍后重试 | 核身服务系统异常, 请稍后重试 |
sp_pause_or_delete | 服务商已被暂停或注销,无法进行openapi操作 | 请检查服务商身份是否正常,如果已注销则进行重新入驻,如果已暂停则进行身份恢复。 |