支付宝手机网站接入1

用户已安装支付宝支付流程

步骤1:用户在浏览器中访问商家网页应用,选择商品下单、确认购买,进入支付环节,选择支付宝付款,用户点击去支付,如下图1;

步骤2:进入到支付宝支付路由页面,支付宝处理支付请求,并尝试唤起支付宝客户端,如下图2;

步骤3:进入到支付宝页面,调起支付宝支付,出现确认支付界面,如下图3;

图1:

2:

图3:

步骤4:用户确认收款方和金额,点击立即支付后出现输入密码界面,如下图4;

步骤5:输入正确密码后,支付宝端显示支付结果,如下图5;

步骤6:自动回跳到浏览器中,商家根据付款结果个性化展示订单处理结果,如下图6。

图4:
图5:
图6:

用户未安装支付宝支付流程

步骤1:若用户未安装支付宝客户端,用户进入到支付宝网页收银台,用户登录支付宝账户,如图7和图8;

步骤2:登录成功后,进入付款确认页面,如图9;

步骤3:用户点击确认付款,进入支付密码页面,如图10;

步骤4:用户输入密码,完成支付,展示支付结果,如图11。

图7:
图8:
图9:
图10:
图11:

应用案例

1. 目前已上线的部分支付案例,商家可在浏览器中访问对应商家网站,进行实际体验。

饿了么、携程、亚马逊APP。

2. 支付宝收银台界面规范

列表首位+默认勾选+Logo+推荐标签+标语,最低标准为“Logo+支付宝”,并将作为审核依据。

3. 支付宝Logo、收银台素材下载

 

 

第一步:创建应用并获取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前,进行初始化,代码如下:

1
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_IDAPPID即创建应用后生成获取见上面创建应用并获取APPID
APP_PRIVATE_KEY开发者应用私钥,由开发者自己生成获取见上面配置密钥
FORMAT参数返回格式,只支持jsonjson(固定)
CHARSET请求和签名使用的字符编码格式,支持GBK和UTF-8开发者根据实际工程编码配置
ALIPAY_PUBLIC_KEY支付宝公钥,由支付宝生成获取详见上面配置密钥
SIGN_TYPE商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2RSA2

接下来,就可以用alipayClient来调用具体的API了。alipayClient只需要初始化一次,后续调用不同的API都可以使用同一个alipayClient对象。

TIPS:手机网站支付不支持第三方授权,不能代商家发起请求。

第四步:调用接口

手机网站支付产品包含两类API:

  • 页面跳转类:需要从前端页面以Form表单的形式发起请求,浏览器会自动跳转至支付宝的相关页面(一般是收银台或签约页面),用户在该页面完成相关业务操作后再回跳到商户指定页面。例如本产品中的手机网站支付接口alipay.trade.wap.pay
  • 系统调用类:直接从服务端发起HTTP请求,支付宝会同步返回请求结果。例如本产品中的交易查询等配套API。

调用流程

调用流程

如上图所示,用户在商户的H5网站下单支付后,商户系统按照手机网站支付接口alipay.trade.wap.payAPI的参数规范生成订单数据,然后在前端页面通过Form表单的形式请求到支付宝。此时支付宝会自动将页面跳转至支付宝H5收银台页面,如果用户手机上安装了支付宝APP,则自动唤起支付宝APP。开发者需要关注安装了支付宝和未安装支付宝的两种测试场景,对于在手机浏览器唤起H5页面的模式下,如果安装了支付宝却没有唤起,大部分原因是当前浏览器不在支付宝配置的白名单内,对于商户app内嵌webview中的支付场景,建议集成支付宝App支付产品。

用户在支付宝APP或H5收银台完成支付后,会根据商户在手机网站支付API中传入的前台回跳地址return_url自动跳转回商户页面,同时在URL请求中以Query String的形式附带上支付结果参数,详细回跳参数见“手机网站支付接口alipay.trade.wap.pay”前台回跳参数

同时,支付宝还会根据原始支付API中传入的异步通知地址notify_url,通过POST请求的形式将支付结果作为参数通知到商户系统,详情见支付结果异步通知

