支付宝接入电商平台通常有以下流程:

  1. 接入准备
    • 注册账号:使用没有签约过支付宝收单产品的支付宝账号,建议电商平台新开支付宝账户进行签约。
    • 创建应用:登录支付宝开放平台,根据需要的能力类型创建应用唯一标识(APPID)。
    • 配置密钥:生成 RSA 密钥并完成配置,用于防止数据篡改,保障应用和支付宝交互的安全性。
    • 下载 SDK:下载服务端 SDK 并进行接口调用配置,以便后续进行接口开发。
  2. 二级商户入驻
    • 提交资料:平台商通过直付通二级商户创建接口提交二级商户资料,进行二级商户入驻申请,同时要指定二级商户交易资金的收款账户。
    • 审核签约:支付宝内部审核后,二级商户协议签署即完成入驻。
  3. 交易收款
    • 买家付款:买家选择商品后,使用支付宝付款。直付通提供单笔(合并)支付能力,买家付款后,支付宝记录二级商户的待结算资金。
    • 退款处理:发生退款时将支付款项原路退回买家,可支持全额退款、部分退款,退分账。
  4. 资金结算
    • 确认结算:买家确认收货后,平台通过资金确认结算功能,将交易款结算给二级商户收款账户,最长账期支持 365 天,超过 365 天订单自动结算。
    • 营销补差:平台举行平台出资的营销活动,资金结算后,平台向支付宝发起补差指令,将营销资金补到二级商户的支付宝账户。
    • 分账抽佣:平台可根据实际业务场景将交易资金分账到其他业务参与方的支付宝账户,如抽取佣金等,目前支持单个平台最多 5000 个参与方的分账,单笔交易订单最高分账比例 30%。
  5. 账单查询及对账商户可以在支付宝商家中心查询资金账单。如需业务账单,可于签约完成、业务上线之前,发送邮件至 zfbzftjrsq@list.alibaba - inc.com申请获取业务账单。
  6. 手续费开票首次开票时,平台商需前往商家中心 > 对账中心 > 开票信息,填写开票信息。平台商在商家中心 > 对账中心 > 账单管理中可自行申请开取指定时间段的发票。

以下是支付宝接入电商平台的核心流程代码示例(以 Java 语言为例,基于支付宝 SDK),主要展示创建支付订单支付结果回调处理的关键逻辑。实际开发需结合官方文档和具体业务场景完善。

前提准备

  1. 已在支付宝开放平台创建应用,获取APPID商户私钥支付宝公钥
  2. 引入支付宝 SDK 依赖(Maven):
<dependency>
    <groupId>com.alipay.sdk</groupId>
    <artifactId>alipay-sdk-java</artifactId>
    <version>4.38.0.ALL</version>
</dependency>

1. 配置支付宝客户端

import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;

/**
 * 支付宝客户端配置
 */
public class AlipayConfig {
    // 应用ID(从开放平台获取)
    public static final String APP_ID = "你的APPID";
    // 商户私钥(本地生成的RSA私钥)
    public static final String PRIVATE_KEY = "你的商户私钥";
    // 支付宝公钥(从开放平台获取)
    public static final String ALIPAY_PUBLIC_KEY = "支付宝公钥";
    // 接口网关(正式环境)
    public static final String GATEWAY_URL = "https://openapi.alipay.com/gateway.do";
    // 编码格式
    public static final String CHARSET = "UTF-8";
    // 签名方式
    public static final String SIGN_TYPE = "RSA2";

    /**
     * 创建支付宝客户端实例
     */
    public static AlipayClient getAlipayClient() {
        return new DefaultAlipayClient(
            GATEWAY_URL, 
            APP_ID, 
            PRIVATE_KEY, 
            "json", 
            CHARSET, 
            ALIPAY_PUBLIC_KEY, 
            SIGN_TYPE
        );
    }
}

2. 创建支付订单(电脑网站支付示例)

import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.request.AlipayTradePagePayRequest;
import com.alipay.api.response.AlipayTradePagePayResponse;

/**
 * 支付宝支付服务
 */
public class AlipayService {

