Square Checkout API使用service_charges添加运费未在结算页展示如何解决

你配置的service_charges字段无法在结算页明细展示是Square Checkout的原生限制，该字段设计用途是后台记录额外费用，默认不对前端用户展示，暂时没有可配置的开启方案。

运费配置最佳实践 #

方案1（推荐）：使用原生shipping_fee字段 #

Square Checkout API专门提供了运费专属配置字段，配置完成后会自动在结算页的价格拆分区域单独展示，和商品小计、税费等项目并列，数据统计时也会被单独归类为运费，不需要额外处理。
配置示例：

"shipping_fee": {
  "amount": {
    "amount": 100,
    "currency": "USD"
  },
  "name": "运费和处理费"
}

方案2：添加自定义订单项展示额外费用 #

如果除了运费之外还有其他类型的额外服务费需要对用户展示，可以将费用作为独立订单项添加到line_items中，会直接在商品明细列表中展示给用户。
配置示例：

"line_items": [
  // 原有商品项保持不变
  {
    "name": "运费和处理费",
    "quantity": "1",
    "base_price_money": {
      "amount": 100,
      "currency": "USD"
    },
    "taxable": false
  }
]

该方案灵活性高，支持任意类型的额外费用展示，缺点是费用项会和商品项混列，后续单独统计运费类数据需要自行过滤。

注意事项 #

• 以上两种方案配置后都会直接计入订单总金额，不需要额外叠加service_charges配置，避免重复计费
• 如果运费需要根据用户收货地址动态计算，建议先通过Square结算页的地址回调事件获取地址信息，计算运费后再更新订单对应字段，或者重新生成结算链接
• 如果是国际订单，运费的currency字段要和订单整体币种保持一致，避免配置报错

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