除了正向支付流程外,支付宝也提供交易查询、关闭、退款、退款查询以及对账等配套API。

特别注意:

  • 由于前台回跳的不可靠性,前台回跳只能作为商户支付结果页的入口,最终支付结果必须以异步通知或查询接口返回为准,不能依赖前台回跳。
  • 商户系统接收到异步通知以后,必须通过验签(验证通知中的sign参数)来确保支付通知是由支付宝发送的。详细验签规则参考异步通知验签
  • 接受到异步通知并验签通过后,一定要检查通知内容,包括通知中的app_id, out_trade_no, total_amount是否与请求中的一致,并根据trade_status进行后续业务处理。

使用SDK快速接入

手机网站支付alipay.trade.wap.pay:
对于页面跳转类API,SDK不会也无法像系统调用类API一样自动请求支付宝并获得结果,而是在接受request请求对象后,为开发者生成前台页面请求需要的完整form表单的html(包含自动提交脚本),商户直接将这个表单的String输出到http response中即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
public void doPost(HttpServletRequest httpRequest,
                       HttpServletResponse httpResponse) throws ServletException, IOException {
     AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
     AlipayTradeWapPayRequest alipayRequest = new AlipayTradeWapPayRequest(); //创建API对应的request
     alipayRequest.setReturnUrl( "http://domain.com/CallBack/return_url.jsp" );
     alipayRequest.setNotifyUrl( "http://domain.com/CallBack/notify_url.jsp" );//在公共参数中设置回跳和通知地址
     alipayRequest.setBizContent( "{" +
         "    \"out_trade_no\":\"20150320010101002\"," +
         "    \"total_amount\":\"88.88\"," +
         "    \"subject\":\"Iphone6 16G\"," +
         "    \"seller_id\":\"2088123456789012\"," +
         "    \"product_code\":\"QUICK_WAP_PAY\"" +
         "  }" ); //填充业务参数
     String form= "" ;
     try {
         form = alipayClient.pageExecute(alipayRequest).getBody(); //调用SDK生成表单
     } catch (AlipayApiException e) {
         e.printStackTrace();
     }
     httpResponse.setContentType( "text/html;charset=" + CHARSET);
     httpResponse.getWriter().write(form); //直接将完整的表单html输出到页面
     httpResponse.getWriter().flush();
     httpResponse.getWriter().close();
}

关键入参:

参数名称参数说明
out_trade_no商户订单号,需要保证不重复
subject订单标题
seller_id实际收款账号,一般填写商户PID即可
total_amount订单金额

异步通知验签:

1
2
3
4
5
6
7
Map<String, String> paramsMap = ... //将异步通知中收到的所有参数都存放到map中
boolean signVerified = AlipaySignature.rsaCheckV1(paramsMap, ALIPAY_PUBLIC_KEY, CHARSET, SIGN_TYPE) //调用SDK验证签名
if (signVerfied){
     // TODO 验签成功后,按照支付结果异步通知中的描述,对支付结果中的业务内容进行二次校验,校验成功后在response中返回success并继续商户自身业务处理,校验失败返回failure
} else {
     // TODO 验签失败则记录异常日志,并在response中返回failure.
}

关键通知参数:

参数名称参数说明
trade_no支付宝28位交易号
trade_status交易状态
total_amount订单金额

交易查询接口alipay.trade.query:

1
2
3
4
5
6
7
8
9
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
AlipayTradeQueryRequest request = new AlipayTradeQueryRequest(); //创建API对应的request类
request.setBizContent( "{" +
"    \"out_trade_no\":\"20150320010101001\"," +
"    \"trade_no\":\"2014112611001004680073956707\"" +
"  }" ); //设置业务参数
AlipayTradeQueryResponse response = alipayClient.execute(request); //通过alipayClient调用API,获得对应的response类
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

关键入参:

参数名称参数说明
out_trade_no支付时传入的商户订单号,与trade_no必填一个
trade_no支付时返回的支付宝交易号,与out_trade_no必填一个

关键出参:

参数名称参数说明
trade_no支付宝28位交易号
out_trade_no支付时传入的商户订单号
trade_status交易当前状态

