Square Connect API列表付款端点未显示＆＃39;描述＆＃39;

Question

在Square Connect API Documentation中的“列表付款”端点的示例响应中，它将“描述”显示为返回的密钥，但我从Square收到的数据未显示该密钥。

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

Answer 1

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

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

• payment_note Payment的{​​{1}}字段包含商家指定的有关用于付款的投标形式的注释。这通常仅适用于类型为tender的{​​{3}}个对象。

• OTHER中Tender的notes字段包含商家指定的有关付款中特定商品的注释。请注意，Payment只能从PaymentItemization端点（不是Retrieve Payment）获取。

商家信息中心提供的交易报告的描述列只是逗号分隔的付款项目名称列表，以及每个项目的PaymentItemization个项目。 Connect API不会直接提供此列表，但您可以使用付款字段notes重新创建付款。