文档中心 > API类目 > 第三方API

alipay.open.agent.facetoface.sign (代签约当面付产品)

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

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.open.agent.facetoface.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.isv.agent.create接口进行创建。 2017110616474516400082883
mcc_code String 必须 16 所属MCCCode,详情可参考
商家经营类目 中的“经营类目编码”
A_A03_4582
special_license_pic byte[] 特殊可选 5242880 企业特殊资质图片,可参考
商家经营类目 中的“需要的特殊资质证书”,最小50KB,图片格式必须为:png、bmp、gif、jpg、jpeg
-
business_license_no String 必须 32 营业执照号码 1532501100006302
business_license_pic byte[] 必须 5242880 营业执照图片。被代创建商户运营主体为个人账户必填,企业账户无需填写,最小50KB,图片格式必须为:png、bmp、gif、jpg、jpeg -
business_license_auth_pic byte[] 可选 5242880 营业执照授权函图片,个体工商户如果使用总公司或其他公司的营业执照认证需上传该授权函图片,最小50KB,图片格式必须为:png、bmp、gif、jpg、jpeg -
long_term Boolean 可选 1 营业期限是否长期有效 true
date_limitation String 可选 10 营业期限 2017-11-11
shop_scene_pic byte[] 必须 5242880 店铺内景图片,最小50KB,图片格式必须为:png、bmp、gif、jpg、jpeg -
shop_sign_board_pic byte[] 必须 5242880 店铺门头照图片,最小50KB,图片格式必须为:png、bmp、gif、jpg、jpeg -

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码,详见文档 40004
msg String - 网关返回码描述,详见文档 Business Failed
sub_code String - 业务返回码,详见文档 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述,详见文档 交易已被支付
sign String - 签名,详见文档 DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必填 最大长度 描述 示例值

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayOpenAgentFacetofaceSignRequest request = new AlipayOpenAgentFacetofaceSignRequest();
request.setBatchNo("2017110616474516400082883");
request.setMccCode("A_A03_4582");
FileItem SpecialLicensePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setSpecialLicensePic(SpecialLicensePic);
request.setBusinessLicenseNo("1532501100006302");
FileItem BusinessLicensePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setBusinessLicensePic(BusinessLicensePic);
FileItem BusinessLicenseAuthPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setBusinessLicenseAuthPic(BusinessLicenseAuthPic);
request.setLongTerm(true);
request.setDateLimitation("2017-11-11");
FileItem ShopScenePic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setShopScenePic(ShopScenePic);
FileItem ShopSignBoardPic = new FileItem(C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg);
request.setShopSignBoardPic(ShopSignBoardPic);
AlipayOpenAgentFacetofaceSignResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"alipay_open_agent_facetoface_sign_response":{
		"msg":"Success",
		"code":"10000"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

  • JSON示例
{
	"alipay_open_agent_facetoface_sign_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

错误码 错误描述 解决方案
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 文件格式错误 请检查文件类型的参数格式

公共错误码

返回
顶部