    /**
     * 创建电脑网站支付订单
     * @param outTradeNo 商户订单号(唯一)
     * @param totalAmount 订单金额(单位:元)
     * @param subject 订单标题
     * @param returnUrl 支付成功后跳转地址
     * @param notifyUrl 支付结果异步通知地址
     * @return 支付表单HTML(前端直接渲染即可唤起支付宝支付)
     */
    public String createPagePayOrder(
            String outTradeNo, 
            String totalAmount, 
            String subject, 
            String returnUrl, 
            String notifyUrl
    ) throws AlipayApiException {
        // 1. 获取支付宝客户端
        AlipayClient alipayClient = AlipayConfig.getAlipayClient();

        // 2. 创建支付请求对象(电脑网站支付用AlipayTradePagePayRequest)
        AlipayTradePagePayRequest request = new AlipayTradePagePayRequest();
        request.setReturnUrl(returnUrl); // 同步回调地址(前端跳转)
        request.setNotifyUrl(notifyUrl); // 异步回调地址(后端处理)

        // 3. 组装请求参数(JSON格式)
        String bizContent = "{" +
                "\"out_trade_no\":\"" + outTradeNo + "\"," + // 商户订单号
                "\"total_amount\":\"" + totalAmount + "\"," + // 订单金额(精确到分)
                "\"subject\":\"" + subject + "\"," + // 订单标题
                "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"" + // 产品码(固定值)
                "}";
        request.setBizContent(bizContent);

        // 4. 调用支付宝接口,获取支付表单
        AlipayTradePagePayResponse response = alipayClient.pageExecute(request);
        if (response.isSuccess()) {
            // 成功时返回支付表单HTML,前端直接渲染即可
            return response.getBody();
        } else {
            throw new RuntimeException("创建支付订单失败:" + response.getMsg());
        }
    }
}

3. 支付结果异步回调处理(关键!)

支付宝会在用户支付成功后,向商户配置的notifyUrl发送异步通知,需验证签名并处理订单状态。

import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.request.AlipayTradeQueryRequest;
import com.alipay.api.response.AlipayTradeQueryResponse;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;

/**
 * 支付宝回调接口
 */
@RestController
public class AlipayNotifyController {

    /**
     * 支付结果异步通知处理
     * 注意:必须使用POST请求,且接口地址需公网可访问
     */
    @PostMapping("/alipay/notify")
    public String handleNotify(HttpServletRequest request) {
        try {
            // 1. 从请求中获取所有参数
            Map<String, String> params = new HashMap<>();
            Map<String, String[]> requestParams = request.getParameterMap();
            for (Iterator<String> iter = requestParams.keySet().iterator(); iter.hasNext(); ) {
                String name = iter.next();
                String[] values = requestParams.get(name);
                String valueStr = "";
                for (int i = 0; i < values.length; i++) {
                    valueStr = (i == values.length - 1) ? valueStr + values[i] : valueStr + values[i] + ",";
                }
                params.put(name, valueStr);
            }

            // 2. 验证签名(关键!防止伪造请求)
            boolean signVerified = AlipaySignature.rsaCheckV1(
                    params,
                    AlipayConfig.ALIPAY_PUBLIC_KEY,
                    AlipayConfig.CHARSET,
                    AlipayConfig.SIGN_TYPE
            );

            if (!signVerified) {
                // 签名验证失败,返回"fail"告诉支付宝重新发送通知
                return "fail";
            }

            // 3. 签名验证成功,处理业务逻辑
            String outTradeNo = params.get("out_trade_no"); // 商户订单号
            String tradeStatus = params.get("trade_status"); // 交易状态

            // 只处理支付成功的通知(TRADE_SUCCESS:即时到账;TRADE_FINISHED:不可退款)
            if ("TRADE_SUCCESS".equals(tradeStatus) || "TRADE_FINISHED".equals(tradeStatus)) {
                // 4. 再次查询支付宝确认订单状态(双重保障,防止重复处理)
                if (queryOrderStatus(outTradeNo)) {
                    // 5. 更新商户系统订单状态(如:改为"已支付")
                    updateOrderStatus(outTradeNo, "PAID");
                    // 6. 处理后续业务(如:通知仓库发货等)
                    handlePostPayment(outTradeNo);
                }
            }

            // 7. 处理完成,返回"success"告诉支付宝停止发送通知
            return "success";

        } catch (Exception e) {
            // 异常时返回"fail",支付宝会重试
            e.printStackTrace();
            return "fail";
        }
    }

