第一步：创建应用

要在您的应用中使用支付宝开放产品的接口能力，您需要先去蚂蚁金服开放平台（open.alipay.com），在管理中心中创建登记您的应用，并提交审核，审核通过后会为您生成应用唯一标识（APPID），并且可以申请开通开放产品使用权限，通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。

第二步：配置密钥

开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台管理中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详情请参考《配置应用环境》。

第三步：搭建和配置开发环境

1. 下载服务端sdk

开发语言	资源下载	环境要求
JAVA版资源	SDK1.5	适用于Java语言、jdk版本1.5及以上的开发环境
	SDK1.4	适用于Java语言、jdk版本1.4及以下的开发环境
.NET版资源	SDK	适用于Visual studio 2010及以上版本、Framework3.5及以上版本的开发环境
PHP版资源	SDK	适用于php全系列开发环境

各语言版本服务端SDK详细使用说明，请参考《服务端SDK使用说明》

  2.接口调用配置

在SDK调用前需要进行初始化，Java代码示例如下：

AlipayClient alipayClient = new DefaultAlipayClient(https://openapi.alipay.com/gateway.do,APP_ID,APP_PRIVATE_KEY,FORMAT,CHARSET,APP_PUBLIC_KEY);

关键参数说明:

配置参数	示例值解释	获取方式/示例值
URL	支付宝网关（固定）	https://openapi.alipay.com/gateway.do
APPID	APPID 即创建应用后生成	获取见上面创建应用
FORMAT	参数返回格式，只支持json	json（固定）
APP_PRIVATE_KEY	开发者私钥，由开发者自己生成	获取详见上面配置密钥
CHARSET	编码集，支持GBK/UTF-8	开发者根据实际工程编码配置
ALIPAY_PUBLIC_KEY	支付宝公钥，由支付宝生成	获取详见上面配置密钥

第四步调用接口

• 代签约产品

1.服务商代签约后台：无需开发，由服务商操作人员来填写已收集好的商户签约信息。服务商后台有相关填写信息的样例，明确的错误提示信息，因此，有利于签约效率，推荐使用此方法代商户签约。具体操作请点击：服务商后台代签约 

 2.邀约商家签约：服务商在创建应用后，会生成唯一一个邀约链接，由服务商操作人员或者商户将来填写签约信息。具体操作请点击：邀约商家签约 签约资料

3.接口代理签约

1.调用流程：

说明：

1.1商户登陆服务商app或后台，判断是否签约，签约则返回签约结果。

1.2未签约则发起签约请求，请求时注意login_id或out_biz_no做好记录，后面会根据签约数据中login_id或out_biz_no与第三方应用授权做关联。

1.3通过签约查询接口获取签约结果并通知商户签约结果。

2.接口代理签约说明：快速接入

3.接口列表：

接口英文名	接口中文名	API文档
ant.merchant.expand.image.upload	专用图片资料上传接口	商家签约服务API文档下载
ant.merchant.expand.enterprise.apply	企业级商户入驻申请接口
ant.merchant.expand.personal.apply	个体工商户入驻申请接口
ant.merchant.expand.mapplyorder.query	入驻申请单查询接口

• 第三方应用授权

   1. 调用流程：

     说明：

     1.1商户通过isv生成的应用用授权二维码，进行扫码授权。

     1.2获取商户授权获取app_auth_code，同时通过授权返回参数关联签约账号。

     1.3通过app_auth_code，再调用alipay.open.auth.token.app获取取app_auth_token。

     1.4商户授权成功。isv可代商户调用当面付收单等相关接口。

    2.授权账号与签约账号关联实现方式。isv通过授权链接终端redirect_url参数设置返回url，url上设置一个商户在isv端的唯一标识与授权账号关联，同时这个唯一标识也与签约账号关联。从而授权账号与签约账号可关联上。譬如：代签约接口中的login_id或者其他唯一标识参数，可以放到授权返回redirect_url所带的参数里面。

    授权链接：https://openauth.alipay.com/oauth2/appToAppAuth.htm?app_id=APPID&redirect_uri=ENCODED_URL

    样例：https://openauth.alipay.com/oauth2/appToAppAuth.htm?app_id=APPID&redirect_uri=https://b.alipay.com?login_id=****。redirect_uri这个参数的url建议配置isv端的服务端登陆页面地址。商户登陆成功后，将商户的唯一标识login_id与登陆uid关联，从而将签约商户与授权商户关联起来。

    3.获取的app_auth_token用于代商户调收单接口。对应到授权的商户，从而确定收款账号。因此，调用当面付接口时，只有传了app_auth_token支付金额才能到商家账号，否则资金进入到app_id对应的pid账号。

    4.换取授权访问令牌。开发者可通过获取到的app_auth_code换取app_auth_token和商户的userId以及AppId。app_auth_code作为换取app_auth_token的票据，每次商户授权带上的app_auth_code将不一样，app_auth_code只能使用一次，一天（从生成app_auth_code开始的24小时）未被使用自动过期。app_auth_token有效期为365天，并且可以被无限次刷新

    5.第三方应用授权使用场景说明。主要是在支付宝客户端中使用。因此，授权场景有两种，一种是把授权链接生成一个二维码，让商户通过支付宝钱包扫一扫的功能进行扫码授权（具体将二维码图片保存，然后用支付宝钱包扫一扫，自识别二维码进行授权，这种方式isv用的较多）；另一种是通过服务窗里面建一个商户授权菜单，商户访问isv的服务窗。切记第三方应用授权不可以从商户的app访问。

   6.详见第三方应用授权

   7.Api列表

接口英文名	接口中文名
alipay.open.auth.token.app	授权访问令牌
alipay.open.auth.token.app.query	授权令牌查询接口

• 当面付收款

当面付收款从商户收款方式（条码支付、扫码支付）、资金流、对账等方面进行说明。请点击当面付收款。

第五步验收上线

       整个方案中，代签约产品由于资料的真实性，只能由商户端自行验收，如果能提供我们截图最好。第三方应用授权流程顺畅并截图，主要验收当面付收款。当面付收款，涉及到店内截图请商户提供，业务逻辑可以使用云验收。云验收操作

FAQ

关于此文档暂时还没有FAQ