PayPal Checkout SDK：账单地址获取限制与集成策略

<?php

require __DIR__ . '/vendor/autoload.php'; // 引入Composer自动加载

use PayPalCheckoutSdk\Core\PayPalHttpClient;
use PayPalCheckoutSdk\Core\ProductionEnvironment; // 或 SandboxEnvironment
use PayPalCheckoutSdk\Orders\OrdersCaptureRequest;
use PayPalCheckoutSdk\Orders\OrdersGetRequest;

// 1. 配置PayPal环境
// 替换为您的实际Client ID和Secret
$clientId = 'YOUR_PAYPAL_CLIENT_ID';
$clientSecret = 'YOUR_PAYPAL_CLIENT_SECRET';

// 根据您的环境选择 ProductionEnvironment 或 SandboxEnvironment
$environment = new ProductionEnvironment($clientId, $clientSecret);
$client = new PayPalHttpClient($environment);

/**
 * 捕获PayPal订单
 * @param string $orderId PayPal订单ID
 * @return object|null 订单详情或null
 */
function capturePayPalOrder($orderId, $client) {
    $request = new OrdersCaptureRequest($orderId);
    $request->prefer('return=representation'); // 请求返回完整订单表示

    try {
        $response = $client->execute($request);
        // 打印响应以调试
        // print_r($response);
        return $response->result;
    } catch (HttpException $ex) {
        echo "捕获订单时发生错误: " . $ex->getMessage() . "\n";
        echo "状态码: " . $ex->statusCode . "\n";
        return null;
    }
}

/**
 * 获取PayPal订单详情（包括配送地址）
 * @param string $orderId PayPal订单ID
 * @return object|null 订单详情或null
 */
function getPayPalOrderDetails($orderId, $client) {
    $request = new OrdersGetRequest($orderId);

    try {
        $response = $client->execute($request);
        return $response->result;
    } catch (HttpException $ex) {
        echo "获取订单详情时发生错误: " . $ex->getMessage() . "\n";
        echo "状态码: " . $ex->statusCode . "\n";
        return null;
    }
}

// 假设您已经从前端获取到PayPal订单ID
$paypalOrderId = 'YOUR_ORDER_ID_FROM_FRONTEND';

// 步骤1: 捕获订单
$capturedOrder = capturePayPalOrder($paypalOrderId, $client);

if ($capturedOrder) {
    echo "订单捕获成功。订单状态: " . $capturedOrder->status . "\n";

    // 步骤2: 获取订单详情以检查配送地址
    // 实际上，capturePayPalOrder返回的$capturedOrder可能已经包含所需信息，
    // 但为了确保获取最新完整信息，有时会再次调用GET请求。
    $orderDetails = getPayPalOrderDetails($paypalOrderId, $client);

    if ($orderDetails && isset($orderDetails->purchase_units[0]->shipping->address)) {
        $shippingAddress = $orderDetails->purchase_units[0]->shipping->address;
        echo "配送地址信息:\n";
        echo "  姓名: " . ($orderDetails->purchase_units[0]->shipping->name->full_name ?? 'N/A') . "\n";
        echo "  地址行1: " . ($shippingAddress->address_line_1 ?? 'N/A') . "\n";
        echo "  地址行2: " . ($shippingAddress->address_line_2 ?? 'N/A') . "\n";
        echo "  城市: " . ($shippingAddress->admin_area_2 ?? 'N/A') . "\n"; // 通常是城市
        echo "  州/省: " . ($shippingAddress->admin_area_1 ?? 'N/A') . "\n"; // 通常是州/省
        echo "  邮编: " . ($shippingAddress->postal_code ?? 'N/A') . "\n";
        echo "  国家代码: " . ($shippingAddress->country_code ?? 'N/A') . "\n";
    } else {
        echo "未找到配送地址信息。\n";
    }

    // 明确指出账单地址的缺失
    echo "\n注意：PayPal Checkout SDK默认不提供支付方的账单地址。\n";

} else {
    echo "订单捕获失败。\n";
}

?>