手机APP调用支付宝支付（java服务端）

曾经终败给现在 2023-03-01 05:36 34阅读 0赞

最近项目中涉及到调用支付宝支付接口，记录一下。拉进去配置一下直接可以用的

# 导包 #

<dependency>
                <groupId>com.alipay.sdk</groupId>
                <artifactId>alipay-sdk-java</artifactId>
                <version>4.10.58.ALL</version>
       </dependency>

# 创建一个配置工具类AlipayConfig #

这里我构造了一个getAlipayClient的无参方法方便调用  
支付宝公钥，私钥，AppID,异步通知地址这些添加自己的就行了。

/** * 设置网关地址(正式环境) */
        public static final String APP_GATEWAY = "https://openapi.alipay.com/gateway.do";
        //public static final String URL = "https://openapi.alipaydev.com/gateway.do"; //沙箱(测试环境)
         /** * 设置应用Id */
        public static final String ALIPAY_APPID = "";
         /** * 私钥 */
        public static final String APP_PRIVATE_KEY = "";
        /** * 支付宝公钥 */
        public static final String ALIPAY_PUBLIC_KEY = "";
        /** * 设置请求格式，固定值json */
        public static final String FORMAT = "json";
        /** * 设置字符集 */
        public static final String CHARSET = "utf-8";
        /** * 设置签名类型 */
        public static final String SIGNTYPE = "RSA2";
    
        /** * 异步通知地址 */
        public static final String NOTIFYURL = "";
        /** * 设置商户号,多个可用英文逗号隔开 */
        public static final String SELLER_ID = "";
        /** * 接口权限值，目前只支持auth_user和auth_base两个值-->> * auth_base：以auth_base为scope发起的网页授权，是用来获取进入页面的用户的userId的，并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页（通常是业务页面）。 * auth_user：以auth_user为scope发起的网页授权，是用来获取用户的基本信息的（比如头像、昵称等）。但这种授权需要用户手动同意，用户同意后，就可在授权后获取到该用户的基本信息。若想获取用户信息，scope的值中需要有该值存在，如scope=auth_user,auth_base。 */
        public static final String SCOPE = "auth_user";
        /** * 统一收单交易创建接口 */
        private static AlipayClient alipayClient = null;
    
    
    /**获得初始化的AlipayClient * @return 支付宝客户端 */
    
        public static AlipayClient getAlipayClient() { 
            if (alipayClient == null) { 
                synchronized (AlipayConfig.class) { 
                    if (null == alipayClient) { 
                        alipayClient = new DefaultAlipayClient(APP_GATEWAY, ALIPAY_APPID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGNTYPE);
                    }
                }
            }
            return alipayClient;
        }

# 支付方法 #

@PostMapping("/appPayOrder")
        public Response appPayOrder(@RequestBody MarketOrder order, @RequestHeader HashMap header) { 
            //这里对订单信息和用户做一判断，是否是某个用户对应的订单等等
            //验证购物券是否有效
            //验证团购活动是否有效
    
           
            //向支付宝平台发出请求，创建支付订单
            String amount = marketOrder.getOrderAmount().toString();
    
                AlipayClient client = AlipayConfig.getAlipayClient();
                //实例化具体API对应的request类
                AlipayTradeAppPayRequest request = new AlipayTradeAppPayRequest();
                //传入业务参数
                AlipayTradeAppPayModel model = new AlipayTradeAppPayModel();
                model.setBody("");
                model.setSubject("");
                model.setOutTradeNo();
                model.setTimeoutExpress("5m");
                model.setTotalAmount(amount);
                model.setProductCode("");
                request.setBizModel(model);
                //异步通知地址
                request.setNotifyUrl(AlipayConfig.NOTIFYURL);
            try { 
                AlipayTradeAppPayResponse response = client.sdkExecute(request);
                if (response.isSuccess()) { 
                   //成功之后的业务处理
                } else { 
                    return Response.error("支付订单创建失败");
                }
            } catch (Exception e) { 
                e.printStackTrace();
                return Response.error("支付宝支付模块故障");
            }
        }

# 支付宝退款 #

Response这个不用在意，我自己封装的返回类型

