Changes to Point of Sales (POS) payment processing behavior

API

We're changing how payments are processed on POS in order to bring order cancellations to POS. These changes will go into effect beginning October 31, 2023 for POS Pro and January 22, 2024 for Shopify Plus.

Payments may be authorized for up to 15 minutes before being captured automatically or voided by retail staff. As such, you may notice a few changes to the Admin and Storefront APIs.

On the Admin API, you may see:

• AUTHORIZED as the OrderDisplayFinancialStatus for up to 15 minutes before transitioning to PAID. The status will transition to VOIDED if the order gets canceled within these 15 minutes.
• Separate OrderTransaction objects with AUTHORIZATION and CAPTURE as the OrderTransactionKind when the payment is authorized and captured, instead of a single transaction with the SALE kind.
• Separate OrderTransaction objects with AUTHORIZATION and VOID as the OrderTransactionKind when the payment is authorized and voided.
• An empty array for SuggestedRefund.suggestedTransactions until payments in the order have been captured.

On the Storefront API, the OrderFinancialStatus will exhibit the same behavior as the OrderDisplayFinancialStatus on the Admin API.

Learn more about canceling orders on POS here.

Learn more about OrderDisplayFinancialStatus, OrderTransactionKind, and SuggestedRefund on Shopify.dev.