Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Payments
Payments overview
Adding BIN information
Adding BIN information

The Bank Identification Number (BIN) consists of the first six or eight digits of a credit or debit card and identifies the card's issuing institution.

{"base64":"  ","img":{"width":510,"height":367,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":137426,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Payments/Payments%20overview/adding-bin-information_1.png"}}

When a banking institution wants to create new card profiles or issue new cards for an existing model, new BINs are required. This also applies when a card brand is acquired by another.

In such cases, VTEX must be notified to ensure that the new cards are correctly validated during the payment process for purchases made on the platform.

Submitting an add BIN request

To add a new BIN or update an existing one on VTEX, please open a ticket with VTEX Support.

In the ticket, you should attach a spreadsheet with the following information:

  • code: New BIN to be added or existing BIN to be updated.
  • cardBrand: Card brand of the BIN.
  • cardType: Type of card (credit or debit).
  • country: Country where the card will be used.
  • bank: Issuing bank of the card.
  • cvvSize: Number of characters in the CVV (Card Verification Value).
  • cardLevel: Card category (e.g., Gold, Platinum, Black, among others).

Template example:

{"base64":"  ","img":{"width":1532,"height":199,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":46127,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Payments/Payments%20overview/adding-bin-information_2.PNG"}}

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
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