本文档主要说明服务商如何从零开始，使用开放平台服务端 SDK 快速完成代商家发起当面付开通申请的过程。

说明：

文档中的示例代码是用来阐述 API 基本使用方法的，仅针对大众场景，供服务商参考，特殊情况还请服务商自行扩展，确保符合自身业务需求。

产品政策答疑、开通审核超时、开通申请被驳回等问题，可拨打 4007585858 咨询。

原 能力签约 统一升级为 产品开通。

添加当面付产品

服务商登录支付宝开放平台，在 第三方应用详情 > 产品绑定，点击 绑定产品 按钮，在功能列表中添加 当面付 和 代开发核心 API 包。

注意：协助商家开通 当面付 产品之前需要确定商家符合准入条件并具备开通所需资质，具体说明，可查看当面付产品介绍。

代商家提交开通申请

代商家提交资料

服务商可以通过开放平台提供的接口，代替商家提交开通资料，代商家开通的接口调用顺序如下图。

说明：原 能力签约 统一升级为 产品开通。

通过 alipay.open.agent.create（开启代商户开通、创建应用事务）接口创建应用事务，返回生成 batch_no。

通过 alipay.open.agent.facetoface.sign（协助商家申请开通当面付产品）接口代替商家开通当面付收单产品，传入第一步生成的 batch_no 参数。

通过 alipay.open.agent.confirm （提交代商户开通、创建应用事务）接口提交事务，同样需要传入第一步生成的 batch_no 参数。

通过 alipay.open.agent.order.query（查询申请单状态）查询代开通的结果，审核时间通常是在 1 个工作日左右。

说明：

一个事务编号 batch_no 不支持提交多个产品开通，开启一次事务，只可为一个产品提交开通申请。

查询到申请单状态为 MERCHANT_CONFIRM，即申请信息审核通过，等待商家确认开通。

代申请开通流程接口不需要传入 app_auth_token。

若开通申请未通过，支付宝不会通知商家。建议提交后 5 分钟进行第一次查询，之后每过 4 小时查询一次。如果 MERCHANT_AUDITING（审核中）的状态持续时间超过 1 个工作日，请服务商联系支付宝客服电话 4007585858。

调用 alipay.open.agent.facetoface.sign（协助商家申请开通当面付产品）接口时，sign_and_auth 设置为 true，则开通申请通过后触发应用授权，系统会通过异步消息发送授权通知到第三方应用开发配置里所填写的应用网关。授权通知包含商家授权的 app_auth_token，是服务商代商家发起交易的必须要素，一定要妥善保管，若遗忘，找回方式可查看 [快速查看授权 token](https://opendocs.alipay.com/mini/isv/tc5oo0#快速查看授权 token)。

产品开通结果通知

产品开通审核通过后，可通过如下方式获取到审核结果：

支付宝会发送待办消息到商家的支付宝 App-消息-消息盒子和商家平台（b.alipay.com）-站内信-待办。商家也可以在支付宝 App 搜索“商家平台消息中心”小程序，找到待办消息。

服务商也可通过 alipay.open.agent.order.query（查询申请单状态）接口查询到审核通过后，联系商家进行确认开通。

商家确认

移动端确认

方式一：通过消息盒子找到待办消息

批量确认（推荐）：
商家打开支付宝 App，通过首页-最近消息或消息 Tab 找到 商家平台待办申请待确认 进入消息盒子，再进入待办任务页面。或者通过支付宝 App 扫描二维码（服务商获取到商家确认链接后自行转换到二维码），进入待办页面。点击列表上方的 批量处理 按钮，点击全选按钮后，可批量确认待办。

单个确认：点击某个待办任务，进入待办详情页，勾选协议后点击 确认处理待办 按钮。

方式二：通过商家平台消息中心找到待办消息

商家如果没有找到消息，也可打开支付宝 App，在首页搜索 **商家平台消息中心，**通过该小程序进入待办任务页面，可以进行批量处理或者单个确认，确认步骤同方式一。商家确认开通后，即开通成功。

PC 端确认

商家登录支付宝商家平台（b.alipay.com）> 站内信 > 待办。

批量操作（推荐）

点击列表上方的 批量处理 按钮。

勾选全选选择框或选择需要确认的申请后，同意协议，即可批量确认待办。

单个确认

点击待办消息后面的 去处理 按钮，进入待办详情页，勾选协议后，点击 确认处理待办 按钮。

服务商邀请商家确认

服务商也可以通过 alipay.open.agent.order.query （查询申请单状态）接口查询到申请单状态为 MERCHANT_CONFIRM，即等待商家确认状态，可通过 confirm_url 字段获取商家确认链接，服务商可以将链接自行转成二维码后，邀请商家扫码进行产品开通确认。

代商家发起交易

在完成代开通之后，服务商开发者可以代商家调用支付接口，发起一笔交易，体验支付接入流程，可查看小程序支付第三方接入。

注意：服务商在代商家调用接口时，在请求参数中请务必带上 app_auth_token，否则支付宝将认为是本应用替自己发起的请求，开发者使用 request.putOtherTextParam 方法传入 app_auth_token。

以服务商代商家调用 alipay.trade.query（统一收单交易查询接口）为例，示例代码如下。

AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , "第三方应用APPID" , "第三方应用 private_key" , "json" , "GBK" , "alipay_public_key" , "RSA2" );
 AlipayTradeQueryRequest request = new AlipayTradeQueryRequest ();
 request.putOtherTextParam( "app_auth_token", "201912BXXXXXX" );   //此处传入商家应用授权第三方应用的 app_auth_token 
 request.setBizContent( "{"   + 
 "\"out_trade_no\":\"20150320010101001\","   + 
 "\"trade_no\":\"2014112611001004680 073956707\","   + 
 "\"org_pid\":\"2088101117952222\","   + 
 "      \"query_options\":["   + 
 "        \"TRADE_SETTLE_INFO\""   + 
 "      ]"   + 
 "  }" );
 AlipayTradeQueryResponse  response = alipayClient.execute (request);
 if (response.isSuccess()){
 System.out.println("调用成功");
 }  else{
 System.out.println("调用失败");
 }

上线应用

应用开发完成后，请开发者自行进行验收和安全性检查（安全性检查可查看开放平台第三方应用安全开发指南），验收检查完成后，可申请上线，上线成功后，状态变为已上线，这个状态下的应用能够调用生产环境的接口。

详情可查看上线应用步骤。

调用接口代商家发起开通当面付申请

添加当面付产品#

代商家提交开通申请#

代商家提交资料#

产品开通结果通知#

商家确认#

移动端确认#

方式一：通过消息盒子找到待办消息#

方式二：通过商家平台消息中心找到待办消息#

PC 端确认#

批量操作（推荐）#

单个确认#

服务商邀请商家确认#

代商家发起交易#

上线应用#