Menu
Feedback
Start here

Known issues

Known issues
Transaction Stuck in Authorized Or Pending Authorization Status After Being Approved
Payments
ID: 1037765
Fixed
Published on10/10/2025
Last updated on10/10/2025
2 min read

Summary

In a standard transaction flow, once all payments have been successfully authorized, the transaction is expected to change its status to Approved. The official documentation explains the different transaction states in more detail: Transaction Flow in Payments.

However, in transactions affected by this problem, we observe two types of unexpected behaviors:

  1. Stuck in Authorized: After all payments have been approved (authorized) and the transaction has already transitioned to the Approved status, a new transition status event, TransactionWorkFlowChangeStatus, is triggered. This event incorrectly updates the status back to Authorized. Even though another TransactionWorkFlowChangeStatus - Approved event occurs afterward, the final status update is not properly recorded in the transaction. As a result, the transaction remains stuck in the Authorized state, preventing the order or transaction from progressing as expected.

Stuck in Pending Authorization: Sometimes, the transaction gets stuck in the Pending Authorization status, even when all payments have already been authorized.

These issues can often be identified by duplicated or conflicting TransactionWorkFlowChangeStatus logs, such as Approved followed by Authorized, or missing the final Approved event entirely — leading to an inconsistent or frozen transaction state.

In September 2025, we performed an operation in the VTEX gateway to ensure status consistency, which reduced the number of cases by 97%. However, this issue may still occur due to improper usage of payment connectors. A new Known Issue has been opened to track these recent cases, where you can also find more details about the best practices that should be implemented by the connectors:

https://newhelp.vtex.com/en/known-issues/transactions-stuck-in-authorized-or-pending-authorization-after-approval?utm_source=old_portal&utm_medium=redirect&utm_campaign=portal_transition

Simulation

It's not possible to simulate.

Workaround

Support team can call internal APIs to move the transaction forward.

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
1
Photo of the contributor
+ 1 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX Community
Join our community
Request VTEX support
For personalized assistance, contact our experts
Open a support ticket
GitHubDeveloper PortalCommunityFeedback