BigCommerce API - 创建具有已完成付款状态的订单

Question

有没有办法使用 BigCommerce API 创建订单(或稍后更新)并将付款状态设置为完成？
文档说该字段 payment_status 是只读的。但我在想，也许还有一些其他的更新可以做，这会影响设置 payment_status。

我想要做的是创建一个标记为付款完成的订单。

Answer 1

您目前无法将订单的“payment_status”参数设置为任何值。除非您进入控制面板并手动处理订单，否则通过 API 创建的订单将显示“payment_status”的空白值。除了更改“payment_status”参数值之外，如果您的目标是让您的商店将 API 提交的订单视为已付款，您可以通过更改“status_id”参数来实现。

如果您通过 API 创建或更新订单以使其“status_id”值为 2 或 10(分别为“已发货”和“已完成”状态)，那么商店将认为该订单已付款。这意味着商店统计信息会将该订单的详细信息合并到订单统计信息中。此时，“payment_status”实际上只告诉您订单是否是使用商店的内置支付集成支付的。仅当您确实以某种方式在 Bigcommerce 外部进行付款，然后通过 API 提交它们时，此详细信息才重要。

因此，如果您的目标只是更改“payment_status”并且与您的商店将订单识别为已付款无关，那么目前仅使用 API 上的操作是不可能的。您无法通过 API 上执行的操作使用内置支付集成来捕获或接受付款，但您可以将外部接受的付款记录到系统中。

以下是一些其他注意事项，供人们在 Bigcommerce 商店外部付款并通过 API 提交那些已完成(已付款)的订单:

在系统中将订单设置为状态 ID 2(已发货)或状态 ID 10(已完成)在功能上是相同的。可以直接使用这些状态创建订单，商店会将它们视为已付款和已完成的订单进行统计。如果您的订单在提交之前已经付款并发货，但通常人们已经付款但想要在发货前提交订单，这很好。提交订单预装运会将其放入队列中，以便像所有正常订单一样处理装运。

此用例要遵循的常见过程是创建具有“等待履行”状态 (ID 11) 的订单，就像通过店面提交的订单在商店中的显示方式一样。然后，您可以在控制面板中处理货件，也可以像所有标准订单一样使用 3rd 方货件管理器处理货件。您甚至可以将订单提交为“等待履行”，然后通过 API 添加发货。如果您添加占订单中所有产品的发货，则订单状态将自动更新为“已发货”状态。如果您添加的货件仅占订单产品的一个子集，则状态会自动更改为“已部分发货”。

可以为通过 API 提交订单的人设置的其他有用参数是:

付款方法
Payment_provider_id
外部源

所有上述参数都将接受一个字符串，然后该字符串附加到订单并显示在订单的控制面板中。对于哪些值应该放在那里没有严格的定义，但购物车对这些字段的一般用法如下。 “payment_method”将保存所使用的支付网关的名称或进行支付的方法。 “payment_provider_id”将在支付提供商处接收订单的交易或引用 ID。 “external_source”用于标识谁通过 API 提交了此订单。

我希望以上内容可以帮助您更好地了解如何最好地利用 Bigcommerce API 提交订单。