    /**
     * 查询支付宝订单状态(确认支付是否真实成功)
     */
    private boolean queryOrderStatus(String outTradeNo) throws AlipayApiException {
        AlipayClient alipayClient = AlipayConfig.getAlipayClient();
        AlipayTradeQueryRequest request = new AlipayTradeQueryRequest();
        request.setBizContent("{" +
                "\"out_trade_no\":\"" + outTradeNo + "\"" +
                "}");
        AlipayTradeQueryResponse response = alipayClient.execute(request);
        // 交易状态为SUCCESS表示支付成功
        return response.isSuccess() && "TRADE_SUCCESS".equals(response.getTradeStatus());
    }

    /**
     * 更新商户订单状态(实际业务中需操作数据库)
     */
    private void updateOrderStatus(String outTradeNo, String status) {
        // TODO: 实现订单状态更新逻辑
        System.out.println("订单" + outTradeNo + "状态更新为:" + status);
    }

    /**
     * 支付成功后的后续处理(如发货、分账等)
     */
    private void handlePostPayment(String outTradeNo) {
        // TODO: 实现支付后的业务逻辑
        System.out.println("订单" + outTradeNo + "支付成功,开始处理后续流程...");
    }
}

关键说明

  1. 签名验证:异步回调必须验证签名,否则可能遭受伪造请求攻击。
  2. 幂等性处理:支付宝可能多次发送同一通知,需确保订单状态更新逻辑幂等(如通过订单号判断是否已处理)。
  3. 环境差异:测试环境需使用支付宝沙箱(网关为https://openapi.alipaydev.com/gateway.do),并使用沙箱账号和密钥。
  4. 其他支付方式:手机 APP 支付用AlipayTradeAppPayRequest,小程序支付用AlipayTradeCreateRequest,参数类似。

详细接口文档和更多功能(如退款、分账)可参考支付宝开放平台官方文档:支付宝开放平台文档中心

一、整体流程概述

整个流程围绕 “用户在电商平台下单→调用支付宝接口生成支付链接→用户完成支付→支付宝通知平台支付结果→平台更新订单状态” 展开,核心是通过支付宝 SDK 完成支付接口调用和回调验证,确保交易安全可靠。

二、代码模块详解

1. 支付宝客户端配置(AlipayConfig类)

作用:初始化支付宝接口调用的基础配置,为后续接口调用提供统一的客户端实例。核心逻辑

  • 定义常量存储支付宝接口的关键参数(APPID、密钥、网关等),这些参数是平台与支付宝交互的 “身份凭证”。
  • 提供getAlipayClient()方法,创建并返回支付宝客户端实例(DefaultAlipayClient),该实例封装了签名、网络请求等底层逻辑,后续所有接口调用都依赖此实例。

关键参数说明

  • APP_ID:平台在支付宝开放平台创建应用后获得的唯一标识,用于支付宝识别调用方身份。
  • PRIVATE_KEY:平台本地生成的 RSA 私钥,用于对请求数据进行签名(防止数据被篡改)。
  • ALIPAY_PUBLIC_KEY:支付宝的公钥,用于验证支付宝返回数据的签名(确保数据来自支付宝)。
  • GATEWAY_URL:支付宝接口网关地址(正式环境与沙箱环境不同,沙箱为https://openapi.alipaydev.com/gateway.do)。
2. 创建支付订单(AlipayService类)

作用:调用支付宝接口生成支付表单,引导用户跳转至支付宝完成支付。流程步骤

  1. 获取支付宝客户端:通过AlipayConfig.getAlipayClient()获取已配置的客户端实例。
  2. 创建支付请求对象:根据支付场景选择对应的Request类(此处用AlipayTradePagePayRequest,适用于电脑网站支付)。
    • 设置returnUrl:用户支付成功后跳转回平台的前端页面(同步回调,仅用于页面展示,不处理核心业务)。
    • 设置notifyUrl:支付宝异步通知平台支付结果的后端接口地址(核心业务处理依赖此通知)。
  3. 组装订单参数:以 JSON 格式拼接订单信息,包括:
    • out_trade_no:平台生成的唯一订单号(用于关联平台与支付宝的订单)。
    • total_amount:订单金额(单位:元,精确到分)。
    • subject:订单标题(如 “iPhone 15 购买”)。
    • product_code:固定值FAST_INSTANT_TRADE_PAY(电脑网站支付的产品码)。
  4. 调用支付宝接口:通过客户端的pageExecute(request)方法发送请求,支付宝返回支付表单 HTML。
  5. 返回支付表单:前端渲染该 HTML 后,自动跳转至支付宝支付页面,用户输入密码或刷脸完成支付。
3. 支付结果异步回调处理(AlipayNotifyController类)

作用:接收支付宝发送的支付结果通知,验证通知合法性,并更新平台订单状态(核心!确保支付结果真实可靠)。流程步骤

  1. 接收回调参数:支付宝会以 POST 请求的方式,将支付结果参数(如订单号、交易状态、签名等)发送到notifyUrl。代码通过HttpServletRequest获取所有参数并封装到Map中。

  2. 验证签名(关键!)

    • 调用AlipaySignature.rsaCheckV1()方法,使用支付宝公钥验证参数签名是否合法。
    • 目的:防止第三方伪造支付通知,确保通知确实来自支付宝。若签名验证失败,返回 “fail”,支付宝会重新发送通知。
  3. 处理支付成功状态

    • 从参数中获取trade_status(交易状态),仅处理TRADE_SUCCESS(支付成功)或TRADE_FINISHED(交易完成,不可退款)的通知。
    • 双重验证:调用queryOrderStatus()方法,再次向支付宝查询该订单的实际状态(防止因网络问题导致的重复通知或伪造通知)。
  4. 更新订单状态

    • 若订单确实支付成功,调用updateOrderStatus()更新平台数据库中的订单状态(如从 “待支付” 改为 “已支付”)。
    • 处理后续业务:调用handlePostPayment()触发后续流程(如通知仓库发货、计算佣金等)。
  5. 返回处理结果

    • 处理完成后返回 “success”,告知支付宝无需再次发送通知。
    • 若过程中出现异常(如数据库错误),返回 “fail”,支付宝会在一段时间内重试发送通知(确保最终一致性)。

三、关键逻辑补充

  1. 幂等性设计:支付宝可能因网络延迟等原因多次发送同一通知,代码通过out_trade_no(唯一订单号)判断订单是否已处理,避免重复更新状态(例如updateOrderStatus方法中需先查询订单当前状态,仅在未处理时执行更新)。

  2. 安全性保障

    • 签名验证:全程使用 RSA 非对称加密,确保请求和通知的真实性。
    • 异步回调优先:同步回调(returnUrl)可能因用户关闭页面失败,核心业务逻辑必须依赖异步回调(notifyUrl)。
  3. 环境适配:开发阶段需切换为沙箱环境(修改GATEWAY_URL为沙箱网关,使用沙箱APPID和密钥),避免真实资金交易。测试通过后再切换至正式环境。

四、总结

这套代码完整实现了 “创建支付订单→用户支付→接收支付结果→更新订单状态” 的闭环,核心是通过支付宝 SDK 简化接口调用,同时通过签名验证和双重校验确保交易安全。实际开发中,还需补充数据库操作、异常日志记录、退款接口等功能,以适配复杂业务场景。

通俗简洁的讲一下:

  1. 先填好 "身份证"把平台在支付宝申请的账号、密钥等信息填到配置里,相当于给系统办了个 "支付宝接入许可证"。

  2. 用户下单后生成支付链接用户买东西时,系统调用支付宝接口,生成一个支付页面链接。用户点进去就是支付宝的付款界面,输密码付钱。

  3. 支付宝偷偷告诉平台 "钱到了"用户付完钱,支付宝会悄悄发一个通知给平台的后台接口(就像快递员把签收单塞到你家门缝)。

  4. 平台查收通知并记账平台先核对这个通知是不是真的来自支付宝(防止骗子伪造),确认后就把订单状态改成 "已付款",然后安排发货等后续操作。

整个过程就像:商家(平台)给顾客(用户)开了张支付宝收款单,顾客付款后,支付宝告诉商家 "钱收到了",商家再记上账、发货。

Logo

电商企业物流数字化转型必备!快递鸟 API 接口,72 小时快速完成物流系统集成。全流程实战1V1指导,营造开放的API技术生态圈。

更多推荐