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
Payment Settings
Setting up Private Label payments
Setting up Private Label payments

At VTEX, your store can receive payments with private label (self card brand). For this, you will first need to register a gateway affiliation that can process this payment method.

Then, two setting steps must be performed.

Setting up the self brand

With one of the above gateway affiliations successfully registered, you must set up the private label custom payment.

  1. In the VTEX Admin, go to Store Settings > Payment > Settings, or type Settings in the search bar at the top of the page.
  2. On the main screen, go to the Custom Payments tab.
  3. Each custom payment type allows up to 5 different settings. In the section reserved for private label, click on one of the configuration boxes.
  4. You will be redirected to a form. In the Name field, fill in the name of the card.
  5. In the Description field, write the text that will give more details about the payment condition.
  6. In BIN ranges, enter the BIN codes of the cards so that they are validated by the system. You can insert a range of BINs (by inserting the first and last code of the sequence, separated by hyphen) or several (separating each one by comma and without spaces).
  7. In Acquirer payment code, indicate the code to be sent and processed by the acquirer you have hired.
  8. In the Use card holder's name field, set whether the user will need to enter the name that is printed on the card at the time of purchase.
  9. In Number of CVV digits, inform how many numbers the CVV user will need to fill at the time of purchase (in Brazil, the most common are 3-digit codes). You can also choose not to ask for this information.
  10. In Use the card's expiration date?, inform if the user will need to fill the expiration date of the card at the time of purchase (the fill-in format is MM/YY).
  11. In Use billing address?, set whether the user will need to fill in a billing address at the time of purchase.
  12. In the Card mask field, choose the symbols that will represent the 16-digit card at the time of purchase. This is meant to protect your customer's card number. You can choose the characters you prefer by separating them into four groups of four and using spaces.
  13. In Payment expiration date, inform the maximum period (number of days) that the payment can be made. After this time, in case of non-payment, the order will be cancelled.
  14. In the Automatic authorization field, inform whether you want to automatically authorize payments.
  15. In Split payment (if the payment processing provider supports this function), indicate whether you want to activate the receivables split solution. If so, when the sale involves orders with multiple merchants, the promissory notes will be divided between the sellers and the marketplace. For more information, see Split Payment.
  16. Click Save.

Setting up the payment condition

After clicking Save, you will be redirected to the payment condition configuration page.

  1. Click the Status button to enable this payment condition.
  2. Under Process with affiliation, choose the connector that will process your private label payments (one of the gateway affiliations you registered in the first step of this tutorial).
  3. If there's an anti-fraud set up in your store, you can enable it for this payment condition by checking the Use Anti-Fraud box.
  4. Choose whether the payments will be cash or installments.
  5. You can also set up special payment conditions.
  6. Click Save.

After following the steps indicated above, your private label will appear at your store checkout as a payment option.

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