通用场景
服务商向商户发起代运营操作(账号绑定或者代运营授权)
公共请求参数
业务请求参数
out_biz_no必选string(64)
【描述】外部操作流水,isv自定义。每次操作需要确保唯一。
【示例值】2020124234523465636345634
operate_type必选string(32)
【描述】代运营操作类型。枚举如下:
* account_bind:代表绑定支付宝账号,仅对于间连商户。
* operation_auth:代表代运营授权,支持间连和直连商户,其中间连场景包含绑定支付宝账号。
* account_bind:代表绑定支付宝账号,仅对于间连商户。
* operation_auth:代表代运营授权,支持间连和直连商户,其中间连场景包含绑定支付宝账号。
【枚举值】
绑定支付宝账号,仅对于间连商户: account_bind
代运营授权,支持间连和直连商户,其中间连场景包含绑定支付宝账号: operation_auth
【示例值】account_bind
access_product_code特殊可选string(32)
【描述】接入的产品编号。 枚举如下:
* openapi_bind_default:操作类型为账号绑定。
* openapi_auth_default:操作类型为代运营授权时。
* openapi_bind_default:操作类型为账号绑定。
* openapi_auth_default:操作类型为代运营授权时。
【示例值】openapi_bind_default
merchant_no特殊可选string(32)
【描述】支付宝商户号。
间连场景,merchant_no必填,传入商户smid,特别注意仅支持2088开头的间连商户。
直连场景,merchant_no选填,传入商户支付宝pid,特别注意merchant_no和alipay_account不能同时为空,优先取merchant_no。
间连场景,merchant_no必填,传入商户smid,特别注意仅支持2088开头的间连商户。
直连场景,merchant_no选填,传入商户支付宝pid,特别注意merchant_no和alipay_account不能同时为空,优先取merchant_no。
【示例值】2088xxxx
alipay_account特殊可选string(64)
【描述】支付宝登录账号,通常为手机号或者邮箱。
间连场景必填。
直连场景选填,特别注意merchant_no和alipay_account不能同时为空,都有值优先取merchant_no。
间连场景必填。
直连场景选填,特别注意merchant_no和alipay_account不能同时为空,都有值优先取merchant_no。
【示例值】xxx@gmail.com
isv_scene_permissions特殊可选string(1024)
【描述】场景授权列表结构结构:场景codea:权限code1,权限code2;场景codeb:权限code1,权限code2;
说明:
* 本参数和access_product_code只需要传一个。
* 场景 权限code含义:
shop_manage:shop_manage_base:管理门店信息
mini_app_oper:mini_app_oper_base:运营支付宝小程序
promotion_manage:promotion_manage_base:运营营销活动
operation_points:operation_points_base:管理运营积分
incentive_point_manage:incentive_point_manage_base:管理激励点数
说明:
* 本参数和access_product_code只需要传一个。
* 场景 权限code含义:
shop_manage:shop_manage_base:管理门店信息
mini_app_oper:mini_app_oper_base:运营支付宝小程序
promotion_manage:promotion_manage_base:运营营销活动
operation_points:operation_points_base:管理运营积分
incentive_point_manage:incentive_point_manage_base:管理激励点数
【示例值】shop_manage:shop_manage_base;mini_app_oper:mini_app_oper_base;promotion_manage:promotion_manage_base;operation_points:operation_points_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.domain.alipayopenspoperationapplymodel;
import com.alipay.api.request.alipayopenspoperationapplyrequest;
import com.alipay.api.response.alipayopenspoperationapplyresponse;
import com.alipay.api.fileitem;
import java.util.base64;
import java.util.arraylist;
import java.util.list;
public class alipayopenspoperationapply {
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);
alipayopenspoperationapplyrequest request = new alipayopenspoperationapplyrequest();
alipayopenspoperationapplymodel model = new alipayopenspoperationapplymodel();
model.setaccessproductcode("openapi_bind_default");
model.setoutbizno("2020124234523465636345634");
model.setmerchantno("2088xxxx");
model.setisvscenepermissions("shop_manage:shop_manage_base;mini_app_oper:mini_app_oper_base;promotion_manage:promotion_manage_base;operation_points:operation_points_base");
model.setoperatetype("account_bind");
model.setalipayaccount("xxx@gmail.com");
request.setbizmodel(model);
alipayopenspoperationapplyresponse 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);
}
}
}
说明:本示例仅供参考。
公共响应参数
业务响应参数
batch_no必选string(64)
【描述】支付宝操作批次号
【示例值】2020222342342
recommend_accounts特殊可选recommendaccountdto[]
【描述】只针对服务商代间连商家发起代运营绑定、授权时,如果传递的alipay_account不符合绑定或授权要求,这个字段会返回推荐的商家支付宝账号列表,包括:支付宝账号和名称,为保护商家信息,账号和名称都按照规范脱敏。
user_name必选string(32)
【描述】推荐商家支付宝账号名称,脱敏处理
【示例值】张*
alipay_account必选string(32)
【描述】推荐商家支付宝登录账号,邮箱或手机号码,脱敏处理
【示例值】181******24
bind_account特殊可选recommendaccountdto
【描述】商家已经绑定的支付宝账号信息
user_name必选string(32)
【描述】推荐商家支付宝账号名称,脱敏处理
【示例值】张*
alipay_account必选string(32)
【描述】推荐商家支付宝登录账号,邮箱或手机号码,脱敏处理
【示例值】181******24
响应示例
正常示例
异常示例
{
"alipay_open_sp_operation_apply_response": {
"code": "10000",
"msg": "success",
"batch_no": "2020222342342",
"recommend_accounts": [
{
"user_name": "张*",
"alipay_account": "181******24"
}
],
"bind_account": {
"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_user_id,如果不正确,需要联系商家在b站先解除绑定,然后再次发起绑定 |
merchant_info_uncomplete | 间连商户信息不完整 | 请先补充间连商户信息,包括:营业执照、法人身份证等信息 |
smid_wait_bind_account_empty | 间连商户没有可绑定的支付宝账号 | 如果商家的支付宝账号是新注册账号,请48h后再重试 |
wait_bind_account_no_match | 商家支付宝账号不在可绑定列表中 | 请参考接口返回结果recommend_accounts,使用推荐的商家支付宝账号操作 |
illegal_merchant_no | 查询无此商家 | 请检查商户号是否存在 |
sp_discard | 因违反服务商管理制度已被清退 | 因违反服务商管理制度已被清退,有问题可咨询4007585858。 |
illegal_product_code_permissions | 接入产品编号和场景权限码需要有且只有一个 | 接入产品编号和场景权限码需要有,且只传一个 |
illegal_scene_or_permissions | 接入场景码或者权限码不合法 | 请检查接入场景码或者权限码 |
security_system_error | 核身服务系统异常, 请稍后重试 | 核身服务系统异常, 请稍后重试 |
sp_merchant_risk_fail | 当前操作可能存在风险,为保护数据和资金安全,我们中断了此次操作。 | 当前操作可能存在风险,为保护数据和资金安全,我们中断了此次操作。 |
sp_pause_or_delete | 服务商已被暂停或注销,无法进行openapi操作 | 请检查服务商身份是否正常,如果已注销则进行重新入驻,如果已暂停则进行身份恢复。 |
bp_wait_process_create_error | 给商户创建邀请授权待办失败 | 给商户创建邀请授权待办失败,请重试 |
mrchprod_rpc_invoke_error | 绑定间连商户前置校验失败 | 建议重试 |