VTEX Plugin Configuration - Argentina
This guide details the integration and configuration process for the Getnet payment method on the VTEX platform.
Prerequisites
Before starting, ensure you have administrative access to VTEX Admin, access to the Getnet Portal, and production credentials from Getnet (Client ID and Client Secret).
This guide covers standard configuration. Advanced technical troubleshooting is not included.
Step 1: Credential Generation
To obtain the necessary integration keys:
- Access the Getnet Portal.
- In the main menu, navigate to Productos Digitales > Integraciones.
- Select the Checkout API option.
- Click Generar credenciales.
The system will generate:
- Client ID (application key)
- Client Secret (application token)
These credentials will not be visible again. Copy and store them securely immediately.
Step 2: Application Installation in VTEX
- Access VTEX Admin (
https://app.ads.vtex.com/login?callback_url=/) with your administrator user. - In VTEX Admin, go to Configuración de la tienda > Pago > Configuración.
- Click Nuevo proveedor de pago and search for Getnet Argentina.
- Fill in the provider fields:
- Clave de la aplicación: Paste the value of the Client ID generated in the Getnet Portal.
- Token de la aplicación: Paste the generated Client Secret.
- Nombre: Define an identifiable name (e.g., Getnet, Getnet_Cuota_Simple).
- Planes: Select the option of plan you want to configure.
- Control de Pago: Uncheck the “Habilitar modo de prueba” option for production.
- Save the configuration. On the newxt window, click on Instalar app and you’ll be redirected to the Getnet extension.
If you will configure more than one plan, create a provider for each plan, differentiating them by name (e.g., Getnet_Cuota_Simple, Getnet_Plan_Emisor, Getnet_Plan_Getnet).
Step 3: Payment Methods Configuration
- Still in the dashboard, go to Configuración de la tienda > Pago > Configuración, and click the + button to create a new payment condition.
- On the next screen, you can configure each payment provider. For each one, keep these things in mind:
- Estado: Set to Activo.
- Conector: Select the correct Getnet connector.
- Número total de cuotas: Enter the allowed options (e.g., 1, 3, 6, 12).
- Cuota mínima: Set the minimum installment value to 1.
Step 4: Promotions and Special Conditions (Optional)
Within the payment condition editing:
-
Click Agregar condición especial.
-
Choose the condition type, such as:
- Fecha de vencimiento (Specific period)
- Emisor de la tarjeta (Card issuer)
- Política comercial (Sales channel)
- Condición comercial
- Nombre de la cuenta
-
Enter the other values for the fields:
- País: Select Argentina.
- Banco: Select Santander.
- Faturación: Select “Fin de período”.
- Intereses externos: Set to “Inactivo”.
- To register a promotion that applies on a specific day with a particular card, click Agregar condición especial again and select Fecha de vencimiento (Expiration date). In the form that appears, you can enter the days and times when the promotion applies:
Step 5: Configuration Verification
We recommend that you perform a verification. In the VTEX portal, go to Configuración de la tienda > PAGO > Configuración and check that:
- Getnet appears ACTIVO for the configured card types (e.g. VISA, MASTERCARD).
- The correct Getnet provider is linked to each payment condition (e.g. Credito (Plan Emisor), Visa Cuota Simple).
- The recently configured payment methods are ready and show active in the list, with the expected installment options (e.g. Dividido En: 1x, 3x, 6x, 12x).
Changes may take up to 10 minutes to reflect in the store checkout.
Step 8: Sales Viewing
To view completed sales:
- Access VTEX Admin.
- Go to Pedidos > Transacciones.
- Locate transactions associated with the Getnet connector.