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

接下来，就可以用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 urlStr = "http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=X&userId=X&fileType=X&bizDates=X&downloadFileName=X&fileId=X"; //指定希望保存的文件路径 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->gatewayUrl = "https://openapi.alipay.com/gateway.do"; $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->gatewayUrl = "https://openapi.alipay.com/gateway.do"; $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->gatewayUrl = "https://openapi.alipay.com/gateway.do"; $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->gatewayUrl = "https://openapi.alipay.com/gateway.do"; $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请求效率。