创建签约授权一体化订单接口 -凯发app官方网站

支持第三方代理调用

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

文档更新记录 >

订阅更新

我的文档

设置

通用场景

针对签约授权一体化场景，创建签约授权一体化订单绑定签约单（可选）、绑定代运营授权单、应用授权单，跟踪整个签约授权一体化订单的状态

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.sp.isv.signauth.create
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	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

merchant_logon_id必选string(64)

【描述】商户登录账号
支持手机号和邮箱账号；不支持pid

【示例值】13181141917

sign_order_no可选string(64)

【描述】签约单号
可通过alipay.open.agent.confirm接口获取签约单号

【示例值】20211015034000100000052128459671

isv_auth_scene_infos可选isvauthsceneinfo[]

【描述】代运营授权场景信息

scene_code必选string(64)

【描述】运营场景编码
operation_points：管理运营积分
shop_manage：管理门店信息
mini_app_oper：运营支付宝小程序
promotion_manage：运营营销活动

【示例值】promotion_manage

scene_permissions必选string(1024)

【描述】运营场景下的权限编码，多个权限编码以,隔开
1、管理门店信息：shop_manage；基础权限（升级）：shop_manage_base
2、运营营销活动：promotion_manage ；基础权限（升级）：promotion_manage_base
3、运营支付宝小程序：mini_app_oper；基础权限（升级）：mini_app_oper_base
4、管理运营积分：operation_points；基础权限（升级）：operation_points_base

【示例值】shop_manage_base

need_app_auth可选string(6)

【描述】1表示需要，0表示不需要
不传参数默认是需要（1）
是否创建三方应用授权子任务，也就是是否需要给三方应用授权

【示例值】1

参数	类型	是否必选	最大长度	描述	示例值
sign_order_no	string	可选	64	签约单号可通过alipay.open.agent.confirm接口获取签约单号	20211015034000100000052128459671
merchant_logon_id	string	必选	64	商户登录账号支持手机号和邮箱账号；不支持pid	13181141917
isv_auth_scene_infos	isvauthsceneinfo[]	可选		代运营授权场景信息
need_app_auth	string	可选	6	1表示需要，0表示不需要不传参数默认是需要（1）是否创建三方应用授权子任务，也就是是否需要给三方应用授权	1

常见请求示例

默认示例

javac#phphttp

alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayopenspisvsignauthcreaterequest request = new alipayopenspisvsignauthcreaterequest();
request.setbizcontent("{" 
"  \"sign_order_no\":\"20211015034000100000052128459671\"," 
"  \"merchant_logon_id\":\"13181141917\"," 
"  \"isv_auth_scene_infos\":[" 
"    {" 
"      \"scene_code\":\"promotion_manage\"," 
"      \"scene_permissions\":\"shop_manage_base\"" 
"    }" 
"  ]," 
"  \"need_app_auth\":\"1\"" 
"}");
alipayopenspisvsignauthcreateresponse response = alipayclient.execute(request);
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=

业务响应参数

order_id必选string(64)

【描述】签约授权一体化主单id

【示例值】20211102034000100000047728652233

参数	类型	是否必选	最大长度	描述	示例值
order_id	string	必选	64	签约授权一体化主单id	20211102034000100000047728652233

响应示例

正常示例

异常示例

{
    "alipay_open_sp_isv_signauth_create_response": {
        "code": "10000",
        "msg": "success",
        "order_id": "20211102034000100000047728652233"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}