Square Connect API 列表支付端点未显示“描述”

Question

在 Square Connect API Documentation 中的 List Payments 端点的示例响应中，它显示“描述”作为返回的键，但我从 Square 接收的数据没有显示该键。

我已验证付款确实附有说明（通过从 Square Dashboard 下载交易报告）。

Answer 1

感谢您发现文档和 API 之间的这种不一致。 Payment 对象确实不实际上有一个description 字段。

但是，Payment 对象中包含的以下字段确实包含商家指定的有关付款的注释（假设商家在销售时提供了这些注释）：

• Payment 的tender 的payment_note 字段包含商户指定的有关用于付款的投标形式的注释。这通常仅适用于 OTHER 类型的 Tender 对象。

• Payment 中PaymentItemization 的notes 字段包含有关支付中特定项目的商家指定注释。请注意，PaymentItemizations 仅适用于 Retrieve Payment 端点（不是 List Payments）。

商家控制面板提供的交易报告的描述列只是一个逗号分隔的付款项目名称列表，以及每个项目的任何notes。 Connect API 不直接提供此列表，但您可以使用付款itemizations 的字段为付款重新创建它。