Menu
Feedback
Start here
Tutorials & Solutions
Developers Portal

Known Issues
Support Rules

Frequently Asked Questions
Announcements
Start here
VTEX Modules: Getting Started
PaymentsCredit card payment flow
Credit card payment flow
3 min read

The basic flow of a credit card payment is performed by the following players:

  • Payment Gateway: A Payment Gateway is a system that transmits the data from the purchases made in your store. The gateway sends data and receives responses to let you know whether a particular purchase should be confirmed or not.
  • Acquirer: An Acquirer, also called a creditor, is a company that specializes in processing payments, meaning that it makes the financial settlements of a store's transactions through credit and debit cards.
  • Card brand: Card Brands are companies responsible for defining the business rules for purchases made with credit cards. They define the standards by which acquirers must process the transactions made through this payment method (each brand has its own rules).
  • Issuing Bank: The Issuing Bank is the financial institution responsible for the means of payment, whether they are "boletos" (popular Brazilian off-line payment method), debit or credit cards. Upon receiving the data of a purchase made in your store, the issuing bank will authorize the sale or not, depending on the credit limit or the money available in the user's account.

To learn more about the financial agents involved in the payment flow of an order in Brazil, check out this article.


Payment Flow

The complete credit card payment flow at VTEX is shown in the following scheme:

{"base64":"  ","img":{"width":364,"height":775,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":28837,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tracks/payments/credit-card-payment-flow_1.JPG"}}

  1. On the Checkout screen of your store, the customer chooses the credit card Payment Method to complete the purchase.

  2. This payment information is passed to the Payment Gateway, which is the player responsible for ensuring that this payment is successful.

  3. The payment gateway passes on the required information to the Acquirer, which is responsible for settling the financial transactions with retailers.

  4. The acquirer sends the payment details to the Brand, which connects the acquiring system with the issuing banks.

  5. Finally, the brand sends the payment information to the Issuing Bank, which does the credit analysis, checks the credit limit and then authorizes or denies the payment.

Upon the issuing bank's response, the reverse flow is performed and the Payment Gateway receives information whether the payment has been approved or denied.

It is possible to include Anti-fraud in this flow. In this case, the anti-fraud receives from the gateway the information that the payment has been pre-authorized by the issuing bank. With the information received from the gateway, the anti-fraud sends a payment approval or denial response. If the anti-fraud denies, the payment is canceled. If the payment is approved, the order can proceed its normal flow.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
The transaction flow
« Previous
Configuring payment connectors
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
GithubDevelopers PortalCommunityFeedbackSite Map