提交代商户签约、创建应用事务接口 -凯发app官方网站

支持第三方代理调用

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

订阅更新

我的文档

设置

通用场景

提交事务。只允许提交init状态的事务，submit|cancel|timeout 状态的都是终态，不允许提交，且不允许提交空事务，需要先调用代创建小程序、代签约当面付等业务接口，再提交事务。服务市场订购及授权，使用订单授权凭证order_ticket开启的事务，提交后会有应用授权令牌返回。

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.agent.confirm
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	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

batch_no必选string(25)

【描述】isv 代商户操作事务编号，通过调用alipay.open.agent.create(开启代商户签约、创建应用事务)接口返回，详见 https://opendocs.alipay.com/apis/api_50/alipay.open.agent.create/ 。

【示例值】2017110616474516400082883

参数	类型	是否必选	最大长度	描述	示例值
batch_no	string	必选	25	isv 代商户操作事务编号，通过调用alipay.open.agent.create(开启代商户签约、创建应用事务)接口返回，详见 https://opendocs.alipay.com/apis/api_50/alipay.open.agent.create/ 。	2017110616474516400082883

常见请求示例

默认示例

curljavac#php

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.agent.confirm&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'biz_content={
	"batch_no":"2017110616474516400082883"
}'

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
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=

业务响应参数

user_id特殊可选string(16)

【描述】授权商户的user_id

新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。

【示例值】2088102150527498

open_id｜开放id特殊可选string(128)

【描述】授权商户的user_id 详情可查看 openid简介

【示例值】074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5

auth_app_id特殊可选string(20)

【描述】授权商户的appid

【示例值】2013121100055554

app_auth_token特殊可选string(40)

【描述】应用授权令牌

【示例值】201509bbeff9351ad1874306903e96b91d248a36

app_refresh_token特殊可选string(40)

【描述】刷新令牌

【示例值】201509bbdcba1e3347de4e75ba3fed2c9abebe36

expires_in特殊可选string(16)

【描述】应用授权令牌的有效时间（从接口调用时间作为起始时间），单位到秒

【示例值】123456

re_expires_in特殊可选string(16)

【描述】刷新令牌的有效时间（从接口调用时间作为起始时间），单位到秒

【示例值】123456

order_no可选string(64)

【描述】签约单号，如果是签约必返回

【示例值】20211020034000100000027428505085

参数	类型	是否必选	最大长度	描述	示例值
user_id	string	特殊可选	16	授权商户的user_id 新商户建议使用open_id替代该字段。对于新商户，user_id字段未来计划逐步回收，存量商户可继续使用。如使用open_id，请确认应用-开发配置-openid配置管理已启用。无该配置项，可查看openid配置申请。	2088102150527498
open_id	string	特殊可选	128	授权商户的user_id 详情可查看 openid简介	074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5
order_no	string	可选	64	签约单号，如果是签约必返回	20211020034000100000027428505085
auth_app_id	string	特殊可选	20	授权商户的appid	2013121100055554
app_auth_token	string	特殊可选	40	应用授权令牌	201509bbeff9351ad1874306903e96b91d248a36
app_refresh_token	string	特殊可选	40	刷新令牌	201509bbdcba1e3347de4e75ba3fed2c9abebe36
expires_in	string	特殊可选	16	应用授权令牌的有效时间（从接口调用时间作为起始时间），单位到秒	123456
re_expires_in	string	特殊可选	16	刷新令牌的有效时间（从接口调用时间作为起始时间），单位到秒	123456

响应示例

正常示例

异常示例

{
    "alipay_open_agent_confirm_response": {
        "code": "10000",
        "msg": "success",
        "user_id": "2088102150527498",
        "open_id": "074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5",
        "order_no": "20211020034000100000027428505085",
        "auth_app_id": "2013121100055554",
        "app_auth_token": "201509bbeff9351ad1874306903e96b91d248a36",
        "app_refresh_token": "201509bbdcba1e3347de4e75ba3fed2c9abebe36",
        "expires_in": "123456",
        "re_expires_in": "123456"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}