当前位置: 移动技术网 > IT编程>开发语言>Java > java后台实现支付宝支付接口和支付宝订单查询接口(前端为APP)

java后台实现支付宝支付接口和支付宝订单查询接口(前端为APP)

2019年07月19日  | 移动技术网IT编程  | 我要评论
最近项目app需要接入微信、支付宝支付功能,在分配开发任务时,听说微信支付接口比支付宝支付接口要难实现,由于我开发经验不是那么丰富(现工作经验1年半)且未接触过支付接口开发

最近项目app需要接入微信、支付宝支付功能,在分配开发任务时,听说微信支付接口比支付宝支付接口要难实现,由于我开发经验不是那么丰富(现工作经验1年半)且未接触过支付接口开发,组里刚好又有支付接口的老司机,所以很自然把简单的支付宝接口开发任务交给了我,看来开发组的组长还是很好人的嘛.....,废话就不多说了,我们开始吧!

实现支付宝接口详细过程

1.去支付宝官网申请公司企业账号并开通一个应用,在应用里签约app支付功能

具体的申请截图步骤,在这里我就不详细说了,因为这不是文章的重点,可参考。

经过这一步,我们可以得过开发中需要用到的几个参数

①商户appid  ②商户公钥、私钥  ③支付宝公钥  ④支付宝网关地址

解释一下这几个参数:

1.商户appid是识别商户的唯一id,是让支付宝识别,我们到底是哪一个商户,这样支付宝就能识别商户对应的账号、用户号、收款账号...等等一系列信息。

2.商户公钥、私钥以及支付宝公钥这3个参数是对商户系统与支付宝进行信息交互的数字签名用的,相信各位大学里也有学过关于数字签名的一些知识,在这里,我就简单说一下我理解的过程:首先是商户系统需要给支付宝发送信息(支付、查询等等....),涉及钱方面,咱们当前要谨慎一点对吧,所以我们需要对发送之前的信息加把锁(用商户私钥进行签名),然后再发送给支付宝。支付宝收到商户发送的信息之后,发现上了把锁,那肯定得要一把钥匙(商户公钥)来解锁对吧,所以商户在跟支付宝签约app支付功能的时候,就得把这把钥匙上传给支付宝了,支付宝就可以用商户的公钥进行解锁了。反过来也是一样,支付宝需要发送信息给商户信息,先用支付宝的私钥进行签名,再发送给商户系统,商户系统收到支付宝反馈过来的信息后,再用支付宝的公钥进行解密。在这里我们并没有用到支付宝的私钥,所以我们并不需要得到支付宝的私钥。这里放一个生成私钥公钥的

3.支付宝网关地址,是用来配置发送给支付宝的网关地址的。

2.将支付宝的sdk集成到项目系统里

支付宝的sdk指的就是支付宝提供的工具jar包给我们开发者,sdk封装了大量的基础功能,使我们可以快速开发支付宝接口。这也是我在前面说的比微信支付接口更容易实现的原因。获取支付宝sdk地址:支付宝sdk下载地址,这里我选择java的sdk。下载解压后的sdk得到:

alipay-sdk-java20180122110032.jar、commons-logging-1.1.1.jar是我们需要导入到项目里的,因为项目后台的大致的架构是maven+springboot+jpa,所以我们需要从maven里导入jar包,首先是导入commons-logging-1.1.1.jar,不用多说,咱直接在pom.xml里加上:

<dependency>
  <groupid>commons-logging</groupid>
  <artifactid>commons-logging</artifactid>
  <version>1.1.1</version>
</dependency>

然后是alipay-sdk-java20180122110032.jar,如果你也像上面一样直接加入到pom.xml,会发现,咦,怎么一直下载不下来。当然alipy的包在线上的maven仓库并没有,所以我们需要导入到本地的maven仓库。前提是配置好maven的环境变量,将包放在g:\alipay\sdk下,然后打开dos窗口,cd进入到g:\alipay\sdk下,执行maven如下命令:

 mvn install:install-file -dgroupid=com.alipay -dartifactid=sdk-java -dversion=20180122110032 -dpackaging=jar -dfile=alipay-sdk-java20180122110032.jar

导入成功后,在项目的pom.xml里继续添加

<!-- 支付宝sdk -->
<dependency>
  <groupid>com.alipay</groupid>
  <artifactid>sdk-java</artifactid>
  <version>20180122110032</version>
</dependency>

到此,我们就顺利把支付宝sdk集成到项目里,是不是有点小兴奋,我们很快可以开发了!