/** * * 支付宝退款请求 * @param out_trade_no 订单支付时传入的商户订单号,不能和 trade_no同时为空。 * @param trade_no 支付宝交易号，和商户订单号不能同时为空 * @param refund_amount 需要退款的金额，该金额不能大于订单金额,单位为元，支持两位小数 * @return 将提示信息返回 */
        @PostMapping(value = "alipayRefund")
        public Response alipayRefund(String out_trade_no,String trade_no,double refund_amount){ 
    
            // 发送请求
            //随机数 不是全额退款，部分退款必须使用该参数，同一个订单，不同的out_request_no代表部分退款
            String out_request_no= RandomStringUtils.randomAlphanumeric(13);
            try { 
                AlipayClient alipayClient = AlipayConfig.getAlipayClient();
                AlipayTradeRefundRequest request = new AlipayTradeRefundRequest();
                request.setBizContent("{" +
                                "\"out_trade_no\":\"" + out_trade_no + "\"," +
                                "\"trade_no\":\"" + trade_no + "\"," +
                                "\"refund_amount\":\"" + refund_amount + "\"," +
                                "\"out_request_no\":\"" + out_request_no+ "\"," +
                                "\"refund_reason\":\"正常退款\"" +
                                " }");
                AlipayTradeRefundResponse response = alipayClient.execute(request);
                if (response.isSuccess()) { 
                //根据自己业务进行处理
                    log.info("支付宝退款成功");
                    return Response.success("支付宝退款成功");
                } else { 
                    return Response.error(response.getSubMsg());
                }
            } catch (Exception e) { 
                throw new WitException(e.getMessage());
            }
        }

# 接受消息通知 #

/** * 接受消息通知 * @param request * @param response * @throws Exception */
        @RequestMapping("/receiveAppMessage")
        public void receiveAppMessage(HttpServletRequest request, HttpServletResponse response) throws Exception { 
            //获取支付宝POST过来反馈信息
            Map<String,String> params = new HashMap<String,String>();
            Map requestParams = request.getParameterMap();
            String code = request.getParameter("out_trade_no");
            String tradeNo = request.getParameter("trade_no");
            for (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) { 
                String name = (String) iter.next();
                String[] values = (String[]) requestParams.get(name);
                String valueStr = "";
                for (int i = 0; i < values.length; i++) { 
                    valueStr = (i == values.length - 1) ? valueStr + values[i]
                            : valueStr + values[i] + ",";
                }
                //乱码解决，这段代码在出现乱码时使用。
                //valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
                params.put(name, valueStr);
            }
            boolean flag = AlipaySignature.rsaCheckV1(params, AlipayConfig.ALIPAY_PUBLIC_KEY, AlipayConfig.CHARSET,AlipayConfig.SIGNTYPE);
            if(flag == true){ 
                //这里做业务处理
                    log.info("验签成功");
                }
            } else { 
                log.info("数字签名验证失败");
                response.sendError(500,"数字签名验证失败");
            }
        }

## 支付宝支付相关返回名称 ##

**客户端返回码**

<table> 
 <thead> 
  <tr> 
   <th>返回码</th> 
   <th>含义</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>9000</td> 
   <td>订单支付成功</td> 
  </tr> 
  <tr> 
   <td>8000</td> 
   <td>正在处理中，支付结果未知（有可能已经支付成功），请通过 alipay.trade.query 接口查询订单 支付状态</td> 
  </tr> 
  <tr> 
   <td>4000</td> 
   <td>订单支付失败</td> 
  </tr> 
  <tr> 
   <td>6001</td> 
   <td>用户中途取消</td> 
  </tr> 
  <tr> 
   <td>6002</td> 
   <td>网络连接出错</td> 
  </tr> 
  <tr> 
   <td>6004</td> 
   <td>支付结果未知（有可能已经支付成功），请通过 alipay.trade.query 接口查询订单支付状态</td> 
  </tr> 
  <tr> 
   <td>其他</td> 
   <td>其他支付错误</td> 
  </tr> 
 </tbody> 
</table>

**服务器异步通知参数说明**

支付宝对商户的请求数据处理完成后，会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。

