如何通过PayPal Rest API获取美国用户交易的邮编或税务辖区标识？

核心前提 #

如果未在PayPal配置销售税征收规则，PayPal的交易数据（包括API返回结果）不会默认包含客户的邮编或州级税务辖区信息——只有当PayPal需要计算销售税时，才会强制收集这类地址细节。

可行解决方案 #

1. 深度解析API返回的交易数据 #

调用以下PayPal REST API端点时，重点检查地址相关字段：

• /v1/payments/payment/{payment_id}：查看payer.payer_info.shipping_address和payer.payer_info.billing_address对象，若客户在付款时填写了完整地址，这两个字段会包含postal_code（邮编）和state（州）信息。
• /v1/reporting/transactions：批量查询交易时，同样可以提取上述地址字段。

示例代码（Node.js）：

const getTransactionAddress = async (paymentId) => {
  const request = new paypal.orders.OrdersGetRequest(paymentId);
  const response = await paypalClient.execute(request);
  
  const shippingAddr = response.result.purchase_units[0].shipping.address;
  if (shippingAddr) {
    return {
      state: shippingAddr.admin_area_1,
      postalCode: shippingAddr.postal_code
    };
  }
  
  const billingAddr = response.result.payer.address;
  return billingAddr ? {
    state: billingAddr.admin_area_1,
    postalCode: billingAddr.postal_code
  } : null;
};

2. 启用PayPal销售税设置（零税率配置） #

即使你当前将税款包含在商品价格中，仍可在PayPal商家后台开启销售税计算功能（设置税率为0%，避免额外收费）。开启后，PayPal会在付款流程中要求美国客户提供州/邮编信息，后续所有新交易的API返回数据都会包含这些字段。

操作步骤：

• 登录PayPal商家后台 → 进入「设置」→「销售税」
• 开启销售税计算，为美国各州配置0%税率
• 保存设置后，新交易将自动收集客户的州和邮编信息

3. 历史交易的补救方案 #

对于已完成的历史交易，若API无法获取邮编，可行的替代方案：

• 直接联系客户索要对应交易的收货/账单邮编
• 后续新交易，在你的前端付款页面先收集客户的州和邮编信息，再发起PayPal付款请求，将信息同步到你的系统留存

内容的提问来源于stack exchange，提问作者mark377