交易退款接口alipay.trade.refund:

1
2
3
4
5
6
7
8
9
10
11
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
AlipayTradeRefundRequest request = new AlipayTradeRefundRequest(); //创建API对应的request类
request.setBizContent( "{" +
"    \"out_trade_no\":\"20150320010101001\"," +
"    \"trade_no\":\"2014112611001004680073956707\"," +
"    \"out_request_no\":\"1000001\"," +
"    \"refund_amount\":\"2014112611001004680073956707\"" +
"  }" ); //设置业务参数
AlipayTradeRefundResponse response = alipayClient.execute(request); //通过alipayClient调用API,获得对应的response类
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

关键入参:

参数名称参数说明
out_trade_no支付时传入的商户订单号,与trade_no必填一个
trade_no支付时返回的支付宝交易号,与out_trade_no必填一个
out_request_no本次退款请求流水号,部分退款时必传
refund_amount本次退款金额

关键出参:

参数名称参数说明
refund_fee该笔交易已退款的总金额

查询对账单下载地址接口alipay.data.dataservice.bill.downloadurl.query:

1
2
3
4
5
6
7
8
9
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" ); //获得初始化的AlipayClient
AlipayDataDataserviceBillDownloadurlQueryRequest request = new AlipayDataDataserviceBillDownloadurlQueryRequest(); //创建API对应的request类
request.setBizContent( "{" +
"    \"bill_type\":\"trade\"," +
"    \"bill_date\":\"2016-04-05\""
"  }" ); //设置业务参数
AlipayDataDataserviceBillDownloadurlQueryResponse response = alipayClient.execute(request);
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

关键入参:

参数名称参数说明
bill_type固定传入trade
bill_date需要下载的账单日期,最晚是当期日期的前一天

关键出参:

参数名称参数说明
bill_download_url账单文件下载地址,30秒有效

下载账单文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
//将接口返回的对账单下载地址传入urlStr
//指定希望保存的文件路径
String filePath = "/Users/fund_bill_20160405.csv" ;
URL url = null ;
HttpURLConnection httpUrlConnection = null ;
InputStream fis = null ;
FileOutputStream fos = null ;
try {
     url = new URL(urlStr);
     httpUrlConnection = (HttpURLConnection) url.openConnection();
     httpUrlConnection.setConnectTimeout( 5 * 1000 );
     httpUrlConnection.setDoInput( true );
     httpUrlConnection.setDoOutput( true );
     httpUrlConnection.setUseCaches( false );
     httpUrlConnection.setRequestMethod( "GET" );
     httpUrlConnection.setRequestProperty( "Charsert" , "UTF-8" );
     httpUrlConnection.connect();
     fis = httpUrlConnection.getInputStream();
     byte [] temp = new byte [ 1024 ];
     int b;
     fos = new FileOutputStream( new File(filePath));
     while ((b = fis.read(temp)) != - 1 ) {
         fos.write(temp, 0 , b);
         fos.flush();
     }
} catch (MalformedURLException e) {
     e.printStackTrace();
} catch (IOException e) {
     e.printStackTrace();
} finally {
     try {
         if (fis!= null ) fis.close();
         if (fos!= null ) fos.close();
         if (httpUrlConnection!= null ) httpUrlConnection.disconnect();
     } catch (IOException e) {
         e.printStackTrace();
     }
}

关于沙箱

如何接入沙箱

沙箱环境是开放平台提供给开发者调试接口的环境,具体操作步骤见 沙箱接入指南

手机网站支付沙箱接入注意点

1、手机网站支付支持沙箱接入;在沙箱调通接口后,必须在线上进行测试与验收,所有返回码及业务逻辑以线上为准;
2、手机网站支付只支持余额支付,不支持银行卡、余额宝等其他支付方式;
3、支付时,请使用沙箱买家账号支付,在登录支付宝,输入手机号的页面,点击右下角 支付宝账户登录;

 

 

 

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