http://notify.java.jpxx.org/index.jsp?discount=0.00&payment_type=1&subject=测试&trade_no=2013082244524842&buyer_email=dlw***@gmail.com&gmt_create=2013-08-22 14:45:23&notify_type=trade_status_sync&quantity=1&out_trade_no=082215222612710&seller_id=2088501624816263&notify_time=2013-08-22 14:45:24&body=测试测试&trade_status=TRADE_SUCCESS&is_total_fee_adjust=N&total_fee=1.00&gmt_payment=2013-08-22 14:45:24&seller_email=xxx@alipay.com&price=1.00&buyer_id=2088602315385429&notify_id=64ce1b6ab92d00ede0ee56ade98fdf2f4c&use_coupon=N&sign_type=RSA&sign=1glihU9DPWee+UJ82u3+mw3Bdnr9u01at0M/xJnPsGuHh+JA5bk3zbWaoWhU6GmLab3dIM4JNdktTcEUI9/FBGhgfLO39BKX/eBCFQ3bXAmIZn4l26fiwoO613BptT44GTEtnPiQ6+tnLsGlVSrFZaLB9FVhrGfipH2SWJcnwYs=

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名称</th> 
   <th>类型（长度范围）</th> 
   <th>参数说明</th> 
   <th>是否可为空</th> 
   <th>样例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>notify_time</td> 
   <td>通知时间</td> 
   <td>Date</td> 
   <td>通知的发送时间。格式为yyyy-MM-dd HH:mm:ss。</td> 
   <td>不可空</td> 
   <td>2013-08-22 14:45:24</td> 
  </tr> 
  <tr> 
   <td>notify_type</td> 
   <td>通知类型</td> 
   <td>String</td> 
   <td>通知的类型。</td> 
   <td>不可空</td> 
   <td>trade_status_sync</td> 
  </tr> 
  <tr> 
   <td>notify_id</td> 
   <td>通知校验ID</td> 
   <td>String</td> 
   <td>通知校验ID。</td> 
   <td>不可空</td> 
   <td>64ce1b6ab92d00ede0ee56ade98fdf2f4c</td> 
  </tr> 
  <tr> 
   <td>sign_type</td> 
   <td>签名方式</td> 
   <td>String</td> 
   <td>固定取值为RSA。</td> 
   <td>不可空</td> 
   <td>RSA</td> 
  </tr> 
  <tr> 
   <td>sign</td> 
   <td>签名</td> 
   <td>String</td> 
   <td>请参见签名机制。</td> 
   <td>不可空</td> 
   <td>lBBK%2F0w5LOajrMrji7DUgEqNjIhQbidR13GovA5r3TgIbNqv231yC1NksLdw%2Ba3JnfHXoXuet6XNNHtn7VE%2BeCoRO1O%2BR1KugLrQEZMtG5jmJI</td> 
  </tr> 
  <tr> 
   <td>out_trade_no</td> 
   <td>商户网站唯一订单号</td> 
   <td>String(64)</td> 
   <td>对应商户网站的订单系统中的唯一订单号，非支付宝交易号。需保证在商户网站中的唯一性。是请求时对应的参数，原样返回。</td> 
   <td>可空</td> 
   <td>082215222612710</td> 
  </tr> 
  <tr> 
   <td>subject</td> 
   <td>商品名称</td> 
   <td>String(128)</td> 
   <td>商品的标题/交易标题/订单标题/订单关键字等。它在支付宝的交易明细中排在第一列，对于财务对账尤为重要。是请求时对应的参数，原样通知回来。</td> 
   <td>可空</td> 
   <td>测试</td> 
  </tr> 
  <tr> 
   <td>payment_type</td> 
   <td>支付类型</td> 
   <td>String(4)</td> 
   <td>支付类型。默认值为：1（商品购买）。</td> 
   <td>可空</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>trade_no</td> 
   <td>支付宝交易号</td> 
   <td>String(64)</td> 
   <td>该交易在支付宝系统中的交易流水号。最短16位，最长64位。</td> 
   <td>不可空</td> 
   <td>2013082244524842</td> 
  </tr> 
  <tr> 
   <td>trade_status</td> 
   <td>交易状态</td> 
   <td>String</td> 
   <td>交易状态，取值范围请参见“交易状态”。</td> 
   <td>不可空</td> 
   <td>TRADE_SUCCESS</td> 
  </tr> 
  <tr> 
   <td>seller_id</td> 
   <td>卖家支付宝用户号</td> 
   <td>String(30)</td> 
   <td>卖家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。</td> 
   <td>不可空</td> 
   <td>2088501624816263</td> 
  </tr> 
  <tr> 
   <td>seller_email</td> 
   <td>卖家支付宝账号</td> 
   <td>String(100)</td> 
   <td>卖家支付宝账号，可以是email和手机号码。</td> 
   <td>不可空</td> 
   <td>xxx@alipay.com</td> 
  </tr> 
  <tr> 
   <td>buyer_id</td> 
   <td>买家支付宝用户号</td> 
   <td>String(30)</td> 
   <td>买家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。</td> 
   <td>不可空</td> 
   <td>2088602315385429</td> 
  </tr> 
  <tr> 
   <td>buyer_email</td> 
   <td>买家支付宝账号</td> 
   <td>String(100)</td> 
   <td>买家支付宝账号，可以是Email或手机号码。</td> 
   <td>不可空</td> 
   <td>dlw***@gmail.com</td> 
  </tr> 
  <tr> 
   <td>total_fee</td> 
   <td>交易金额</td> 
   <td>Number</td> 
   <td>该笔订单的总金额。请求时对应的参数，原样通知回来。</td> 
   <td>不可空</td> 
   <td>1.00</td> 
  </tr> 
  <tr> 
   <td>quantity</td> 
   <td>购买数量</td> 
   <td>Number</td> 
   <td>购买数量，固定取值为1（请求时使用的是total_fee）。</td> 
   <td>可空</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>price</td> 
   <td>商品单价</td> 
   <td>Number</td> 
   <td>price等于total_fee（请求时使用的是total_fee）。</td> 
   <td>可空</td> 
   <td>1.00</td> 
  </tr> 
  <tr> 
   <td>body</td> 
   <td>商品描述</td> 
   <td>String(512)</td> 
   <td>该笔订单的备注、描述、明细等。对应请求时的body参数，原样通知回来。</td> 
   <td>可空</td> 
   <td>测试测试</td> 
  </tr> 
  <tr> 
   <td>gmt_create</td> 
   <td>交易创建时间</td> 
   <td>Date</td> 
   <td>该笔交易创建的时间。格式为yyyy-MM-dd HH:mm:ss。</td> 
   <td>可空</td> 
   <td>2013-08-22 14:45:23</td> 
  </tr> 
  <tr> 
   <td>gmt_payment</td> 
   <td>交易付款时间</td> 
   <td>Date</td> 
   <td>该笔交易的买家付款时间。格式为yyyy-MM-dd HH:mm:ss。</td> 
   <td>可空</td> 
   <td>2013-08-22 14:45:23</td> 
  </tr> 
  <tr> 
   <td>is_total_fee_adjust</td> 
   <td>是否调整总价</td> 
   <td>String(1)</td> 
   <td>该交易是否调整过价格。</td> 
   <td>可空</td> 
   <td>N</td> 
  </tr> 
  <tr> 
   <td>use_coupon</td> 
   <td>是否使用红包买家</td> 
   <td>String(1)</td> 
   <td>是否在交易过程中使用了红包。</td> 
   <td>可空</td> 
   <td>N</td> 
  </tr> 
  <tr> 
   <td>discount</td> 
   <td>折扣</td> 
   <td>String</td> 
   <td>支付宝系统会把discount的值加到交易金额上，如果有折扣，本参数为负数，单位为元。</td> 
   <td>可空</td> 
   <td>0.00</td> 
  </tr> 
  <tr> 
   <td>refund_status</td> 
   <td>退款状态</td> 
   <td>String</td> 
   <td>取值范围请参见“退款状态”。</td> 
   <td>可空</td> 
   <td>REFUND_SUCCESS</td> 
  </tr> 
  <tr> 
   <td>gmt_refund</td> 
   <td>退款时间</td> 
   <td>Date</td> 
   <td>卖家退款的时间，退款通知时会发送。格式为yyyy-MM-dd HH:mm:ss。</td> 
   <td>可空</td> 
   <td>2008-10-29 19:38:25</td> 
  </tr> 
 </tbody> 
