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) 的订单，就像通过店面提交的订单在商店中的显示方式一样。然后，您可以在控制面板中处理货件，也可以像处理所有标准订单一样使用第 3 方运输管理器。您甚至可以将订单提交为“Awaiting Fulfillment”，然后通过 API 添加货件。如果您为订单中的所有产品添加发货，则订单状态将自动更新为“已发货”状态。如果您添加的货件仅占订单产品的子集，则状态会自动更改为“部分发货”。

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

付款方式
payment_provider_id
external_source

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

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

Answer 2

创建订单时，将 status_id 设置为 9“等待发货”或任何最合适的值。 您可以在这里查看订单状态：https://developer.bigcommerce.com/api/stores/v2/order_statuses

您还可以在此处找到有关创建订单的更多信息：https://developer.bigcommerce.com/api/stores/v2/orders#create-an-order