@paypal/react-paypal-js集成中的收货地址配置问题

问题回顾 #

最初设置shipping_preferences: "NO_SHIPPING"，导致用户无法在PayPal平台输入收货地址；改为GET_FROM_FILE后触发PayPal错误，多次修改地址仍无法解决。

错误原因分析 #

GET_FROM_FILE会调用PayPal账户中存储的用户默认地址，若用户账户无已保存的有效地址、或应用未配置地址读取权限，就会触发地址无效类错误。

可行解决方案 #

方案1：使用SET_PROVIDED_ADDRESS自定义传递地址 #

如果希望用户在你的页面输入地址后同步到PayPal，采用该参数并主动传入地址信息：

const onCreateOrder = (data, actions) => {
  // 从你的表单获取用户填写的地址
  const userShippingAddress = {
    address_line_1: "示例街道123号",
    address_line_2: "单元4B",
    admin_area_2: "城市名",
    admin_area_1: "省份/州",
    postal_code: "12345",
    country_code: "CN"
  };

  return actions.order.create({
    intent: "CAPTURE",
    application_context: {
      shipping_preferences: "SET_PROVIDED_ADDRESS",
    },
    purchase_units: [
      {
        amount: {
          value: 150,
        },
        shipping: {
          address: userShippingAddress
        }
      },
    ],
  });
};

方案2：使用NO_SHIPPING并补充订单备注（若无需强制地址） #

若业务不需要收货地址，仅需用户可补充相关信息，保留NO_SHIPPING并添加自定义说明：

const onCreateOrder = (data, actions) => {
  return actions.order.create({
    intent: "CAPTURE",
    application_context: {
      shipping_preferences: "NO_SHIPPING",
    },
    purchase_units: [
      {
        amount: {
          value: 150,
        },
        description: "如需收货信息，请在订单备注中填写"
      },
    ],
  });
};

方案3：修复GET_FROM_FILE的配置问题 #

若坚持使用该参数，需确认两点：

• 用户PayPal账户已保存有效的收货地址
• 登录PayPal开发者平台，检查你的应用是否开启了地址读取权限

额外排查步骤 #

1. 查看PayPal开发者控制台的错误日志，根据具体错误代码（如INVALID_SHIPPING_ADDRESS）定位精准问题
2. 测试不同地区的用户账户，确认是否为区域限制导致的地址验证失败
3. 确保传递的地址字段符合PayPal格式要求（如国家代码用两位大写字母、邮编格式匹配对应地区）

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