The Sales App card entry feature allows the store to sell using credit cards without payment terminals. The solution enables card payment through VTEX Sales App and allows for automatic card scanning or manual data entry. The process is secure since the data is masked and the information isn't stored.
This feature ensures the purchase is processed through the same gateway as the ecommerce website, applying the existing checkout settings. After the sale, the payment confirmation is done through VTEX Sales App.
This article introduces the solution Sales App card entry and is organized in the following sections:
Characteristics
Sales App card entry has the following characteristics:
- ✅ Allows payments with the same credit card network as the ecommerce website.
- ✅ Includes the same payment conditions and installments provided by the ecommerce website.
- ✅ It's PCI compliant, meaning it protects customer data and doesn't store sensitive information.
However, the feature has some restrictions:
- ❌ Doesn't support third-party private label payments.
- ❌ Doesn't allow using multiple cards for a single purchase.
Advantages
The following table presents the main advantages of using Sales App card entry:
Topic | Description |
---|---|
Speed and convenience | Scanning the customer's card and the option of automatic or manual card entry streamline and speed up the purchase process. |
Integrated and frictionless experience | The purchase and the payment confirmation take place in VTEX Sales App, eliminating the need for multiple environments to complete a sale and promoting a seamless experience. |
Secure purchases | During the purchase, the customer watches the card scanning and (automatic or manual) data entry process, which keeps the information masked and doesn't store it after the purchase is completed. |
Virtual card support | Sales App card entrysupports physical card with BINs and virtual cards, expanding payment options for customers. |
Payment starter kit | In addition to the shared cart (Social Selling) option, Sales App card entry allows merchants starting to use VTEX Sales App to integrate the solution without having to get an additional acquirer. |
Use cases
When using Sales App card entry for endless aisle sales with default shipping (over 24 hours), the purchase follows the same checkout flow as the ecommerce website and is classified as a card-not-present transaction — a technical term applied when the payment doesn't count has having used a physical card.
Transactions made using this feature are subject to anti-fraud rules. Approval may take up to 24 hours if the purchase requires anti-fraud authorization. For this reason, we don't recommend using Sales App card entry in the following scenarios:
- Sales with express shipping
- Local inventory sales (On Hands)
If the store has a trade policy specifically for VTEX Sales App with an exclusive anti-fraud rule review, you can use Sales App card entry for sales with local inventory (On Hands) or express shipping.
Settings
The settings required to activate the feature differ for stores that already use VTEX Sales App or will start using the solution.
Before enabling the feature, make sure that the store is integrated with a payment partner and can process credit card sales.
Stores starting to use VTEX Sales App
When setting up VTEX Sales App, in the payment method activation step, keep the option Sales App card entry enabled.
Stores using VTEX Sales App
To use Sales App card entry, there are two main settings that need to be enabled: one for Checkout and another for Payments.
Checkout configuration
Credit card network IDs need to be enabled as payment methods in the VTEX Sales App payment settings. To confirm, follow the steps below:
- In the VTEX Admin, go to Store Settings > Storefront > Checkout or type Checkout in the search bar at the top of the page.
- Click the icon in
Default
. - Click the Code tab
- In Files, click
checkout-instore-custom.js
. - Check the information, and if you add a new payment ID, click
Save
.
Payments configuration
Credit card network IDs need to be enabled for payments in this method. To confirm they are, follow the steps below:
- In the VTEX Admin, go to Store settings > Payment > Settings or type Settings in the search bar at the top of the page.
- Check if the IDs of the credit card networks are
Active
. If they aren't, proceed to the next step. - Set up a credit card payment condition for your store.
Using the solution
After completing the system settings, check the instructions for selling with Sales App card entry.
Before the sale
Enable the mobile camera in VTEX Sales App through the app settings or the first time you access Sales App card entry. This setup is required for card scanning.
Completing the sale
Follow the steps below to sell using Sales App card entry:
- In the VTEX Sales App checkout, in the
Select a payment method
step, clickEnter card
. - Select the option to scan the card or enter the data manually.
- Automatically capture the card data with the capture screen or enter the data manually. The front and back of the card must be scanned.
- After the payment is approved, the purchase confirmation is made in VTEX Sales App.
Customers can scan the card or manually enter the data themselves if they prefer.