通用场景
三方应用代理签约app支付产品,需要配合开启事务接口使用
公共请求参数
业务请求参数
batch_no必选string(32)
【描述】代商户操作事务编号,通过alipay.open.isv.agent.create接口进行创建。
【示例值】2017110616474516400082883
mcc_code必选string(16)
【描述】所属mcccode,详情可参考
中的“经营类目编码”
【示例值】a_a03_4582
business_license_no必选string(32)
【描述】营业执照号码。
【示例值】1532501100006302
business_license_pic必选byte[](5242880)
【描述】营业执照图片,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【示例值】-
app_name必选string(32)
【描述】商户的app应用名称
【示例值】应用名称
app_status必选string(128)
【描述】应用上架状态,枚举值为 已上线,未上线
【枚举值】
已上线: online
未上线: offline
【示例值】online
app_market必选string[](128)
【描述】应用在哪些市场上架,枚举值为:苹果,应用宝,华为,360,小米,豌豆荚,其他
【枚举值】
苹果: 苹果
应用宝: 应用宝
华为: 华为
【示例值】应用宝
trade_scene|交易场景必选string(20)
【描述】传参:mobile,代表交易场景是移动设备
【枚举值】
移动设备: mobile
【示例值】mobile
mobile_type|移动设备类型必选string(10)
【描述】传参:app,代表设备类型是app
【枚举值】
app: app
【示例值】app
special_license_pic特殊可选byte[](5242880)
【描述】企业特殊资质图片,可参考
中的“需要的特殊资质证书”,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【示例值】-
app_home_screenshot|应用凯发k8官方网娱乐官方首页截图特殊可选byte[](5242880)
【描述】应用凯发k8官方网娱乐官方首页截图,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【必选条件】当app_status为offline时,必传
【示例值】-
app_pay_screenshot|应用内支付页截图特殊可选byte[](5242880)
【描述】应用内支付页截图,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【必选条件】当app_status为offline时,必传
【示例值】-
app_item_screenshot|商品或服务页截图特殊可选byte[](5242880)
【描述】商品或服务页截图,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【必选条件】当app_status为offline时,必传
【示例值】-
business_license_auth_pic可选byte[](5242880)
【描述】营业执照授权函图片,个体工商户如果使用总公司或其他公司的营业执照认证需上传该授权函图片,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【示例值】-
long_term可选boolean(1)
【描述】营业期限是否长期有效
【示例值】true
date_limitation可选string(10)
【描述】营业期限
【示例值】2017-11-11
app_demo可选byte[](5242880)
【描述】app demo,格式为.apk;或者应用说明文档, 格式为.doc .docx .pdf格式
【示例值】-
app_auth_pic可选byte[](5242880)
【描述】app授权函图片,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【示例值】-
app_type可选string[](128)
【描述】应用类型,枚举值为:ios,安卓
【枚举值】
ios: ios
安卓: 安卓
【示例值】安卓
app_test_account可选string(128)
【描述】可以登录该应用的测试账户
【示例值】testaccount
app_test_account_password可选string(128)
【描述】可以登录此应用的账户的密码。对应app_test_account的登录密码
【示例值】testpassword
home_screenshot可选byte[](5242880)
该参数已废弃
该参数已经不再使用,请使用app_home_screenshot
【描述】应用凯发k8官方网娱乐官方首页截图,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【示例值】-
in_app_screenshot可选byte[](5242880)
【描述】应用内截图,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【示例值】-
pay_screenshot可选byte[](5242880)
该参数已废弃
该参数已经不再使用,请使用app_pay_screenshot
【描述】应用内支付页截图,最小5kb,图片格式必须为:png、bmp、gif、jpg、jpeg
【示例值】-
download_link可选string(512)
【描述】应用下载链接
【示例值】http://demo.com/demo.apk
business_license_mobile可选string(11)
【描述】营业执照法人手机号码
【示例值】13189652239
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.agent.mobilepay.sign&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'batch_no=2017110616474516400082883' \
-f 'app_type=["安卓"]' \
-f 'app_home_screenshot=@/home/admin/test.jpg' \
-f 'business_license_auth_pic=@/home/admin/test.jpg' \
-f 'date_limitation=2017-11-11' \
-f 'mobile_type=app' \
-f 'app_item_screenshot=@/home/admin/test.jpg' \
-f 'long_term=true' \
-f 'business_license_mobile=13189652239' \
-f 'app_name=应用名称' \
-f 'special_license_pic=@/home/admin/test.jpg' \
-f 'business_license_pic=@/home/admin/test.jpg' \
-f 'download_link=http://demo.com/demo.apk' \
-f 'app_demo=@/home/admin/test.jpg' \
-f 'app_status=online' \
-f 'business_license_no=1532501100006302' \
-f 'in_app_screenshot=@/home/admin/test.jpg' \
-f 'app_auth_pic=@/home/admin/test.jpg' \
-f 'app_test_account=testaccount' \
-f 'app_test_account_password=testpassword' \
-f 'trade_scene=mobile' \
-f 'mcc_code=a_a03_4582' \
-f 'app_market=["应用宝"]' \
-f 'app_pay_screenshot=@/home/admin/test.jpg'
说明:本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_agent_mobilepay_sign_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试 |
admit_order_no_pass | 代商户签约预校验不通过 | 商户签约预校验不通过,该商户没有资质或存在签约中订单或该渠道没有面向该商家开放 |
admit_order_no_pass | 代商户签约校验不通过 | 代商户签约校验不通过,具体原因请参考接口返回信息 |
ant_product_conflict | 您已签约此产品,或者同类产品 | 确保批量签约的产品没有冲突 |
ant_product_dependency_required | 产品之间存在依赖 | 你还未签约支付宝支付产品(如电脑网站支付、手机网站支付、app支付、当面付等),请签约后再开通本产品 |
batch_is_not_exist | 代商户操作事务编号不存在 | 请检查事务编号是否有效 |
batch_status_is_final | 事务已经达到终态 | 请确认事务状态是否是 init 状态,submit|cancel|timeout 状态的都是终态,不允许继续进行接口调用。 |
check_agds_seller_access_failed | 蚂蚁花呗专享认证不通过,不满足花呗准入规则 | 请检查蚂蚁花呗专享是否认证通过 |
file_format_is_invalid | 文件格式错误 | 请检查文件类型的参数格式 |
file_size_min_limit | 文件大小低于范围 | 请检查文件类型的参数大小 |
file_size_out_limit | 文件大小超出范围 | 请检查文件类型的参数大小 |
invalid_batch_no | 事务编号 batch_no 不能为空 | 事务编号参数 batch_no 不能为空 |
isv_app_no_order_package | 第三方应用没有挂载该功能包 | 请挂载app支付功能包 |
isv_app_order_package_empty | 第三方应用没有任何需要签约开通的功能包 | 请挂载app支付功能包 |
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 | 没有可以签约的产品 | 没有可以签约的产品 |
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 | 订单授权凭证中缺少必要的功能包 | 请在三方应用中添加"app支付"功能包,重新发布服务并让商户重新订购,取新的订单授权凭证使用 |
pre_auth_invoke_api_not_permitte | 该订单授权凭证无权限调用该接口 | 无接口调用权限 |
product_no_openable_permission_set | 当前签约产品不存在可开通的权限集 | 抱歉,当前产品暂未开放任何可签约的权限集 |
un_support_account_certify_level | 账户未达到认证要求 | 请先联系商户完成账号认证,认证通过后重新签约 |
un_support_account_type | 不支持的签约账号类型 | 请检查代签约的商家账号类型 |
user_card_balance_pay_closed | 账户余额支付功能已关闭,不能签约该产品 | 商家账户余额功能已关闭,请联系商家开启后重新签约 |