3.看支付宝提供的api和网上各位牛人总结的经验,后台使用支付宝的sdk与支付宝进行交互

先看一下支付宝支付流程的图:

首先,我们来理一理开发的思路,按照我当前项目的需求,关于支付这一块大概操作流程是:用户在app上选好要购买的商品,点击“立即购买”,跳转到订单详细页面。选择支付方式,点击“确定支付”跳转到支付宝app,付款完成后,跳转回app,完成支付。这个过程,当用户点击“确定支付”时,app需要调用商户后台接口。

这时候就是我们所需要做的事情:先是生成商户系统一笔未支付的订单,获得商户订单id(商户系统生成)和订单的一些其他信息,然后再调用支付宝的sdk提供的数字签名方法,将需要传给支付宝的信息进行加签,然后把加签后的字符串返回给app。app拉起支付宝app,再把这个加签的字符串传给支付宝,完成支付。app接收到同步通知后,还需要再次调用商户后台的接口(虽然同步通知也有付款情况,但需要以后台通知为准),校验订单最终的付款情况。按照支付宝api上所说,当完成支付后,支付宝会做2个操作,一个是同步返回信息给app,一个是异步通知商户后台返回支付状态等信息,并且最终的支付结果是以异步通知为准。所以我们还需要考虑到一点,就是当用户支付成功之后,商户系统暂时没有接收到支付宝的异步通知时。我们需要拿着这个商户订单id主动调用sdk支付宝的查询接口,去获取该订单的支付情况,并最终返回给app。这个查询的接口应该是给app收到同步通知后,请求商户系统后台进行校验的时候调用的。

根据我们上面思考所得,后台只需要对外提供3个接口即可

1.用户点击“立即购买”时调用商户后台接口,后台返回加签后的订单信息字符串

2.在支付完成之后,支付宝异步通知商户后台订单的付款情况

3.在支付完成之后,跳转回app时,app调用商户后台进行最终付款校验

想通想明白之后,终于接一下我们要敲代码了,哈哈哈哈

首先,我们来准备一下需要传给支付宝sdk的公共基本参数,我把参数放到一个单独的类里,你也可以放到数据库里,代码如下:

public class alipayconfig {
  // 1.商户appid
  //public static string appid = "2017...";  
  
  //2.私钥 pkcs8格式的
  public static string rsa_private_key ="miiewaibadanbg.....";
  
  // 3.支付宝公钥
  public static string alipay_public_key = "miibijanbgkq.....";
  
  // 4.服务器异步通知页面路径 需http://或者https://格式的完整路径,不能加?id=123这类自定义参数,必须外网可以正常访问
  public static string notify_url = "http://www.xxx.com/alipay/notify_url.do";
  
   //5.页面跳转同步通知页面路径 需http://或者https://格式的完整路径,不能加?id=123这类自定义参数,必须外网可以正常访问 商户可以自定义同步跳转地址
  public static string return_url = "http://www.xxx.com/alipay/return_url.do";
  
  // 6.请求支付宝的网关地址
  public static string url = "https://openapi.alipay.com/gateway.do";  
  
  // 7.编码
  public static string charset = "utf-8";
  
  // 8.返回格式
  public static string format = "json";
  
  // 9.加密类型
  public static string signtype = "rsa2";
  
}

1.实现第一个接口:用户点击“立即购买”时调用商户后台接口,后台返回加签后的订单信息字符串。我把主要的处理逻辑写在service层了,controller层直接调用就可以,这里就不放controller层的代码了

生成商户订单的代码,我就不放了,这个根据各自的业务需求来做,生成后订单之后,把订单信息传进来该方法进行处理,返回加签后的字符串,直接返回给app即可,代码如下:

/**
 * 获取支付宝加签后台的订单信息字符串
 * 
 * @param request
 * @return
 */
 @override
 @transactional(propagation = propagation.required)
 public string getalipayorderstr(ordertest ordertest) {
 
 //最终返回加签之后的,app需要传给支付宝app的订单信息字符串 
 string orderstring = "";
 logger.info("==================支付宝下单,商户订单号为:"+ordertest.getouttradeno());
 
 //创建商户支付宝订单(因为需要记录每次支付宝支付的记录信息,单独存一个表跟商户订单表关联,以便以后查证)
 alipaymentorder alipaymentorder=new alipaymentorder();
 alipaymentorder.setcluborderid(ordertest.getid().tostring());//商家订单主键
 alipaymentorder.setouttradeno(ordertest.getouttradeno());//商户订单号
 alipaymentorder.settradestatus((byte) 0);//交易状态
 alipaymentorder.settotalamount(double.parsedouble(ordertest.gettotalamount()));//订单金额
 alipaymentorder.setreceiptamount(0.00);//实收金额
 alipaymentorder.setinvoiceamount(0.00);//开票金额
 alipaymentorder.setbuyerpayamount(0.00);//付款金额
 alipaymentorder.setrefundfee(0.00); //总退款金额
  
 try{ 
 //实例化客户端(参数:网关地址、商户appid、商户私钥、格式、编码、支付宝公钥、加密类型),为了取得预付订单信息
        alipayclient alipayclient = new defaultalipayclient(alipayconfig.url, alipayconfig.appid, 
         alipayconfig.rsa_private_key, alipayconfig.format, alipayconfig.charset, 
         alipayconfig.alipay_public_key,alipayconfig.signtype);
    
        //实例化具体api对应的request类,类名称和接口名称对应,当前调用接口名称:alipay.trade.app.pay 
        alipaytradeapppayrequest ali_request = new alipaytradeapppayrequest();
    
        //sdk已经封装掉了公共参数,这里只需要传入业务参数。以下方法为sdk的model入参方式
        alipaytradeapppaymodel model = new alipaytradeapppaymodel();
    
        //业务参数传入,可以传很多,参考api
        //model.setpassbackparams(urlencoder.encode(request.getbody().tostring())); //公用参数(附加数据)
        model.setbody(ordertest.getbody());            //对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。
        model.setsubject(ordertest.getsubjecy());         //商品名称
        model.setouttradeno(ordertest.getouttradeno());      //商户订单号(自动生成)
        // model.settimeoutexpress("30m");     //交易超时时间
        model.settotalamount(ordertest.gettotalamount());     //支付金额
        model.setproductcode("quick_msecurity_pay");      //销售产品码(固定值)
        ali_request.setbizmodel(model); 
        logger.info("====================异步通知的地址为:"+alipayment.getnotifyurl());
        ali_request.setnotifyurl(alipayconfig.notify_url);    //异步回调地址(后台)
        ali_request.setreturnurl(alipayconfig.return_url);   //同步回调地址(app)
    
        // 这里和普通的接口调用不同,使用的是sdkexecute
 alipaytradeapppayresponse alipaytradeapppayresponse = alipayclient.sdkexecute(ali_request); //返回支付宝订单信息(预处理)
 orderstring=alipaytradeapppayresponse.getbody();//就是orderstring 可以直接给app请求,无需再做处理。
 this.createalipaymentorder(alipaymentorder);//创建新的商户支付宝订单
 
 } catch (alipayapiexception e) {
  e.printstacktrace();
  logger.info("与支付宝交互出错,未能生成订单,请检查代码!");
 } 
 
    return orderstring;
 }

2.实现第二个接口:在支付完成之后,支付宝异步通知商户后台订单的付款情况,这个是支付宝每隔一段时间来访问一次的接口,直到你返回success,才会停止访问,这里我分了2个地方进行调用

