开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
第三方应用 
开发 > 服务端 > 第三方应用产品 > 代开发核心api包 > api 列表 > 代签约app支付产品接口
文档更新记录 >
收藏
订阅更新
我的文档
设置
三方应用代理签约app支付产品,需要配合开启事务接口使用

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.open.agent.mobilepay.sign
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40

业务请求参数

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' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

无业务响应参数
响应示例
{
    "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_permissionappid 不匹配
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账户余额支付功能已关闭,不能签约该产品
商家账户余额功能已关闭,请联系商家开启后重新签约
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图