代签约当面付快捷版产品接口 -凯发app官方网站

支持第三方代理调用

更新时间：2024-05-16 11:32:48

文档更新记录 >

订阅更新

我的文档

设置

通用场景

三方应用代理签约当面付快捷版产品，需要配合开启事务接口使用

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.agent.offlinepayment.sign
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	详见应用授权概述

业务请求参数

batch_no必选string(25)

【描述】代商户操作事务编号，通过alipay.open.agent.create接口进行创建。

【示例值】2017110616474516400082883

mcc_code必选string(16)

【描述】所属mcccode，可参考
中的“经营类目编码”

【示例值】a_a03_4582

rate必选string(3)

【描述】服务费率（%），0.38~3之间，精确到0.01

【示例值】0.38

special_license_pic特殊可选byte_array(5242880)

【描述】企业特殊资质图片，可参考
中的“需要的特殊资质证书”，最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg

【示例值】-

business_license_no可选string(32)

【描述】营业执照号码。若填写，请与以下营业执照图片、期限、一起提供。

【示例值】1532501100006302

business_license_pic可选byte_array(5242880)

【描述】营业执照图片。被代创建商户运营主体为个人账户必填，企业账户无需填写，最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg

【示例值】-

long_term可选boolean(1)

【描述】营业期限是否长期有效

【示例值】true

date_limitation可选string(10)

【描述】营业期限

【示例值】2017-11-11

shop_sign_board_pic可选byte_array(5242880)

【描述】店铺门头照图片，需要包括招牌信息。最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg

【示例值】-

shop_name可选string(256)

【描述】店铺名称

【示例值】-

delivery_address可选signaddressinfo

【描述】送货地址

country_code必选string(10)

【描述】国家编码，中国默认：156

【示例值】156

province_code必选string(10)

【描述】省份编码。请按照https://gw.alipayobjects.com/os/basement_prod/253c4dcb-b8a4-4a1e-8be2-79e191a9b6db.xlsx 表格中内容填写。（参考资料： http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/）

【示例值】370000

city_code必选string(10)

【描述】城市编码。请按照https://gw.alipayobjects.com/os/basement_prod/253c4dcb-b8a4-4a1e-8be2-79e191a9b6db.xlsx 表格中内容填写。（参考资料： http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/）

【示例值】371000

district_code必选string(10)

【描述】区县编码。请按照https://gw.alipayobjects.com/os/basement_prod/253c4dcb-b8a4-4a1e-8be2-79e191a9b6db.xlsx 表格中内容填写。（参考资料： http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/）

【示例值】371002

detail_address必选string(256)

【描述】详细地址

【示例值】xx街道xx小区xx楼xx号

longitude可选string(11)

【描述】经度，浮点型, 小数点后最多保留6位。如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker

【示例值】120.760001

latitude可选string(11)

【描述】纬度，浮点型,小数点后最多保留6位如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker

【示例值】60.270001

shop_address可选signaddressinfo

【描述】店铺地址

country_code必选string(10)

【描述】国家编码，中国默认：156

【示例值】156

province_code必选string(10)

【示例值】370000

city_code必选string(10)

【示例值】371000

district_code必选string(10)

【示例值】371002

detail_address必选string(256)

【描述】详细地址

【示例值】xx街道xx小区xx楼xx号

longitude可选string(11)

【示例值】120.760001

latitude可选string(11)

【示例值】60.270001

shop_scene_pic可选byte_array(5242880)

【描述】店铺内景照片，最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg

【示例值】-

business_license_mobile可选string(11)

【描述】被邀请授权的营业执照法人手机号码，上传非同人营业执照时必填

【示例值】13189652239