/**
 * 支付宝支付成功后.异步请求该接口
 * @param request
 * @return
 * @throws ioexception
 */ 
 @requestmapping(value="/notify_url",method=requestmethod.post)
 @responsebody
 public string notify(httpservletrequest request,httpservletresponse response) throws ioexception { 
 logger.info("==================支付宝异步返回支付结果开始");
 //1.从支付宝回调的request域中取值 
 //获取支付宝返回的参数集合
    map<string, string[]> aliparams = request.getparametermap(); 
    //用以存放转化后的参数集合
    map<string, string> conversionparams = new hashmap<string, string>(); 
   for (iterator<string> iter = aliparams.keyset().iterator(); iter.hasnext();) { 
     string key = iter.next(); 
     string[] values = aliparams.get(key); 
     string valuestr = ""; 
     for (int i = 0; i < values.length; i++) { 
       valuestr = (i == values.length - 1) ? valuestr + values[i] : valuestr + values[i] + ","; 
     } 
     // 乱码解决,这段代码在出现乱码时使用。如果mysign和sign不相等也可以使用这段代码转化 
     // valuestr = new string(valuestr.getbytes("iso-8859-1"), "uft-8"); 
     conversionparams.put(key, valuestr); 
   }  
   logger.info("==================返回参数集合:"+conversionparams);
  string status=alipaymentorderservice.notify(conversionparams);
  return status;
 }
 /**
 * 支付宝异步请求逻辑处理
 * @param request
 * @return
 * @throws ioexception
 */ 
 public string notify(map<string, string> conversionparams){
 
 logger.info("==================支付宝异步请求逻辑处理");
  
  //签名验证(对支付宝返回的数据验证,确定是支付宝返回的)
   boolean signverified = false;  
   
   try { 
     //调用sdk验证签名
     signverified = alipaysignature.rsacheckv1(conversionparams, alipayconfig.alipay_public_key, alipayconfig.charset, alipayconfig.signtype); 
     
   } catch (alipayapiexception e) { 
   logger.info("==================验签失败 !"); 
     e.printstacktrace();     
   }  
   
   //对验签进行处理
   if (signverified) {
   //验签通过    
   //获取需要保存的数据
     string appid=conversionparams.get("app_id");//支付宝分配给开发者的应用id
   string notifytime=conversionparams.get("notify_time");//通知时间:yyyy-mm-dd hh:mm:ss
   string gmtcreate=conversionparams.get("gmt_create");//交易创建时间:yyyy-mm-dd hh:mm:ss
   string gmtpayment=conversionparams.get("gmt_payment");//交易付款时间
   string gmtrefund=conversionparams.get("gmt_refund");//交易退款时间
   string gmtclose=conversionparams.get("gmt_close");//交易结束时间
   string tradeno=conversionparams.get("trade_no");//支付宝的交易号
   string outtradeno = conversionparams.get("out_trade_no");//获取商户之前传给支付宝的订单号(商户系统的唯一订单号)
   string outbizno=conversionparams.get("out_biz_no");//商户业务号(商户业务id,主要是退款通知中返回退款申请的流水号)
   string buyerlogonid=conversionparams.get("buyer_logon_id");//买家支付宝账号
   string sellerid=conversionparams.get("seller_id");//卖家支付宝用户号
   string selleremail=conversionparams.get("seller_email");//卖家支付宝账号
   string totalamount=conversionparams.get("total_amount");//订单金额:本次交易支付的订单金额,单位为人民币(元)
   string receiptamount=conversionparams.get("receipt_amount");//实收金额:商家在交易中实际收到的款项,单位为元
   string invoiceamount=conversionparams.get("invoice_amount");//开票金额:用户在交易中支付的可开发票的金额
   string buyerpayamount=conversionparams.get("buyer_pay_amount");//付款金额:用户在交易中支付的金额  
   string tradestatus = conversionparams.get("trade_status");// 获取交易状态 
   
   //支付宝官方建议校验的值(out_trade_no、total_amount、sellerid、app_id)
   alipaymentorder alipaymentorder=this.selectbyouttradeno(outtradeno); 
  
   if(alipaymentorder!=null&&totalamount.equals(alipaymentorder.gettotalamount().tostring())&&alipayconfig.appid.equals(appid)){
    //修改数据库支付宝订单表(因为要保存每次支付宝返回的信息到数据库里,以便以后查证)
    alipaymentorder.setnotifytime(dateformat(notifytime));
    alipaymentorder.setgmtcreate(dateformat(gmtcreate));
    alipaymentorder.setgmtpayment(dateformat(gmtpayment));
    alipaymentorder.setgmtrefund(dateformat(gmtrefund));
    alipaymentorder.setgmtclose(dateformat(gmtclose));
    alipaymentorder.settradeno(tradeno);
    alipaymentorder.setoutbizno(outbizno);
    alipaymentorder.setbuyerlogonid(buyerlogonid);
    alipaymentorder.setsellerid(sellerid);
    alipaymentorder.setselleremail(selleremail);
    alipaymentorder.settotalamount(double.parsedouble(totalamount));
    alipaymentorder.setreceiptamount(double.parsedouble(receiptamount));
    alipaymentorder.setinvoiceamount(double.parsedouble(invoiceamount));
    alipaymentorder.setbuyerpayamount(double.parsedouble(buyerpayamount));
    switch (tradestatus) // 判断交易结果
           {
           case "trade_finished": // 交易结束并不可退款
           alipaymentorder.settradestatus((byte) 3);
             break;
           case "trade_success": // 交易支付成功
           alipaymentorder.settradestatus((byte) 2);        
             break;
           case "trade_closed": // 未付款交易超时关闭或支付完成后全额退款
           alipaymentorder.settradestatus((byte) 1);
             break;
           case "wait_buyer_pay": // 交易创建并等待买家付款
           alipaymentorder.settradestatus((byte) 0);
             break;
           default:
             break;
           }
    int returnresult=this.updatebyprimarykey(alipaymentorder);  //更新交易表中状态
          
     if(tradestatus.equals("trade_success")) {  //只处理支付成功的订单: 修改交易表状态,支付成功
      
       if(returnresult>0){
          return "success";
       }else{
          return "fail";
       }
     }else{
       return "fail";
     }
    
   }else{
    logger.info("==================支付宝官方建议校验的值(out_trade_no、total_amount、sellerid、app_id),不一致!返回fail");
    return"fail";
   }
 
   } else { //验签不通过  
   logger.info("==================验签不通过 !");
     return "fail";
   }
 
 }

