PayPal JavaScript API 通过送货地址

Question

我需要为在线商店使用 PayPal API。用户在商店界面中设置他的送货信息（姓名和地址），然后单击“使用贝宝付款”按钮。现在我需要将该信息传递给 PayPal API，以便 PayPal 结帐界面中的“送货地址”字段显示正确的地址。我按照 API 文档 (https://developer.paypal.com/docs/api/orders/v2/#definition-shipping_detail.address_portable) 中的方式实现了它，但它似乎不起作用，因为 PayPal 结帐界面中的送货地址和名称仍然是 John Doe 的默认沙箱地址。这是我实现它的方法，但它一定是错误的，因为它不起作用：

createOrder: function(data, actions) {
      return actions.order.create({
        purchase_units: [{
          amount: {
            value: '34'
          },

          shipping_detail: {
            name: {
              full_name: 'Hans Muller'
            },
            address_portable: {
              address_line_1: 'Rohrd. 16',
              address_line_2: 'Rohrdorfer Street',
              admin_area_2: 'Stephanskirchen',
              admin_area_1: 'Bayern',
              postal_code: '83071',
              country_code: 'DE',
            },
          },
        }]
      });
    },

    onApprove: function(data, actions) {
      return actions.order.capture().then(function(details) {
        console.log('Success');
      });
    },

    onError: function (err) {
      console.error(err);
    }

但 PayPal 沙箱界面仍然显示（德语）默认送货地址：

此外，以后应该无法在 PayPal 界面中更改该地址。任何关于我在这里做错的建议都将不胜感激。

Answer 1

你确实做错了

对于 Orders create request body，送货信息进入 purchase_units -> 送货。您没有使用记录的键名对象结构。

其次，一旦您正确提供了送货地址，它仍然可以在 PayPal 批准流程中更改。如果您想强制使用您提供的送货地址，您需要将 application_context -> shipping_preference 变量设置为 SET_PROVIDED_ADDRES，如上文 link 中所述。请注意 application_context 超出了 purchase_units 数组。如果您这样做是为了强制使用特定地址，而所提供的地址不被 PayPal 接受，交易将失败。

确保您在每个级别都使用记录的键名称，而不是那里的对象名称（例如 order_* 和 *_portable 是不正确的）。错误命名的变量将被忽略。

推荐的 PayPal Checkout 流程是从买家的帐户中获取地址，并允许他们在 PayPal 中更改此地址。您可以在交易通过后获取选择的送货地址，然后再进行捕获。

Answer 2

感谢 Preston PHX（接受的答案），我能够解决问题。这是所有懒人的完整 PayPal 按钮呈现调用：

paypal.Buttons({
    style: {
      size: 'small',
      shape: 'rect',
      color: 'blue',
      layout: 'vertical',
      label: 'paypal',
      height: 40
    },

    createOrder: function(data, actions) {
      return actions.order.create({
        application_context: {
          brand_name: 'myBrand',
          locale: 'us-US',
          shipping_preference: 'SET_PROVIDED_ADDRESS',
        },

        purchase_units: [{
          amount: {
            value: '34'
          },

          shipping: {
            name: {
              full_name: 'Hans Muller'
            },
            address: {
              address_line_1: 'MyStreet 12',
              admin_area_2: 'New York',
              postal_code: '10001',
              country_code: 'US',
            }
          }
        }]
      });
    },

    onApprove: function(data, actions) {
      return actions.order.capture().then(function(details) {
        console.log('Success');
      });
    },

    onError: function (err) {
      console.error(err);
    }
  }).render('#paypal-button-container');

Answer 3

如果发送到SDK js地址，需要先在'purchase_units'中添加'shipping'对象，然后在'purchase_units'同级添加'application_context' .

链接：

https://developer.paypal.com/docs/api/orders/v2/#definition-order_application_context 对于 application_context

https://developer.paypal.com/docs/api/orders/v2/#definition-purchase_unit purchase_units

中的运输信息

代码：

purchase_units: [{
  items: itemList,
  amount: { data },
  shipping: {
   name: {
    full_name: address.name+' '+address.surname
   },
   type: 'SHIPPING',
   address: {
    address_line_1: address.address,
    country_code: address.country.iso_code,
    postal_code: address.zip_code,
    admin_area_2: address.city,
    admin_area_1: address.country.general_name
  }
 },
}],
application_context: {
 shipping_preference: 'SET_PROVIDED_ADDRESS',
}

PayPal JavaScript API 通过送货地址

PayPal JavaScript API pass shipping address

javascript

paypal

paypal-sandbox