PayPal Checkout SDK：理解与应对账单地址获取限制

<?php
// 假设您已经通过 PayPalCheckoutSdk 成功捕获了一个订单，
// 并且获取到了 Order 对象 $order。
// 这里的 $order 是一个模拟的响应结构，实际数据会更复杂，
// 但核心字段结构是相似的。

// 模拟的 PayPal Order 对象
$order = (object) [
    'id' => 'YOUR_ORDER_ID_EXAMPLE',
    'status' => 'COMPLETED',
    'payer' => (object) [
        'email_address' => 'payer@example.com',
        'payer_id' => 'PAYER_ID_ABC123',
        // 重要提示：PayPal Checkout SDK 默认不会在此处包含 'billing_address' 字段。
        // 'billing_address' => (object) [ /* ... */ ] // 账单地址不会在这里
    ],
    'purchase_units' => [
        (object) [
            'reference_id' => 'PU_REF_ID_001',
            'amount' => (object) [
                'currency_code' => 'USD',
                'value' => '100.00'
            ],
            // 如果是实物商品，通常会包含 'shipping' 信息
            'shipping' => (object) [
                'name' => (object) [
                    'full_name' => 'John Doe' // 收件人姓名
                ],
                'address' => (object) [
                    'address_line_1' => '123 Main St',
                    'admin_area_2' => 'San Jose', // 城市
                    'admin_area_1' => 'CA',       // 州/省
                    'postal_code' => '95131',
                    'country_code' => 'US'
                ]
            ]
        ]
    ]
];

echo "--- 订单基本信息 ---\n";
echo "订单ID: " . $order->id . "\n";
echo "订单状态: " . $order->status . "\n";
echo "付款人邮箱: " . $order->payer->email_address . "\n";
echo "付款人ID: " . $order->payer->payer_id . "\n";

echo "\n--- 配送地址信息 ---\n";
// 检查是否存在配送信息
if (!empty($order->purchase_units[0]->shipping->address)) {
    $shippingAddress = $order->purchase_units[0]->shipping->address;
    $recipientName = $order->purchase_units[0]->shipping->name->full_name ?? 'N/A';

    echo "收件人: " . $recipientName . "\n";
    echo "地址行1: " . $shippingAddress->address_line_1 . "\n";
    echo "城市: " . $shippingAddress->admin_area_2 . "\n";
    echo "州/省: " . $shippingAddress->admin_area_1 . "\n";
    echo "邮政编码: " . $shippingAddress->postal_code . "\n";
    echo "国家代码: " . $shippingAddress->country_code . "\n";
} else {
    echo "此订单未提供配送地址信息（例如，可能为数字商品或到店自取）。\n";
}

echo "\n--- 关于账单地址的重要提示 ---\n";
echo "PayPal Checkout SDK 默认不会在订单响应中提供付款人的账单地址。\n";
echo "出于用户隐私保护，PayPal将此信息保留。\n";
echo "如果您的业务需要账单地址，建议您在支付流程之外自行向用户收集此信息。\n";

?>