3.实现第三个接口:在支付完成之后,跳转回app时,app调用商户后台进行最终付款校验。我把主要的处理逻辑写在service层了,controller层直接调用就可以,这里就不放controller层的代码了。

/**
 * 向支付宝发起订单查询请求
 * @param request
 * @return
 * @throws ioexception
 */ 
 @override
 public byte checkalipay(string outtradeno) {
 logger.info("==================向支付宝发起查询,查询商户订单号为:"+outtradeno);
 
 try {
 //实例化客户端(参数:网关地址、商户appid、商户私钥、格式、编码、支付宝公钥、加密类型)
        alipayclient alipayclient = new defaultalipayclient(alipayconfig.url, alipayconfig.appid, 
     alipayconfig.rsa_private_key, alipayconfig.format, alipayconfig.charset, 
     alipayconfig.alipay_public_key,alipayconfig.signtype);
 alipaytradequeryrequest alipaytradequeryrequest = new alipaytradequeryrequest();
 alipaytradequeryrequest.setbizcontent("{" +
 "\"out_trade_no\":\""+outtradeno+"\"" +
 "}");
 alipaytradequeryresponse alipaytradequeryresponse = alipayclient.execute(alipaytradequeryrequest); 
 if(alipaytradequeryresponse.issuccess()){
  
   alipaymentorder alipaymentorder=this.selectbyouttradeno(outtradeno);
   //修改数据库支付宝订单表
   alipaymentorder.settradeno(alipaytradequeryresponse.gettradeno());
   alipaymentorder.setbuyerlogonid(alipaytradequeryresponse.getbuyerlogonid());
   alipaymentorder.settotalamount(double.parsedouble(alipaytradequeryresponse.gettotalamount()));
   alipaymentorder.setreceiptamount(double.parsedouble(alipaytradequeryresponse.getreceiptamount()));
   alipaymentorder.setinvoiceamount(double.parsedouble(alipaytradequeryresponse.getinvoiceamount()));
   alipaymentorder.setbuyerpayamount(double.parsedouble(alipaytradequeryresponse.getbuyerpayamount()));
   switch (alipaytradequeryresponse.gettradestatus()) // 判断交易结果
          {
          case "trade_finished": // 交易结束并不可退款
           alipaymentorder.settradestatus((byte) 3);
            break;
          case "trade_success": // 交易支付成功
           alipaymentorder.settradestatus((byte) 2);      
            break;
          case "trade_closed": // 未付款交易超时关闭或支付完成后全额退款
           alipaymentorder.settradestatus((byte) 1);      
            break;
          case "wait_buyer_pay": // 交易创建并等待买家付款
           alipaymentorder.settradestatus((byte) 0);
            break;
          default:
            break;
          }
   this.updatebyprimarykey(alipaymentorder); //更新表记录
   return alipaymentorder.gettradestatus();
 } else {
  logger.info("==================调用支付宝查询接口失败!");
 }
 } catch (alipayapiexception e) {
  // todo auto-generated catch block
  e.printstacktrace();
 }
 return 0;
 }

至此,代码已经上完了,里面可能涉及部分业务代码,如果各位需要拿代码,需要把业务代码换成自己所需要的。

建议:可以边看api边进行开发,主要是看我们需要给支付传什么参数,支付宝可以给我们传什么参数,不然没看清除,你会多很多坑要踩的,亲试过。

感觉太少图片了,这里给几张api的图片。。你们也可以自己去看 一些支付宝api

4.关于测试的一些事

支付宝有提供沙箱环境进行测试所使用,见。

但是楼主比较有米,直接用真实环境进行测试,其实测一次0.01元也是挺贵的吧,前提是你的电脑必须访问外网和能够被外网所访问,建议可以找个内网穿透的工具。

写了一整个下午,好累啊,本人新手,如有错误,请各位大神指教,希望对大家有用!!!!也希望大家多多支持移动技术网。

如您对本文有疑问或者有任何想说的,请 点击进行留言回复,万千网友为您解惑!

相关文章:

验证码:
移动技术网