SDK集成

  1. SDK已经对加签验签逻辑做了封装,使用SDK可直接调用API。
  2. 确定接口对应的类
    例如接口名:alipay.offline.material.image.upload
    在SDK中对应的类为:每个单词首字母大写,并去掉分隔符(“.”),末尾加上Request(或Response)
    如上接口名对应的类为:
    AlipayOfflineMaterialImageUploadRequest(请求类)
    AlipayOfflineMaterialImageUploadResponse(响应类)
    具体调用方式见下方各语言。

JavaSDK集成示例

SDK包说明

  • alipay-sdk-java*.jar—————————支付宝SDK编译文件jar
  • alipay-sdk-java*-source.jar——————支付宝SDK源码文件jar
  • commons-logging-1.1.1.jar——————SDK依赖的日志jar
  • commons-logging-1.1.1-sources.jar———SDK依赖的日志源码jar

注意

  • 集成支付宝接口需要引入的文件是:
    alipay-sdk-java*.jar
    commons-logging-1.1.1.jar
  • 若进一步了解代码实现请引入文件:
    alipay-sdk-java*-source.jar
    commons-logging-1.1.1-sources.jar

普通调用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
//实例化客户端
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" );
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.open.public.template.message.industry.modify
AlipayOpenPublicTemplateMessageIndustryModifyRequest request = new AlipayOpenPublicTemplateMessageIndustryModifyRequest();
//SDK已经封装掉了公共参数,这里只需要传入业务参数
//此次只是参数展示,未进行字符串转义,实际情况下请转义
request.setBizContent( "  {" +
"    \"primary_industry_name\":\"IT科技/IT软件与服务\"," +
"    \"primary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_name\":\"IT科技/IT软件与服务\"" +
" }" );
AlipayOpenPublicTemplateMessageIndustryModifyResponse response = alipayClient.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()){
     //.....
}

图片上传接口调用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" );
// 实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.offline.material.image.upload
AlipayOfflineMaterialImageUploadRequest request = new AlipayOfflineMaterialImageUploadRequest();
request.setImageName( "test" );
//Windows请填写绝对路径,不支持相对路径;Linux支持相对路径
FileItem item = new FileItem( "C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg" );
request.setImageType( "JPG" );
request.setImageContent(item);
//执行API请求
AlipayOfflineMaterialImageUploadResponse response = alipayClient.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()){
      //获取图片访问地址
     String imageUrl = response.getImageUrl();
     //.....
}

用户授权接口调用示例

1
2
3
4
5
6
7
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" );
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.user.userinfo.share
AlipayUserUserinfoShareRequest request = new AlipayUserUserinfoShareRequest();
//授权类接口执行API调用时需要带上accessToken
AlipayUserUserinfoShareResponse response= alipayClient.execute(request, "accessToken" );
//业务处理
//...

应用授权接口调用示例(ISV代理商户调用)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
AlipayClient alipayClient = new DefaultAlipayClient( "https://openapi.alipay.com/gateway.do" , APP_ID, APP_PRIVATE_KEY, "json" , CHARSET, ALIPAY_PUBLIC_KEY, "RSA2" );
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.open.public.template.message.industry.modify
AlipayOpenPublicTemplateMessageIndustryModifyRequest request = new AlipayOpenPublicTemplateMessageIndustryModifyRequest();
//SDK已经封装掉了公共参数,这里只需要传入业务参数
//此次只是参数展示,未进行字符串转义,实际情况下请转义
request.setBizContent( "  { " +
"    \"primary_industry_name\":\"IT科技/IT软件与服务\"," +
"    \"primary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_name\":\"IT科技/IT软件与服务\"" +
"  }" );
//ISV代理商户调用需要传入app_auth_token
request.putOtherTextParam( "app_auth_token" , "201511BBaaa6464f271f49e482f2e9fe63ca5F05" );
AlipayOpenPublicTemplateMessageIndustryModifyResponse response = alipayClient.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()){
     //.....
}

.netSDK集成示例

