SpringBoot 整合支付宝沙箱支付——从接入到回调

支付是电商系统的核心功能。接入支付宝需要企业资质但支付宝提供了沙箱环境——模拟真实支付流程不需要真实商户号适合开发测试和学习。一、沙箱环境准备1. 登录开放平台打开 open.alipay.com → 控制台 → 沙箱应用2. 获取配置参数APP_ID: 9021000122691234沙箱专用 应用私钥: 生成的 RSA2 私钥 支付宝公钥: 生成的 RSA2 公钥 服务器异步通知地址: http://你的地址/pay/notify3. 沙箱账号沙箱环境提供测试买家账号买家账号: rixwby5818sandbox.com 登录密码: 111111 支付密码: 111111二、SpringBoot 集成1. 引入依赖dependencygroupIdcom.alipay.sdk/groupIdartifactIdalipay-sdk-java/artifactIdversion4.38.200.ALL/version/dependency2. 配置alipay:app-id:9021000122691234app-private-key:|-----BEGIN RSA PRIVATE KEY----- MIIEowIBAAKCAQ... 你的应用私钥不要写在配置里建议用Jasypt加密 -----END RSA PRIVATE KEY-----alipay-public-key:|-----BEGIN PUBLIC KEY----- MIIBIjANBgk... 支付宝公钥 -----END PUBLIC KEY-----notify-url:http://你的公网IP/pay/notifyreturn-url:http://localhost:9090/pay/returngateway-url:https://openapi-sandbox.dl.alipaydev.com/gateway.do3. 配置类ConfigurationConfigurationProperties(prefixalipay)DatapublicclassAlipayConfig{privateStringappId;privateStringappPrivateKey;privateStringalipayPublicKey;privateStringnotifyUrl;privateStringreturnUrl;privateStringgatewayUrl;BeanpublicAlipayClientalipayClient(){returnnewDefaultAlipayClient(gatewayUrl,appId,appPrivateKey,json,utf-8,alipayPublicKey,RSA2);}}三、统一下单接口ServicepublicclassAlipayService{AutowiredprivateAlipayClientalipayClient;AutowiredprivateAlipayConfigalipayConfig;/** * 创建支付订单返回支付页面表单 */publicStringcreatePay(StringorderNo,BigDecimalamount,Stringsubject){AlipayTradePagePayRequestrequestnewAlipayTradePagePayRequest();// 同步回调地址用户支付完成后跳转request.setReturnUrl(alipayConfig.getReturnUrl());// 异步回调地址支付宝服务器通知request.setNotifyUrl(alipayConfig.getNotifyUrl());JSONObjectbiznewJSONObject();biz.put(out_trade_no,orderNo);// 商户订单号biz.put(total_amount,amount.toString());// 支付金额biz.put(subject,subject);// 订单标题biz.put(product_code,FAST_INSTANT_TRADE_PAY);// 电脑网站支付request.setBizContent(biz.toJSONString());try{AlipayTradePagePayResponseresponsealipayClient.pageExecute(request);if(response.isSuccess()){returnresponse.getBody();// 返回 HTML 表单}}catch(AlipayApiExceptione){thrownewRuntimeException(支付宝下单失败,e);}returnnull;}}四、ControllerRestControllerRequestMapping(/pay)publicclassPayController{AutowiredprivateAlipayServicealipayService;/** * 发起支付 */PostMapping(/create)publicResultVOStringcreatePay(RequestBodyPayDTOdto){// 生成订单号StringorderNoORDIdUtil.simpleUUID().toUpperCase();StringformalipayService.createPay(orderNo,dto.getAmount(),dto.getSubject());returnResultVO.success(form);}/** * 同步回调用户支付完成后跳转到此页面 */GetMapping(/return)publicStringreturnUrl(HttpServletRequestrequest){// 获取支付宝返回的参数MapString,StringparamsgetParamsFromRequest(request);try{// 验签AlipaySignature.rsaCheckV1(params,alipayConfig.getAlipayPublicKey(),utf-8,RSA2);StringorderNoparams.get(out_trade_no);StringtradeNoparams.get(trade_no);return支付成功订单号: orderNo;}catch(AlipayApiExceptione){return验签失败;}}/** * 异步回调支付宝服务器通知必须返回 success */PostMapping(/notify)publicStringnotifyUrl(HttpServletRequestrequest){MapString,StringparamsgetParamsFromRequest(request);try{booleansignVerifiedAlipaySignature.rsaCheckV1(params,alipayConfig.getAlipayPublicKey(),utf-8,RSA2);if(signVerified){StringorderNoparams.get(out_trade_no);StringtradeNoparams.get(trade_no);StringtradeStatusparams.get(trade_status);// 支付成功if(TRADE_SUCCESS.equals(tradeStatus)){// 更新订单状态、归还库存等业务逻辑updateOrderStatus(orderNo,tradeNo);}returnsuccess;// 必须返回 success否则支付宝会重复通知}}catch(AlipayApiExceptione){e.printStackTrace();}returnfail;}privateMapString,StringgetParamsFromRequest(HttpServletRequestrequest){MapString,StringparamsnewHashMap();MapString,String[]requestParamsrequest.getParameterMap();for(Stringname:requestParams.keySet()){params.put(name,request.getParameter(name));}returnparams;}}五、秒杀系统集成支付支付完成后更新订单状态并归还库存ServicepublicclassPayService{AutowiredprivateOrderServiceorderService;AutowiredprivateProductServiceproductService;/** * 支付成功回调处理 */TransactionalpublicvoidhandlePaySuccess(StringorderNo,StringtradeNo){// 1. 查询订单SeckillOrderorderorderService.lambdaQuery().eq(SeckillOrder::getOrderNo,orderNo).one();if(ordernull||order.getStatus()!0){return;// 订单不存在或已处理}// 2. 更新订单状态为已支付order.setStatus(1);order.setPayTime(LocalDateTime.now());order.setTradeNo(tradeNo);orderService.updateById(order);// 3. 记录支付日志log.info(支付成功: 订单{}, 支付宝交易号{},orderNo,tradeNo);}}六、前端调用buttononclickpay()支付宝支付/buttonscriptasyncfunctionpay(){constrespawaitfetch(/pay/create,{method:POST,headers:{Content-Type:application/json},body:JSON.stringify({amount:99.99,subject:秒杀商品 - iPhone 15})});constresultawaitresp.json();if(result.code200){// 把返回的 HTML 表单写到页面并自动提交document.body.innerHTMLresult.data;document.forms[0].submit();// 自动跳转到支付宝}}/script七、注意事项异步通知必须返回 “success”全小写否则支付宝会重复通知 8 次验签必不可少防止伪造回调幂等处理——支付宝通知可能重复判断订单状态防止重复更新沙箱金额随便填不会真实扣款上生产环境只需把gateway-url换成生产地址其他代码不变 觉得有用的话点赞 关注【张老师技术栈】吧每周更新 Java/Python/爬虫 实战干货不让你白来。