Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Frequently Asked Questions
What should I do when there are problems with a transaction?
What should I do when there are problems with a transaction?
Published on 5/9/2017
Last update on 12/31/2019

To resolve problems with a transaction quickly, you must first understand the log structure detailed in the transactions at VTEX Admin. See here how to view a transaction.

The log records all contacts between VTEX and the partner, whether gateway or antifraud. It goes from the bottom of the page to the top, where the most recent contacts appear.

Status changes and response messages are clearly marked, to make it easier to understand this timeline.

Sometimes there may be a breakdown in communications between VTEX and the partner. There are active security resources, with automatic retries, but there may also be human error, such as the partner updating the platform without updating the integration with VTEX.

In these cases logs are generated or the request is held in a loop. If erratic behavior is noted, the quickest solution is to check whether the request status is the same in both platforms. For instance, the Gateway may have updated the Status to "Settling", but subsequently reports that the Status is not correct, when in fact it is. Here is an example:

On February 8, VTEX received a notification from Gateway of a change of Status.

{"base64":"  ","img":{"width":300,"height":65,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":5188,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/faq/Financial/what-should-i-do-when-there-are-problems-with-a-transaction_1.png"}}

On April 3, the gateway returns an error in the Status.

{"base64":"  ","img":{"width":300,"height":87,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":12002,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/faq/Financial/what-should-i-do-when-there-are-problems-with-a-transaction_2.png"}}

Another example would be if the Gateway (partner) reports that it does not have full details of a credit card to complete a purchase. However, the transaction details at the top of the page show that the information exists - the order could not have been completed without this information. The solution here would be the same, to contact your Gateway.

The TID is the number that should be used to identify a transaction in the Gateway.

The fact that there is a TID also means that the transaction has been initiated, because this information is generated when a connection is established with the Gateway.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback