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:
- 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 anotherTransactionWorkFlowChangeStatus - 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:
Simulation
It's not possible to simulate.
Workaround
Support team can call internal APIs to move the transaction forward.