</table>

通知触发条件

触发条件名 触发条件描述 备注  
TRADE\_FINISHED 交易成功 true（触发通知）  
TRADE\_SUCCESS 支付成功 true（触发通知）  
WAIT\_BUYER\_PAY 交易创建 true（触发通知）  
TRADE\_CLOSED 交易关闭 false（不触发通知）

*说明：true（触发通知）/false（不触发通知）具体值和签约配置时保持同步。*

**服务器异步通知参数获取**

1.  必须保证服务器异步通知页面（notify\_url）上无任何字符，如空格、HTML标签、开发系统自带抛出的异常提示信息等；
2.  支付宝是用POST方式发送通知信息，因此该页面中获取参数的方式，如：  
    request.Form(“out\_trade\_no”)、$\_POST\[‘out\_trade\_no’\]；
3.  支付宝主动发起通知，该方式才会被启用；
4.  服务器间的交互，不像页面跳转同步通知可以在页面上显示出来，这种交互方式是不可见的；
5.  程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付宝的字符不是success这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。  
    一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：4m,10m,10m,1h,2h,6h,15h）；
6.  程序执行完成后，该页面不能执行页面跳转。如果执行页面跳转，支付宝会收不到success字符，会被支付宝服务器判定为该页面程序运行出现异常，而重发处理结果通知；
7.  cookies、session等在此页面会失效，即无法获取这些数据；
8.  该方式的调试与运行必须在服务器上，即互联网上能访问；
9.  该方式的作用主要防止订单丢失，即页面跳转同步通知没有处理订单更新，它则去处理；
10. 当商户收到服务器异步通知并打印出success时，服务器异步通知参数notify\_id才会失效。也就是说在支付宝发送同一条异步通知时（包含商户并未成功打印出success导致支付宝重发数次通知），服务器异步通知参数notify\_id是不变的。

