Setting up payments with Virtualpos
3 min read
At VTEX, it is possible to integrate with the Virtualpos payment provider. With this provider, your store can make sales through Virtualpos.
To configure Virtualpos, follow the steps below:
- In the VTEX Admin, go to Store Settings > Payment > Providers, or type Providers in the search bar at the top of the page.
- On the providers screen, click the
New Provider
button. - Type the name Virtualpos in the search bar and click on the name of the provider.
- In Provider Authorization, fill in the App Key and App token fields with data provided by Virtualpos.
- If you wish to modify the identification name to be displayed for the Virtualpos provider on the VTEX Admin screen, enter the information in the Name field in Basic Information.
- In Payment Control, select whether you want to activate the provider in a test environment by clicking Enable test mode.
- In Provider Fields, select the desired option in the field Modo.
- Fill in the Api Key, Secret Key and URL Tienda fields with your Virtualpos account information.
- In the Automatic settlement field, select one of the following option:
- Use behavior recommended by the payment processor: Capture is not automatic; it is scheduled according to the period specified by the acquirer. The acquirer indicates whether the payment has been authorized and can determine or recommend a number of days for the capture upon payment authorization. (This is the platform's default behavior).
- Automatic capture immediately after payment authorization: Capture is automatically performed right after payment authorization, even if the transaction includes an anti-fraud analysis.
- Automatic capture immediately after anti-fraud analysis: Capture is automatically performed right after payment authorization and anti-fraud analysis. If you select this behavior and do not have anti-fraud analysis, the system will perform the payment capture as in "Automatic capture immediately after payment authorization".
- Disabled: Capture takes place only when the order is invoiced. If you select this behavior, it is important to pay attention to the invoicing time, as invoicing can exceed the capture time agreed with the payment provider and lead to the cancellation of the transaction.
- Click
Save
.
Setting up the payment condition
- In the VTEX Admin, go to Store Settings > Payment > Settings, or type Settings in the search bar at the top of the page.
- In the Payment Conditions tab, click on the
+
button. - Click on VirtualPOS.
- Activate the condition in the Status field.
- If you want to use an anti-fraud system, select the option Use anti-fraud solution.
- If you want, you can also configure special payment conditions.
- Click
Save
.
After following the indicated steps, Virtualpos may take up to 10 minutes to appear at your store's checkout as a payment option.