【支付】PayPal支付通道 Java对接 （下单 付款 确认 退款 查询 回调）

在现代电子商务发展迅速的背景下，PayPal成为了极为流行的在线支付处理平台。通过Java对接PayPal支付通道，我们可以轻松实现下单、付款、确认、退款、查询和回调等功能。本文将详细介绍如何在Java中实现这些操作，并提供相应的代码示例。

1. 环境准备

首先，你需要一个PayPal开发者账户。登录PayPal Developer网站，创建一个应用，获取你的Client ID和Secret。接下来，需要添加PayPal SDK依赖。我们以Maven为例，将以下依赖添加到你的pom.xml文件中：

<dependency>
    <groupId>com.paypal.sdk</groupId>
    <artifactId>paypal-rest-sdk</artifactId>
    <version>1.14.0</version>
</dependency>

2. PayPal配置

在项目中配置PayPal的环境变量，包括Client ID、Secret、环境配置（沙箱或生产环境）：

import com.paypal.base.rest.APIContext;
import com.paypal.base.rest.PayPalRESTException;

public class PayPalConfig {
    private static final String CLIENT_ID = "你的Client ID";
    private static final String CLIENT_SECRET = "你的Secret";
    private static final String MODE = "sandbox"; // 可选值有 live 和 sandbox

    public static APIContext getAPIContext() {
        return new APIContext(CLIENT_ID, CLIENT_SECRET, MODE);
    }
}

3. 下单（创建支付）

进行支付之前，首先需要创建一个支付对象：

import com.paypal.api.payments.Amount;
import com.paypal.api.payments.Item;
import com.paypal.api.payments.ItemList;
import com.paypal.api.payments.Payer;
import com.paypal.api.payments.Payment;
import com.paypal.api.payments.RedirectUrls;
import com.paypal.api.payments.Transaction;
import com.paypal.base.rest.APIContext;
import com.paypal.base.rest.PayPalRESTException;
import java.util.Arrays;

public class PayPalPayment {
    public Payment createPayment(Double total, String cancelUrl, String successUrl) throws PayPalRESTException {
        Amount amount = new Amount();
        amount.setCurrency("USD");
        amount.setTotal(String.valueOf(total));

        Transaction transaction = new Transaction();
        transaction.setDescription("订单描述");
        transaction.setAmount(amount);

        List<Transaction> transactions = Arrays.asList(transaction);

        Payer payer = new Payer();
        payer.setPaymentMethod("paypal");

        Payment payment = new Payment();
        payment.setIntent("sale");
        payment.setPayer(payer);
        payment.setTransactions(transactions);

        RedirectUrls redirectUrls = new RedirectUrls();
        redirectUrls.setCancelUrl(cancelUrl);
        redirectUrls.setReturnUrl(successUrl);
        payment.setRedirectUrls(redirectUrls);

        return payment.create(PayPalConfig.getAPIContext());
    }
}

4. 付款确认

用户在PayPal完成支付后返回商户网站，你需要确认支付：

import com.paypal.api.payments.Payment;
import com.paypal.base.rest.PayPalRESTException;

public class PayPalExecutePayment {
    public Payment executePayment(String paymentId, String payerId) throws PayPalRESTException {
        Payment payment = new Payment();
        payment.setId(paymentId);
        PaymentExecution paymentExecution = new PaymentExecution();
        paymentExecution.setPayerId(payerId);
        return payment.execute(PayPalConfig.getAPIContext(), paymentExecution);
    }
}

5. 退款

若需退款，可通过以下代码实现：

import com.paypal.api.payments.Refund;
import com.paypal.api.payments.Sale;
import com.paypal.base.rest.PayPalRESTException;

public class PayPalRefund {
    public Sale refundPayment(String saleId) throws PayPalRESTException {
        Sale sale = new Sale();
        sale.setId(saleId);

        Refund refund = new Refund();
        Amount amount = new Amount();
        amount.setCurrency("USD");
        amount.setTotal("10.00"); // 退款金额
        refund.setAmount(amount);

        return sale.refund(PayPalConfig.getAPIContext(), refund);
    }
}

6. 查询支付状态

你可以通过以下代码查询支付状态：

import com.paypal.api.payments.Payment;
import com.paypal.base.rest.PayPalRESTException;

public class PayPalQueryPayment {
    public Payment getPaymentDetails(String paymentId) throws PayPalRESTException {
        return Payment.get(PayPalConfig.getAPIContext(), paymentId);
    }
}

7. 回调处理

PayPal支持通过Webhook回调实现对支付状态的异步处理。你可以在Webhook接收到数据后，解析并处理相关业务逻辑。

总结

通过上述步骤，我们已经实现了Java对接PayPal支付通道的基本功能，包括下单、付款确认、退款、查询和回调等。在实际应用中你需要根据自己的业务逻辑做相应的功能扩展和错误处理。这为e-commerce平台提供了一个稳定的支付解决方案。希望本示例对你有所帮助！