开启代商户签约、创建应用事务

开发环境

http://dev-cn.your-api-server.com

POST

/v3/alipay/open/agent/create

alipay.open.agent

在 ISV 代商户进行应用创建、产品签约时，用于开启一个操作事务，必须是第一个调用的接口。场景1：ISV 代商户进行应用创建、产品签约，最后提交事务后需要商户确认才能完成流程；场景2：服务市场订购及授权，使用订单授权凭证order_ticket开启预授权模式，该模式下提交事务后无需商户确认。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/agent/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contact_info": {
        "contact_email": "zhangsan@alipy.com",
        "contact_mobile": "18866668888",
        "contact_name": "张三"
    },
    "account": "test@alipay.com",
    "order_ticket": "00ee2d475f374ad097ee0f1ac223fX00",
    "sign_mode": "BATCH_SIGN_NOT_NOTIFY"
}'

响应示例

200 - 示例 1

{
    "batch_no": "2017110616474516400082883",
    "batch_status": "init"
}

请求参数

Body 参数application/json

contact_info

object (ContactModel)

可选

contact_email

string

联系人邮箱

可选

示例值:

zhangsan@alipy.com

contact_mobile

string

联系人手机号码

可选

示例值:

18866668888

contact_name

string

联系人名称

可选

示例值:

张三

account

string

可选

isv代操作的商户账号，可以是支付宝账号，也可以是pid（2088开头）

示例值:

test@alipay.com

order_ticket

string

可选

订单授权凭证。若传入本参数，则对应事务提交后进入预授权模式。

示例值:

00ee2d475f374ad097ee0f1ac223fX00

sign_mode

string

可选

签约模式：目前只支持批量签约并不通知商户确认使用场景：批量签约并授权场景，先调用签约接口进行签约，然后调用授权接口授权，在批量模式下，一次性签约多个产品，要么都成功要么都失败，同时在授权接口传入orderNo，会一起发送签约确认和授权确认，商户只需要确认一次；如果不是批量签约并授权场景，不要传此参数，否则商户无法收到确认签约通知；

示例值:

BATCH_SIGN_NOT_NOTIFY

示例

返回响应

🟢200common response

application/json

Body

batch_no

string

可选

本次代商户操作的全局唯一事务编号，后续代商户创建小程序、代签约当面付等产品、提交事务等接口都需要传递该batch_no值，且要确认只有 init 状态的batch_no才能发起调用。

示例值:

2017110616474516400082883

batch_status

string

可选

ISV 代商户操作事务状态，事务状态包括： init=初始状态，本接口alipay.open.agent.create返回 init 状态，只有init状态允许进行各种业务接口调用； submit=提交状态，事务已经到达终态，调用alipay.open.agent.confirm接口可以提交init状态的事务 cancel=取消状态，事务已经到达终态，调用alipay.open.agent.cancel接口可以取消init状态的事务 timeout=超时状态，事务已经到达终态，init状态的事务，在【1个小时】后会自动超时注意：只有 init 状态才允许进行接口调用，其它状态都是终态，不允许继续进行接口调用。

示例值:

init

🔴500请求失败

修改于 2023-11-27 03:50:48

查询商户某个产品的签约状态

代商户签约，提交信息确认接口