PayPal PHP支付集成指南：实现安全可靠的服务器端交易

<?php

// 假设您已通过Composer安装并配置了PayPal Checkout-PHP-SDK
// use PayPalCheckoutSdk\Core\PayPalHttpClient;
// use PayPalCheckoutSdk\Core\SandboxEnvironment; // 或 LiveEnvironment
// use PayPalCheckoutSdk\Orders\OrdersCreateRequest;

class PayPalService
{
    private $client;

    public function __construct()
    {
        // 实际应用中，这里应初始化PayPal HTTP客户端，
        // 包括您的Client ID和Client Secret，并选择沙盒或生产环境。
        // 例如：
        // $environment = new SandboxEnvironment(getenv('PAYPAL_CLIENT_ID'), getenv('PAYPAL_CLIENT_SECRET'));
        // $this->client = new PayPalHttpClient($environment);
    }

    public function createOrder(array $items, string $returnUrl, string $cancelUrl): string
    {
        $purchaseUnits = [];
        $totalAmount = 0;

        foreach ($items as $item) {
            $itemTotal = $item['amount'] * $item['quantity'];
            $totalAmount += $itemTotal;
            $purchaseUnits[] = [
                'reference_id' => 'PU-' . uniqid(), // 唯一的采购单元参考ID
                'amount' => [
                    'currency_code' => 'USD', // 或动态货币
                    'value' => (string) $itemTotal,
                ],
                'items' => [[
                    'name' => $item['name'],
                    'unit_amount' => ['currency_code' => 'USD', 'value' => (string) $item['amount']],
                    'quantity' => (string) $item['quantity'],
                ]],
            ];
        }

        $orderRequest = [
            'intent' => 'CAPTURE', // 意图为捕获资金
            'purchase_units' => $purchaseUnits,
            'application_context' => [
                'return_url' => $returnUrl,
                'cancel_url' => $cancelUrl,
                'brand_name' => '您的商店名称',
                'shipping_preference' => 'NO_SHIPPING', // 根据需要调整
                'user_action' => 'PAY_NOW', // 用户行为：立即支付
                'locale' => 'zh-CN', // 本地化设置
            ]
        ];

        // 实际SDK调用示例 (OrdersCreateRequest 是 PayPal Checkout SDK 的一部分)
        // $request = new OrdersCreateRequest();
        // $request->prefer('return=representation');
        // $request->body = $orderRequest;
        // try {
        //     $response = $this->client->execute($request);
        //     return $response->result->id; // 返回PayPal生成的订单ID
        // } catch (Exception $e) {
        //     // 错误处理
        //     error_log("PayPal Create Order Error: " . $e->getMessage());
        //     throw new Exception("Failed to create PayPal order.");
        // }

        // 模拟返回订单ID
        return 'ORDER-ID-' . uniqid();
    }
}

// 在您的控制器或路由中：
// header('Content-Type: application/json');
// $paypalService = new PayPalService();
// try {
//     $orderId = $paypalService->createOrder(
//         $_POST['items'], // 从前端获取商品数据
//         'https://yourstore.com/checkout/success',
//         'https://yourstore.com/checkout/cancel'
//     );
//     echo json_encode(['id' => $orderId]);
// } catch (Exception $e) {
//     http_response_code(500);
//     echo json_encode(['error' => $e->getMessage()]);
// }

<?php

// use PayPalCheckoutSdk\Orders\OrdersCaptureRequest;

class PayPalService
{
    // ... (构造函数和createOrder方法同上) ...

    public function captureOrder(string $orderId): array
    {
        // 实际SDK调用示例 (OrdersCaptureRequest 是 PayPal Checkout SDK 的一部分)
        // $request = new OrdersCaptureRequest($orderId);
        // $request->prefer('return=representation');
        // try {
        //     $response = $this->client->execute($request);
        //     return json_decode(json_encode($response->result), true); // 返回捕获结果数组
        // } catch (Exception $e) {
        //     // 错误处理
        //     error_log("PayPal Capture Order Error: " . $e->getMessage());
        //     throw new Exception("Failed to capture PayPal order.");
        // }

        // 模拟返回捕获结果
        return [
            'id' => 'CAPTURE-ID-' . uniqid(),
            'status' => 'COMPLETED',
            'purchase_units' => [
                [
                    'payments' => [
                        'captures' => [
                            ['id' => 'PAYPAL-TRANSACTION-ID-' . uniqid(), 'status' => 'COMPLETED']
                        ]
                    ]
                ]
            ],
            // ... 其他捕获详情
        ];
    }
}

// 在您的控制器或路由中：
// header('Content-Type: application/json');
// $paypalService = new PayPalService();
// $orderId = $_POST['orderID'] ?? $_GET['orderID']; // 从前端获取订单ID
// if (!$orderId) {
//     http_response_code(400);
//     echo json_encode(['error' => 'Order ID is required.']);
//     exit;
// }
// try {
//     $captureResult = $paypalService->captureOrder($orderId);

//     // *** 核心业务逻辑处理 ***
//     if ($captureResult['status'] === 'COMPLETED' && isset($captureResult['purchase_units'][0]['payments']['captures'][0]['id'])) {
//         $transactionId = $captureResult['purchase_units'][0]['payments']['captures'][0]['id'];
//         // 1. 存储交易ID到数据库
//         // 例如：$this->orderRepository->updateOrder($orderId, ['status' => 'paid', 'paypal_transaction_id' => $transactionId]);
//         // 2. 更新库存
//         // 3. 发送确认邮件
//         // 4. 其他业务逻辑...
//         error_log("Order {$orderId} captured successfully. PayPal Transaction ID: {$transactionId}");
//     } else {
//         // 处理非COMPLETED状态或捕获失败
//         error_log("Order {$orderId} capture status: " . $captureResult['status']);
//         // 记录失败信息，可能需要人工介入
//     }
//     // *** 核心业务逻辑处理结束 ***

//     echo json_encode($captureResult);
// } catch (Exception $e) {
//     http_response_code(500);
//     echo json_encode(['error' => $e->getMessage()]);
// }