普通调用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
IAopClient client = new DefaultAopClient( "https://openapi.alipay.com/gateway.do" , APPID, APP_PRIVATE_KEY, "json" , "1.0" , "RSA2" , ALIPAY_PUBLIC_KEY, CHARSET, false );
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称如:alipay.open.public.template.message.industry.modify
AlipayOpenPublicTemplateMessageIndustryModifyRequest request = new AlipayOpenPublicTemplateMessageIndustryModifyRequest();
//SDK已经封装掉了公共参数,这里只需要传入业务参数
//此次只是参数展示,未进行字符串转义,实际情况下请转义
request.BizContent= "{" +
"    \"primary_industry_name\":\"IT科技/IT软件与服务\"," +
"    \"primary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_name\":\"IT科技/IT软件与服务\"" +
"  }" ;
AlipayOpenPublicTemplateMessageIndustryModifyResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()){
     //.....
}

图片上传接口调用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
IAopClient client = new DefaultAopClient( "https://openapi.alipay.com/gateway.do" , APPID, APP_PRIVATE_KEY, "json" , "1.0" , "RSA2" , ALIPAY_PUBLIC_KEY, CHARSET, false );
// 实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.offline.material.image.upload
AlipayOfflineMaterialImageUploadRequest request = new AlipayOfflineMaterialImageUploadRequest();
request.setImageName( "test" );
//Windows请填写绝对路径,不支持相对路径;Linux支持相对路径
FileItem item = new FileItem( "C:/Downloads/ooopic_963991_7eea1f5426105f9e6069/16365_1271139700.jpg" );
request.setImageType( "JPG" );
request.setImageContent(item);
//执行API请求
AlipayOfflineMaterialImageUploadResponse response = alipayClient.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()){
      //获取图片访问地址
     String imageUrl = response.getImageUrl();
     //.....
}

用户授权接口调用示例

1
2
3
4
5
6
7
IAopClient client = new DefaultAopClient( "https://openapi.alipay.com/gateway.do" , APPID, APP_PRIVATE_KEY, "json" , "1.0" , "RSA2" , ALIPAY_PUBLIC_KEY, CHARSET, false );
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.user.userinfo.share
AlipayUserUserinfoShareRequest request = new AlipayUserUserinfoShareRequest();
//授权类接口执行API调用时需要带上accessToken
AlipayUserUserinfoShareResponse response= client.execute(req, "accessToken" );
//业务处理
//...

应用授权接口调用示例(ISV代理商户调用)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
IAopClient client = new DefaultAopClient( "https://openapi.alipay.com/gateway.do" , APPID, APP_PRIVATE_KEY, "json" , "1.0" , "RSA2" , ALIPAY_PUBLIC_KEY, CHARSET, false );
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.open.public.template.message.industry.modify
AlipayOpenPublicTemplateMessageIndustryModifyRequest request = new AlipayOpenPublicTemplateMessageIndustryModifyRequest();
//SDK已经封装掉了公共参数,这里只需要传入业务参数
//此次只是参数展示,未进行字符串转义,实际情况下请转义
request.setBizContent( "  {" +
"    \"primary_industry_name\":\"IT科技/IT软件与服务\"," +
"    \"primary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_name\":\"IT科技/IT软件与服务\"" +
"  }" );
AlipayOpenPublicTemplateMessageIndustryModifyResponse response = client.execute(request, null , "app_auth_token" );
//调用成功,则处理业务逻辑
if (response.isSuccess()){
     //.....
}

phpSDK集成示例

普通调用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
$c = new AopClient;
$c->appId = "app_id" ;
$c->rsaPrivateKey = '请填写开发者私钥去头去尾去回车,一行字符串' ;
$c->format = "json" ;
$c->charset= "GBK" ;
$c->signType= "RSA2" ;
$c->alipayrsaPublicKey = '请填写支付宝公钥,一行字符串' ;
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.open.public.template.message.industry.modify
$request = new AlipayOpenPublicTemplateMessageIndustryModifyRequest();
//SDK已经封装掉了公共参数,这里只需要传入业务参数
//此次只是参数展示,未进行字符串转义,实际情况下请转义
$request->bizContent = "{" +
"    \"primary_industry_name\":\"IT科技/IT软件与服务\"," +
"    \"primary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_name\":\"IT科技/IT软件与服务\"" +
" }" ;
$response= $c->execute($request);

