Plugins
VTEX
VTEX es la plataforma de comercio digital líder en Latinoamérica, utilizada por grandes marcas y retailers para gestionar sus tiendas en línea con alto volumen de transacciones. Con el conector nativo de PaymentsWay puedes activar Visa, Mastercard y PSE en tu tienda VTEX en tres pasos simples — sin desarrollo, sin código, en menos de 15 minutos.
Configuración 100% visual desde el panel de VTEX.
Los tres métodos activos con un solo conector.
Conector oficial VTEX Payment Provider.
El cliente paga en el portal de PaymentsWay y vuelve a tu tienda.
Flujo de integración
El diagrama muestra los tres pasos de configuración (que se hacen una sola vez) y el flujo de cada pago desde el checkout de VTEX hasta la confirmación:
Requisitos previos
Antes de iniciar ten a mano los siguientes datos — los entrega el equipo de PaymentsWay:
| Dato | Ejemplo | Dónde obtenerlo |
|---|---|---|
Merchant ID | 65 | Panel PaymentsWay → Mis Credenciales |
Terminal ID | 511 | Panel PaymentsWay → Mis Credenciales |
Form ID | 602 | Panel PaymentsWay → Botones de Pago |
API Key | N2Y5NGQy... | Solicitar a soporte@paymentsway.co |
Necesitas acceso de administrador a tu tienda VTEX con rol Owner o Finance.
Paso 1 — Generar App Key y App Token en VTEX
El App Key y App Token son las credenciales que permiten al conector de PaymentsWay comunicarse de forma segura con tu tienda VTEX. Se generan una sola vez.
Ruta: Ícono de usuario (arriba a la derecha) → Account Settings → API Keys
URL directa: https://{su-cuenta}.myvtex.com/admin/api-keys
Inicia sesión en el admin de tu tienda VTEX:
https://{su-cuenta}.myvtex.com/adminHaz clic en el avatar de usuario (esquina superior derecha) y selecciona "Account Settings".
Haz clic en "API Keys" y luego en "+ New API Key" (o "Generate Key").
Asigna el nombre
"PaymentsWay-Produccion"y el rol "Owner" (o mínimo "FinancePayments").Haz clic en "Generate". VTEX te mostrará el App Key y un link para obtener el App Token — copia ambos de inmediato.
El App Token se muestra una sola vez. Si cierras la pantalla sin copiarlo tendrás que generar uno nuevo. Guárdalo en un gestor de contraseñas.
El App Key tiene el formato: vtexappkey-{nombretienda}-XXXXXX
| Campo | Ejemplo |
|---|---|
App Key | vtexappkey-mitienda-UCXFKW |
App Token | XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX (cadena larga) |
Paso 2 — Crear el proveedor de pago PaymentsWay
Ruta: Store Settings → Payment → Providers
URL directa: https://{su-cuenta}.myvtex.com/admin/affiliations
En el menú lateral ve a Store Settings → Payment → Providers.
Haz clic en "New Provider", escribe "PaymentsWay" en el buscador y selecciónalo.
Completa el formulario con los valores de la siguiente tabla.
Haz clic en "Guardar". El proveedor aparecerá como "Production".
| Campo del formulario | Valor a ingresar |
|---|---|
Nombre (Name) | PaymentsWay Prod (o el nombre que prefieras) |
Ambiente (Mode) | Production |
App Key | El App Key generado en el Paso 1 |
App Token | El App Token generado en el Paso 1 |
merchantId | Entregado por PaymentsWay. Ej: 65 |
terminalId | Entregado por PaymentsWay. Ej: 511 |
formId | Entregado por PaymentsWay. Ej: 602 |
apiKey | Clave API de PaymentsWay (diferente al App Key de VTEX) |
Workspace | master |
El campo apiKey es la clave de PaymentsWay, distinta al App Key de VTEX. Si la clave tiene espacios o saltos de línea, pégala sin ellos. Su longitud debe ser múltiplo de 4 — si no, añade = al final.
Paso 3 — Configurar métodos de pago
Repite este proceso una vez por cada método: Visa, Mastercard y PSE.
Ruta: Store Settings → Payment → Settings → pestaña "Payment Conditions"
URL directa: https://{su-cuenta}.myvtex.com/admin/pci-gateway#/rules
Haz clic en el botón verde "+" para agregar una nueva condición.
Busca y selecciona el método de pago: Visa.
En el campo Provider selecciona "PaymentsWay".
Asigna el nombre "PaymentsWay Visa".
Cuotas: deja "En una cuota" o configura según tu necesidad.
Haz clic en "Guardar". Repite para Mastercard y PSE.
PSE es un método de débito bancario exclusivo para Colombia. No requiere configuración de cuotas — siempre es un pago en una sola cuota. El cliente es redirigido al portal de su banco para completar el pago.
Al terminar la sección Payment Conditions debe mostrar:
| Método | Nombre | Estado |
|---|---|---|
| VISA | PaymentsWay Visa | ACTIVE |
| MASTERCARD | PaymentsWay Mastercard | ACTIVE |
| PSE | PaymentsWay PSE | ACTIVE |
Datos de referencia del conector
| Parámetro | Valor |
|---|---|
Nombre del conector | PaymentsWay |
Versión | 1.0.0 |
Tipo de integración | VTEX Payment Provider (IO Connector) |
Flujo de pago | Redirect — redirige al portal de PaymentsWay y regresa a la tienda |
Ambiente de producción | https://merchant.paymentsway.co |
Métodos soportados | Visa, Mastercard, PSE (débito bancario Colombia) |
Moneda | COP (Peso Colombiano) |
Reembolsos / Cancelaciones | Gestionados directamente en el portal de PaymentsWay |
Verificación final
Realiza una compra de prueba desde el checkout de tu tienda con un monto mínimo ($1.055 COP) para confirmar que el flujo redirige correctamente al portal de PaymentsWay y regresa a la tienda al completar la transacción.
Soporte
| Canal | Detalle |
|---|---|
| soporte@paymentsway.co | |
| Web | www.paymentsway.co |
| Teléfono | 601-7035887 · 315-5546305 |
| Dirección | Carrera 11A N° 93-52, oficina 503, Bogotá, Colombia |
Magento
Magento (Adobe Commerce) es la plataforma de comercio electrónico empresarial preferida por negocios de mediano y gran tamaño. La extensión de PaymentsWay para Magento 2 se instala vía cPanel sin necesidad de Composer ni acceso por SSH.
POSTCrear link con redirección
Genera un link de pago desde tu backend. El cliente es redirigido automáticamente al checkout al acceder al link.