通用场景
三方应用代理签约当面付产品，需要配合开启事务接口使用
公共请求参数
业务请求参数
batch_no必选string(64)
【描述】代商户操作事务编号，通过 (开启代商户签约、创建应用事务)接口进行事务创建后获取。
【示例值】2017110616474516400082883
mcc_code必选string(16)
【描述】商家经营类目编码。参见 中的“一级类目code_二级类目code”。
【示例值】a0001_b0199
special_license_pic特殊可选byte[](5242880)
【描述】企业特殊资质图片，当mcc_code为需要特殊资质类目时必填。可参考
中的“所需资质”，最小5kb ，最大5m（暂不限制图片宽高），图片格式必须为：png、bmp、gif、jpg、jpeg
【示例值】-
rate特殊可选string(8)
【描述】服务费率（%），0.38~0.6 之间（小数点后两位，可取0.38%及0.6%）。
当签约且授权标识 sign_and_auth=true 时，该费率信息必填。
【必选条件】当签约且授权标识 sign_and_auth=true 时，该费率信息必填。
【示例值】0.38
sign_and_auth可选boolean(5)
【描述】签约且授权标识，默认为false，只进行签约操作； 如果设置为true，则表示签约成功后，会自动进行应用授权操作。
【示例值】false
business_license_no可选string(32)
【描述】营业执照号码
【示例值】1532501100006302
business_license_pic可选byte[](5242880)
【描述】营业执照图片。被代创建商户运营主体为个人账户必填，企业账户无需填写，最小5kb，最大5m（暂不限制图片宽高），图片格式必须为：png、bmp、gif、jpg、jpeg
【示例值】-
business_license_auth_pic可选byte[](5242880)
【描述】营业执照授权函图片，个体工商户如果使用总公司或其他公司的营业执照认证需上传该授权函图片，最小5kb，最大5m（暂不限制图片宽高），图片格式必须为：png、bmp、gif、jpg、jpeg
【示例值】-
long_term可选boolean(4)
【描述】营业期限是否长期有效
【示例值】true
date_limitation可选string(10)
【描述】营业期限
【示例值】2017-11-11
shop_scene_pic可选byte[](5242880)
【描述】店铺内景图片，最小5kb，最大5m（暂不限制图片宽高），图片格式必须为：png、bmp、gif、jpg、jpeg
【示例值】-
shop_sign_board_pic可选byte[](5242880)
【描述】店铺门头照图片，最小5kb，最大5m（暂不限制图片宽高），图片格式必须为：png、bmp、gif、jpg、jpeg
【示例值】-
shop_name可选string(256)
【描述】店铺名称
【示例值】-
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(20)
【描述】经度，浮点型, 小数点后最多保留6位。 如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：
【示例值】120.760001
latitude可选string(20)
【描述】纬度，浮点型,小数点后最多保留6位 如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：
【示例值】60.270001
business_license_mobile可选string(11)
【描述】上传非经营者本人（签约账号）的营业执照时必填，填写营业执照法人支付宝账号对应的手机号。
【示例值】13189652239
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.agent.facetoface.sign&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'batch_no=2017110616474516400082883' \
-f 'mcc_code=a0001_b0199' \
-f 'special_license_pic=@/home/admin/test.jpg' \
-f 'rate=0.38' \
-f 'sign_and_auth=false' \
-f 'business_license_no=1532501100006302' \
-f 'business_license_pic=@/home/admin/test.jpg' \
-f 'business_license_auth_pic=@/home/admin/test.jpg' \
-f 'long_term=true' \
-f 'date_limitation=2017-11-11' \
-f 'shop_scene_pic=@/home/admin/test.jpg' \
-f 'shop_sign_board_pic=@/home/admin/test.jpg' \
-f 'shop_name=-' \
-f 'shop_address={
"country_code":"156",
"district_code":"371002",
"detail_address":"xx街道xx小区xx楼xx号",
"latitude":"60.270001",
"city_code":"371000",
"province_code":"370000",
"longitude":"120.760001"
}' \
-f 'business_license_mobile=13189652239' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_agent_facetoface_sign_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| ant_product_conflict | 您已签约此产品，或者同类产品 | 确保批量签约的产品没有冲突 |
| ant_product_dependency_required | 产品之间存在依赖 | 你还未签约支付宝支付产品（如电脑网站支付、手机网站支付、app支付、当面付等），请签约后再开通本产品 |
| batch_is_not_exist | 代商户操作事务编号不存在 | 请检查事务编号是否有效 |
| batch_status_is_final | 事务已经达到终态 | 请确认事务状态是否是 init 状态，submit|cancel|timeout 状态的都是终态，不允许继续进行接口调用。 |
| biz_error | 业务异常业务异常 | 具体失败原因及凯发app官方网站的解决方案，请参考接口返回的描述文案 |
| business_license_pic_risk | 营业执照不合法 | 请检查参数business_license_pic是否是营业执照；营业执照法人姓名是否一致；营业执照法人身份信息是否一致；营业执照是否已过期 |
| check_agds_seller_access_failed | 蚂蚁花呗专享认证不通过，不满足花呗准入规则 | 请检查蚂蚁花呗专享是否认证通过 |
| face_to_face_rate_param_error | 当面付费率参数有误 | 代签约和授权一体即sign_and_auth=true时，费率参数必填 |
| file_format_is_invalid | 文件格式错误 | 请检查文件类型的参数格式 |
| file_size_min_limit | 文件大小低于范围 | 请检查文件类型的参数大小 |
| file_size_out_limit | 文件大小超出范围 | 请检查文件类型的参数大小 |
| invalid_batch_no | 事务编号 batch_no 不能为空 | 事务编号参数 batch_no 不能为空 |
| isv_app_no_order_package | 第三方应用没有挂载该功能包 | 请挂载当面付功能包 |
| isv_app_order_package_empty | 第三方应用没有任何需要签约开通的功能包 | 请挂载当面付功能包 |
| isv_identity_not_satisfy | 当前账户已入驻为服务商，不能签约收钱产品，请更换账号签约 | 请更换账号签约 |
| merchant_need_face_certify | 需要商户完成身份证或人脸认证后，才能代商户签约 | 请联系代签约的商户先完成身份证或人脸认证后后，再代商户签约 |
| merchant_sign_product_in_audit | 签约审核中 | 该商户签约审核中，暂时不能操作，请等签约审核结束后再试！ |
| merchant_sign_product_in_forbidd | 无法进行签约，存在产品签约冲突 | 该商户无法签约当前产品，存在产品签约冲突，不允许执行签约 |
| merchant_state_not_satisfy | 商户被清退或禁止续签，不允许签约 | 请检查商户状态，再重新签约 |
| not_matched_ssu_or_ps | 当面付产品不支持当前类目 | 请检查商户的mcc类目以及填写的经营类目是否准确，请参考商家经营类目中的类目code |
| no_app_permission | appid 不匹配 | appid 不匹配，请检查当前调用的 appid 和创建事务的 appid 是否匹配 |
| pre_auth_invalid_auth_app_id | 订单授权凭证对应被授权应用与接口调用应用不一致 | 请将调用接口的应用id更换成订单授权凭证对应的应用id |
| pre_auth_invalid_auth_ticket | 无效的订单授权凭证，状态失效或已过期 | 订单授权凭证无法使用，请商户重新订购生成新的订单授权凭证使用 |
| pre_auth_invalid_auth_token | 订单授权凭证换取的令牌已失效 | 商户取消了授权或者令牌被刷新，订单授权凭证无法使用 |
| pre_auth_invalid_package | 订单授权凭证中缺少必要的功能包 | 请在三方应用中添加"当面付"功能包，重新发布服务并让商户重新订购，取新的订单授权凭证使用 |
| pre_auth_invoke_api_not_permitte | 该订单授权凭证无权限调用该接口 | 无接口调用权限 |
| risk_advice_error | 商户风险咨询校验失败 | 具体失败原因及凯发app官方网站的解决方案，请参考接口返回的描述文案 |
| shop_sign_board_pic_risk | 门头照不合法 | 请检查参数shop_sign_board_pic是否是门头照 |
| unknown_exception | 系统内部错误，需要技术人员排查 | 请联系客服咨询具体原因 |
| un_support_account_certify_level | 账户未达到认证要求 | 请先联系商家完成账号认证，认证通过后重新签约 |
| un_support_account_type | 不支持的签约账号类型 | 请检查代签约的商家账号类型 |
| user_account_is_block | 商户账号被冻结 | 请检查商户账号是否可用 |
| user_card_balance_pay_closed | 账户余额支付功能已关闭，不能签约该产品 | 商家账户余额功能已关闭，请联系商家开启后重新签约 |