The transaction flow
3 min read
The path that money travels when it is exchanged for a product or service is what we call a transaction.
In a VTEX store, a transaction begins every time a user chooses a payment condition and completes the order. From there, the purchase data is sent to be validated by each member of the process.
Transactions performed by VTEX payments module go through various statuses, from the beginning of the authorization process through the settlement of the value and the conclusion of the transaction.
See below an example timeline with the transaction statuses.
- Authorizing: This is the first status of a Payments transaction. At this stage, Payments indicates that the process of sending information to an acquirer or to another gateway has begun.
- Authorized: Upon the initiation of the authorization process, the acquirer or other gateway sends the transaction information to the issuing bank. The bank responds if the transaction should be authorized or not. If it denies the transaction, the payment is canceled. If it authorizes, the transaction status changes to Authorized.
- Analyzing Risk (optional): Upon the authorization by the issuing bank, the anti-fraud system acts by analyzing the risk of the transaction. This step is optional. However, we recommend using an anti-fraud to verify your transactions.
- Risk Approved (optional): If the anti-fraud responds positively, the transaction receives the risk approved status. If the anti-fraud identifies any evidence of fraud, the transaction is canceled.
- Approved: This status indicates that the transaction has gone through all possible verifications. It was authorized by the issuing bank and approved by the anti-fraud system. Thus, the transaction gains the approved status.
- Settlement of $: This status indicates that the settlement process of a specific ammount will start. It's important to note that, at this stage, the value has not been settled yet. There is only a warning that the process of settling this value will be carried out in the next status.
- Settling: In this status, the settlement attempt actually starts. The systems responsible for that begin the process by which the ammount of the transaction will be settled.
- Settled: When the transaction reaches this status, it means that the ammount was successfully settled. From here, the connector becomes entirely responsible for the flow. It is up to the retailer to monitor if the payment amount will be properly deposited in his account.
- Finished: The transaction reaches the finished status when the invoice with the payment ammount is issued and linked to the order in the OMS. You should note that even after the settlement finishes successfully, it's necessary to include the invoice in the order.