如何在PayPal JavaScript SDK中添加订单描述信息？

要给订单添加描述，核心是在createOrder回调的订单请求体中，通过**purchase_units对象的description字段**（或结合items数组）来定义，这会直接显示在PayPal的订单摘要页面中。

具体代码实现示例 #

假设你当前的基础代码如下：

paypal.Buttons({
  createOrder: function(data, actions) {
    return actions.order.create({
      purchase_units: [{
        amount: {
          value: '10.00'
        }
      }]
    });
  },
  onApprove: function(data, actions) {
    return actions.order.capture().then(function(details) {
      // 处理交易完成逻辑
    });
  }
}).render('#paypal-button-container');

修改后添加描述的版本：

paypal.Buttons({
  createOrder: function(data, actions) {
    return actions.order.create({
      // 可选：订单级整体描述（部分场景下会在交易记录中展示）
      description: "2024年度会员订阅服务",
      purchase_units: [{
        amount: {
          value: '10.00',
          currency_code: 'USD'
        },
        // 必填：该订单单元的核心描述（会显示在订单摘要的显著位置）
        description: "标准版年度会员 - 含专属权益",
        // 可选：添加更细粒度的商品明细（会在订单摘要中展开显示）
        items: [
          {
            name: "年度会员",
            description: "标准版",
            quantity: "1",
            unit_amount: {
              currency_code: "USD",
              value: "10.00"
            }
          }
        ]
      }]
    });
  },
  onApprove: function(data, actions) {
    return actions.order.capture().then(function(details) {
      alert('交易完成！订单ID：' + details.id);
    });
  }
}).render('#paypal-button-container');

关键说明 #

• purchase_units[].description：这是最直接影响订单摘要显示的字段，PayPal会将其作为该订单单元的主要描述展示。
• items数组：如果你的订单包含多个商品，或者需要展示更详细的商品信息，通过这个数组添加每个商品的名称、描述和单价，这些内容会在订单摘要中以明细列表形式呈现。
• 订单根层级的description：属于整体订单的备注性描述，通常会出现在商家后台的交易记录中，而非前端用户看到的订单摘要核心区域。

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