本文档详细讲解了使用蚂蚁金服开放平台服务端SDK快速接入当面资金授权产品的方法。
阅读对象:ISV的技术开发人员。
ISV首先必须入驻开放平台,服务商入驻请参考入驻指引。
要在您的应用中使用支付宝开放产品的接口能力,您需要先去蚂蚁金服开放平台(open.alipay.com),在管理中心中创建登记您的应用,并提交审核,审核通过后会为您生成应用唯一标识(APPID),并且可以申请开通开放产品使用权限,通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。
开发者调用接口前需要先生成RSA密钥,RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY)。生成密钥后在开放平台管理中心进行密钥配置,配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详细步骤请参考《配置应用环境》。
为了帮助开发者调用开放接口,我们提供了开放平台服务端SDK,包含JAVA、PHP和.NET三语言版本,封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。
各语言版本服务端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接口测试流程相同,详见:https://doc.open.alipay.com/doc2/detail.htm?treeId=200&articleId=105311&docType=1
1、冻结转支付后如果有剩余冻结金额要求系统中立即操作解冻,同时后台要开放人工单独解冻的入口,防止后续商户投诉能方便操作解冻。
2、冻结资金要大于未来消费转支付金额,目前接口不支持追加冻结。
3、alipay.trade.pay接口中需要传入store_id、terminal_id参数。如果是系统商接入还需要传入"extend_params":{"sys_service_provider_id":"ISV签约账户的PID"}参数。