## 通知交易状态 ##

<table> 
 <thead> 
  <tr> 
   <th>枚举名称</th> 
   <th>枚举说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>WAIT_BUYER_PAY</td> 
   <td>交易创建，等待买家付款。</td> 
  </tr> 
  <tr> 
   <td>TRADE_CLOSED</td> 
   <td>在指定时间段内未支付时关闭的交易； 在交易完成全额退款成功时关闭的交易。</td> 
  </tr> 
  <tr> 
   <td>TRADE_SUCCESS</td> 
   <td>交易成功，且可对该交易做操作，如：多级分润、退款等。</td> 
  </tr> 
  <tr> 
   <td>TRADE_FINISHED</td> 
   <td>交易成功且结束，即不可再做任何操作。</td> 
  </tr> 
 </tbody> 
</table>

**退款状态**

<table> 
 <thead> 
  <tr> 
   <th>枚举名称</th> 
   <th>枚举说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>REFUND_SUCCESS</td> 
   <td>退款成功。 全额退款情况：trade_status= TRADE_CLOSED，而refund_status=REFUND_SUCCESS； 非全额退款情况：trade_status= TRADE_SUCCESS，而refund_status=REFUND_SUCCESS</td> 
  </tr> 
  <tr> 
   <td>REFUND_CLOSED</td> 
   <td>退款关闭</td> 
  </tr> 
 </tbody> 
</table>

**不可退款的移动快捷支付**

移动快捷支付的异步通知存在两个通知交易状态（trade\_status）。

*  第一个状态值是WAIT\_BUYER\_PAY：表示等待付款，商户可根据自己的业务逻辑需求做相应操作，处理完业务逻辑后须返回SUCCESS字符串给支付宝；
 *  第二个状态值是TRADE\_FINISHED：表示交易成功完成，此状态表示该笔订单支付宝端已经支付成功，商户根据此状态做相应的业务逻辑操作，最后同样需返回SUCCESS字符串给支付宝。

**可退款的移动快捷支付**

可退款的异步通知与不可退款的机制一致，第一个状态（WAIT\_BUYER\_PAY）相同，第二个状态为TRADE\_SUCCESS，在这个状态下商户可做相应业务逻辑操作，并返回SUCCESS。第三个状态为TRADE\_FINISHED，表示订单完结不可再退款。

是否退手续费通知判断：

*  退手续费：单笔交易完成退款操作支付宝异步通知发送TRADE\_CLOSE状态（交易关闭），此交易状态需支付宝后台配置单独开启，默认不开；
 *  不退手续费：单笔交易完成退款操作支付宝异步通知发送TRADE\_SUCCESS状态，并在订单完成支付后的三个月发送TRADE\_FINISHED状态。