参数	类型	是否必选	最大长度	描述	示例值
batch_no	string	必选	25	代商户操作事务编号，通过alipay.open.agent.create接口进行创建。	2017110616474516400082883
mcc_code	string	必选	16	所属mcccode，可参考中的“经营类目编码”	a_a03_4582
special_license_pic	byte_array	特殊可选	5242880	企业特殊资质图片，可参考中的“需要的特殊资质证书”，最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg	-
rate	string	必选	3	服务费率（%），0.38~3之间，精确到0.01	0.38
business_license_no	string	可选	32	营业执照号码。若填写，请与以下营业执照图片、期限、一起提供。	1532501100006302
business_license_pic	byte_array	可选	5242880	营业执照图片。被代创建商户运营主体为个人账户必填，企业账户无需填写，最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg	-
long_term	boolean	可选	1	营业期限是否长期有效	true
date_limitation	string	可选	10	营业期限	2017-11-11
shop_sign_board_pic	byte_array	可选	5242880	店铺门头照图片，需要包括招牌信息。最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg	-
shop_name	string	可选	256	店铺名称	-
delivery_address	signaddressinfo	可选		送货地址
shop_address	signaddressinfo	可选		店铺地址
shop_scene_pic	byte_array	可选	5242880	店铺内景照片，最小5kb，图片格式必须为：png、bmp、gif、jpg、jpeg	-
business_license_mobile	string	可选	11	被邀请授权的营业执照法人手机号码，上传非同人营业执照时必填	13189652239

常见请求示例

默认示例

javac#phphttp

alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayopenagentofflinepaymentsignrequest request = new alipayopenagentofflinepaymentsignrequest();
request.setbatchno("2017110616474516400082883");
request.setmcccode("a_a03_4582");
fileitem speciallicensepic = new fileitem("c:/downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg");
request.setspeciallicensepic(speciallicensepic);
request.setrate("0.38");
request.setbusinesslicenseno("1532501100006302");
fileitem businesslicensepic = new fileitem("c:/downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg");
request.setbusinesslicensepic(businesslicensepic);
request.setlongterm(true);
request.setdatelimitation("2017-11-11");
fileitem shopsignboardpic = new fileitem("c:/downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg");
request.setshopsignboardpic(shopsignboardpic);
request.setshopname("-");
signaddressinfo signaddressinfo = new signaddressinfo();
signaddressinfo.setcountrycode("156");
signaddressinfo.setprovincecode("370000");
signaddressinfo.setcitycode("371000");
signaddressinfo.setdistrictcode("371002");
signaddressinfo.setdetailaddress("xx街道xx小区xx楼xx号");
signaddressinfo.setlongitude("120.760001");
signaddressinfo.setlatitude("60.270001");
request.setdeliveryaddress(signaddressinfo);
signaddressinfo signaddressinfo = new signaddressinfo();
signaddressinfo.setcountrycode("156");
signaddressinfo.setprovincecode("370000");
signaddressinfo.setcitycode("371000");
signaddressinfo.setdistrictcode("371002");
signaddressinfo.setdetailaddress("xx街道xx小区xx楼xx号");
signaddressinfo.setlongitude("120.760001");
signaddressinfo.setlatitude("60.270001");
request.setshopaddress(signaddressinfo);
fileitem shopscenepic = new fileitem("c:/downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg");
request.setshopscenepic(shopscenepic);
request.setbusinesslicensemobile("13189652239");
alipayopenagentofflinepaymentsignresponse 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=

业务响应参数

无业务响应参数

响应示例

正常示例

异常示例