图片上传接口调用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
$c = new AopClient;
$c->appId = "app_id" ;
$c->rsaPrivateKey = '请填写开发者私钥去头去尾去回车,一行字符串' ;
$c->format = "json" ;
$c->charset = "GBK" ;
$c->signType= "RSA2" ;
$c->alipayrsaPublicKey = '请填写支付宝公钥,一行字符串' ;
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.offline.material.image.upload
$request = new AlipayOfflineMaterialImageUploadRequest();
$request->setImageName( "测试文件" );
$request->setImageType( "jpg" );
//Windows请填写绝对路径,不支持相对路径;Linux支持相对路径
$request->setImageContent( "@" . "本地文件路径" );
$response = $c->execute($request);
//获取图片地址
$response->getImageUrl();

用户授权接口调用示例

1
2
3
4
5
6
7
8
9
10
11
12
$c = new AopClient;
$c->appId = "app_id" ;
$c->rsaPrivateKey = '请填写开发者私钥去头去尾去回车,一行字符串' ;
$c->format = "json" ;
$c->charset = "GBK" ;
$c->signType= "RSA2" ;
$c->alipayrsaPublicKey = '请填写支付宝公钥,一行字符串' ;
//实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.user.userinfo.share
$request= new AlipayUserUserinfoShareRequest();
//授权类接口执行API调用时需要带上accessToken
$response= $c->execute($request, "accessToken" );

应用授权接口调用示例(ISV代理商户调用)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
$c = new AopClient;
$c->appId = "app_id" ;
$c->rsaPrivateKey = '请填写开发者私钥去头去尾去回车,一行字符串' ;
$c->format = "json" ;
$c->charset = "GBK" ;
$c->signType= "RSA2" ;
$c->alipayrsaPublicKey = '请填写支付宝公钥,一行字符串' ;
##实例化具体API对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.open. public .template.message.industry.modify
$request = new AlipayOpenPublicTemplateMessageIndustryModifyRequest();
//SDK已经封装掉了公共参数,这里只需要传入业务参数
//此次只是参数展示,未进行字符串转义,实际情况下请转义
$request->bizContent = "{" +
"    \"primary_industry_name\":\"IT科技/IT软件与服务\"," +
"    \"primary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_code\":\"10001/20102\"," +
"    \"secondary_industry_name\":\"IT科技/IT软件与服务\"" +
"  }" ;
//ISV代理商户调用需要传入app_auth_token
$response= $c->execute($request,NULL, "app_auth_token" );

方法说明

加签方法(如果不用SDK调用,推荐用该方法加签)

1
2
3
4
5
6
7
/**
@param content 待签名字符串
@param privateKey 加签私钥
@param charset 加签字符集
@param sign_type 签名方式
**/
String AlipaySignature.rsaSign(String content, String privateKey, String charset, String sign_type)

验签方法(例如异步通知的时候,用户需要用到验签方法)

验签方法,根据接口不同,验签时会去掉sign_type(rsaCheckV1)或者保留sign_type(rsaCheckV2)。

1
2
3
4
5
6
7
8
9
10
11
12
13
/**    此方法会去掉sign_type做验签,暂时除生活号(原服务窗)激活开发者模式外都使用V1。
@param params 参数列表(包括待验签参数和签名值sign) key-参数名称 value-参数值
@param publicKey 验签公钥
@param charset 验签字符集
**/
boolean AlipaySignature.rsaCheckV1(Map<String, String> params, String publicKey, String charset, String sign_type)
 
/**    此方法不会去掉sign_type验签,用于生活号(原服务窗)激活开发者模式
@param params 参数列表(包括待验签参数和签名值sign) key-参数名称 value-参数值
@param publicKey 验签公钥
@param charset 验签字符集
**/
boolean AlipaySignature.rsaCheckV2(Map<String, String> params, String publicKey, String charset, String sign_type)

注意事项

    • AlipayClient的实现类都是线程安全的,所以没有必要每次API请求都新建一个AlipayClient实现类;
    • 创建AlipayClient实现类的实例时,指定format=json,相比xml格式,可以减少数据传输量,提升API请求效率。

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值