快速接入

本文档详细讲解了使用支付宝开放平台服务端SDK快速接入当面资金授权产品的方法。
阅读对象:ISV的技术开发人员。

第一步:ISV入驻开放平台

ISV首先必须入驻开放平台,服务商入驻请参考入驻指引。

第二步:创建应用并获取APPID

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

第三步:配置密钥

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

第四步:搭建和配置开发环境

1. 下载服务端SDK

为了帮助开发者调用开放接口,我们提供了开放平台服务端SDK,包含JAVA、PHP和.NET三语言版本,封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。

2. 接口调用配置

各语言版本服务端SDK详细使用说明,请参考《服务端SDK使用说明
在使用SDK调用具体API前,进行初始化,代码如下:

AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);
配置参数 示例值解释 获取方式/示例值
URL 支付宝网关(固定) https://openapi.alipay.com/gateway.do
APP_ID APPID即创建应用后生成 获取见上面创建应用并获取APPID
APP_PRIVATE_KEY 开发者应用私钥,由开发者自己生成 获取见上面配置密钥
FORMAT 参数返回格式,只支持json json(固定)
CHARSET 请求和签名使用的字符编码格式,支持GBK和UTF-8 开发者根据实际工程编码配置
ALIPAY_PUBLIC_KEY 支付宝公钥,由支付宝生成 获取详见上面配置密钥
SIGN_TYPE 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2

第五步:接口调用

1、第三方应用授权接口调用:服务商代商户发起当面资金授权接口功能调用. 了解更多第三方授权
2、当面资金授权接口调用:详见文档接口详解部分。具体接口调用样例代码在接口文档中均已给出,此处不再赘述。

第六步:接口测试

支持沙箱环境和线上环境。
接口测试流程和普通2.0接口测试流程相同。

第七步:验收上线

1、冻结转支付后如果有剩余冻结金额要求系统中立即操作解冻,同时后台要开放人工单独解冻的入口,防止后续商户投诉能方便操作解冻。
2、冻结资金要大于未来消费转支付金额,目前接口不支持追加冻结。
3、alipay.trade.pay接口中需要传入store_id、terminal_id参数。如果是系统商接入还需要传入"extend_params":{"sys_service_provider_id":"ISV签约账户的PID"}参数。
 
 

onlineServer