{
    "alipay_open_agent_offlinepayment_sign_response": {
        "code": "10000",
        "msg": "success"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

说明：本示例仅供参考。

公共错误码

业务错误码

错误码	错误描述	凯发app官方网站的解决方案
invalid_parameter	参数有误参数有误	检查必填参数是否为空，或者长度是否超限
invalid_batch_no	事务编号 batch_no 不能为空	事务编号参数 batch_no 不能为空
batch_is_not_exist	代商户操作事务编号不存在	请检查事务编号是否有效
batch_status_is_final	事务已经达到终态	请确认事务状态是否是 init 状态，submit\|cancel\|timeout 状态的都是终态，不允许继续进行接口调用。
system_error	系统繁忙	系统内部错误，请稍后重试
isv_app_order_package_empty	第三方应用没有任何需要签约开通的功能包	请挂载收钱码功能包
isv_app_no_order_package	第三方应用没有挂载该功能包	请挂载收钱码功能包
merchant_sign_product_in_audit	签约审核中	该商户签约审核中，暂时不能操作，请等签约审核结束后再试！
merchant_sign_product_in_forbidd	无法进行签约，或存在产品签约冲突	该商户无法签约当前产品，存在产品签约冲突，不允许执行签约
no_app_permission	appid 不匹配	appid 不匹配，请检查当前调用的 appid 和创建事务的 appid 是否匹配
file_size_out_limit	文件大小超出范围	请检查文件类型的参数大小
file_size_min_limit	文件大小低于范围	请检查文件类型的参数大小
file_format_is_invalid	文件格式错误	请检查文件类型的参数格式
pre_auth_invalid_auth_ticket	无效的订单授权凭证，状态失效或已过期	订单授权凭证无法使用，请商户重新订购生成新的订单授权凭证使用
pre_auth_invalid_auth_token	订单授权凭证换取的令牌已失效	商户取消了授权或者令牌被刷新，订单授权凭证无法使用
pre_auth_invoke_api_not_permitte	该订单授权凭证无权限调用该接口	无接口调用权限
pre_auth_invalid_package	订单授权凭证中缺少必要的功能包	请在三方应用中添加"当面付"功能包，重新发布服务并让商户重新订购，取新的订单授权凭证使用
pre_auth_invalid_auth_app_id	订单授权凭证对应被授权应用与接口调用应用不一致	请将调用接口的应用id更换成订单授权凭证对应的应用id
merchant_need_face_certify	需要商户完成身份证或人脸认证后，才能代商户签约	请联系代签约的商户先完成身份证或人脸认证后后，再代商户签约
merchant_state_not_satisfy	商户被清退或禁止续签，不允许签约	请检查商户状态，再重新签约
un_support_account_certify_level	账户未达到认证要求	请先联系商家完成账号认证，认证通过后重新签约
un_support_account_type	不支持的签约账号类型	请检查代签约的商家账号类型
ant_product_conflict	您已签约此产品，或者同类产品	确保批量签约的产品没有冲突
user_card_balance_pay_closed	账户余额支付功能已关闭，不能签约该产品	商家账户余额功能已关闭，请联系商家开启后重新签约
check_agds_seller_access_failed	蚂蚁花呗专享认证不通过，不满足花呗准入规则	请检查蚂蚁花呗专享是否认证通过
ant_product_dependency_required	产品之间存在依赖	你还未签约支付宝支付产品（如电脑网站支付、手机网站支付、app支付、当面付等），请签约后再开通本产品
isv_no_permission	isv不在业务开放范围	isv不在业务开放范围
agent_sign_in_audit_by_same_isv	审核中，请等待	相同isv代理签约审核中，请等待
agent_sign_in_audit_by_diff_isv	商家正在被其它isv代理签约中，请等待审核完成再进行	商家正在被其它isv代理签约中，请等待审核完成再进行
agent_sign_confirm_by_same_isv	待商户确认状态，请联系商户尽快确认	待商户确认状态，请联系商户尽快确认
agent_sign_confirm_by_diff_isv	待商户确认状态，请等待商户确认	待商户确认状态，请等待商户确认
agent_sign_valid_by_same_isv	该商户已被代理签约	该商户已被代理签约
shop_sign_board_pic_risk	店铺门头照不合法	店铺门头照不合法
business_license_pic_risk	营业执照不合法，签约身份信息或填写信息必须与图片一致	营业执照不合法，个人账号必须与法人姓名一致。
agent_sign_product_in_forbidden	该商户无法签约当前产品，存在产品签约冲突	该商户无法签约当前产品，存在产品签约冲突，不允许执行签约
biz_error	业务异常	具体失败原因，请参考接口返回的错误信息
isv_identity_not_satisfy	当前账户已入驻为服务商，不能签约收钱产品，请更换账号签约	请更换账号签约

公共请求参数

业务请求参数

公共响应参数

业务响应参数

公共错误码

业务错误码

相关问题