🔐 Permisos de rol necesarios: Gateways (Pasarelas)
Crear pasarela
En el panel de Ventrata, ve a Supplier Settings (Configuración del proveedor) > Gateways (Pasarelas).
Gateways (Pasarelas)
Selecciona el tipo de pasarela deseado.
En el lado izquierdo del formulario, introduce un nombre para la pasarela.
La casilla 'Active (Activo)' debe estar seleccionada para que la pasarela se utilice en las áreas definidas; consulta el paso 8.
Gateway Name (Nombre de la pasarela)
Selecciona qué monedas se pueden usar para realizar pagos a través de esta pasarela.
Currencies (Monedas)
📒 NOTA
La lista de monedas proviene de las monedas seleccionadas en la Supplier Settings (Configuración del proveedor).
Aplica una comisión (un % del precio total) para, por ejemplo, transacciones con tarjeta de crédito o transferencias bancarias.
Surcharge (Recargo)
Marca la casilla 'Custom Gateway (Pasarela personalizada)' si tu pasarela está fuera de la integración estándar de Ventrata.
Custom Gateway (Pasarela personalizada)
📒 NOTA
Para más información, ponte en contacto con tu representante de Customer Success de Ventrata.
Selecciona las fuentes donde se utilizará la pasarela para procesar pagos:
E-commerce (Comercio electrónico) - usado por los clientes en el web checkout
MOTO - usado por vendedores internos y agentes revendedores en el portal de ventas
Point of Sale (Punto de venta) - usado por vendedores internos y agentes revendedores en la app de terminal de Ventrata
Sources (Orígenes)
Selecciona las áreas específicas donde se usará la pasarela para procesar pagos:
Destinations (Destinos), Checkouts y Portals (Portales)
📒 NOTA
Asegúrate de que las pasarelas apropiadas también estén seleccionadas en el destino, checkout y portal específicos.
La mitad derecha del formulario de la pasarela es diferente para cada pasarela; consulta más abajo. Trabaja con tu Ventrata Payment Specialist o tu representante de Customer Success para completar el formulario.
Cuando estés listo, pulsa el botón Create Gateway (Crear pasarela).
Create Gateway (Crear pasarela)
Lista de campos para las pasarelas seleccionadas
Adyen
Adyen
Adyen
Campo | Descripción |
Merchant Account (Cuenta de comerciante) | El nombre de la cuenta de comerciante que deseas vincular a esta pasarela, tal como aparece en el área de clientes de Adyen. |
Test Mode (Modo de prueba) | Activa para cambiar este gateway (pasarela) a modo de prueba |
Test Mode Gateway (Gateway en modo de prueba) | Si se trata de un gateway en vivo, selecciona un gateway de prueba para utilizarlo en las pruebas |
Live URL Prefix (Prefijo de URL en vivo) | Garantiza que las transacciones se enruten correctamente a tu entorno de Adyen. Ve a Developers > API URLs > Prefix para Get Live URL Prefix (Obtener Prefijo de URL en vivo) |
Require Holder Name (Requerir nombre del titular) | El cliente debe introducir el nombre del titular de la tarjeta o de la cuenta durante el checkout. |
Require Billing Address (Requerir dirección de facturación) | El cliente debe proporcionar su dirección de facturación durante el checkout. |
Require Billing Address (Requerir dirección de facturación) | El cliente debe proporcionar su dirección de facturación durante el checkout. |
Billing Address Mode (Modo de dirección de facturación) | Full (Completa) El cliente debe proporcionar su dirección de facturación completa. Dependiendo del país, esto puede incluir:
Partial (Parcial) Solo se requiere que el cliente proporcione su código postal |
API Key (Clave API) | Un identificador único utilizado para la autenticación que garantiza la comunicación segura entre Ventrata y Adyen. |
Terminal API Key (Clave API de terminal) | Una clave segura utilizada para procesar pagos, emitir reembolsos, recopilar información del cliente y realizar otras interacciones en los terminales de pago de Adyen. |
API Client Key (Clave API de cliente) | Una clave pública utilizada para la autenticación del lado del cliente. Permite a Adyen verificar que las solicitudes realizadas desde Ventrata son legítimas y están autorizadas. |
Report User (Usuario de informes) | Nombre de usuario del usuario de informes en tu área de cliente de Adyen, utilizado para descargar informes mediante la API. |
Report Password (Contraseña de informes) | Contraseña (token de autenticación básica) generada en el Área de Cliente de Adyen para autenticar al usuario de informes y descargar los informes. |
Print Customer Receipt (Imprimir recibo del cliente) | Genera e imprime un recibo para el cliente. |
Printer Merchant Receipt (Imprimir recibo del comerciante) | Genera e imprime una copia del recibo para el comerciante con fines de registro. |
Allowed Payment Brands (Marcas de pago permitidas) | Selecciona qué métodos de pago basados en código QR debe aceptar tu terminal POS. |
ApplePay Domains (Dominios de Apple Pay) | Introduce el dominio de tu(s) sitio(s) web (donde el archivo de asociación de Apple Pay reside) para habilitar los pagos con Apple Pay |
📒 NOTA Antes de añadir el dominio de tu sitio web en la configuración del gateway, asegúrate de haber completado todos los pasos para integrar Apple Pay con Adyen, incluido alojar el archivo de asociación de Apple en tu dominio. | |
⛔️ WARNING (ADVERTENCIA) No actualices la configuración de Apple Pay directamente en el área de clientes de Adyen. Todas las configuraciones de Apple Pay deben gestionarse a través del panel de Ventrata. | |
Allow Manual Key Entry (MKE) (Permitir introducción manual) | Permite a los clientes introducir manualmente los datos de su tarjeta en un dispositivo terminal cuando este no puede leerla. |
Ventrata Adyen
Ventrata Adyen
Ventrata Adyen
Campo | Descripción |
Merchant Account (Cuenta de comerciante) | El nombre de la cuenta de comerciante que deseas vincular a esta pasarela, tal como aparece en el área de clientes de Adyen. |
Require Holder Name (Requerir nombre del titular) | El cliente debe introducir el nombre del titular de la tarjeta o de la cuenta durante el checkout. |
Require Billing Address (Requerir dirección de facturación) | El cliente debe proporcionar su dirección de facturación durante el checkout. |
Billing Address Mode (Modo de dirección de facturación) | Full (Completa) El cliente debe proporcionar su dirección de facturación completa. Dependiendo del país, esto puede incluir:
Partial (Parcial) Solo se requiere que el cliente proporcione su código postal |
Print Customer Receipt (Imprimir recibo del cliente) | Genera e imprime un recibo para el cliente. |
Printer Merchant Receipt (Imprimir recibo del comerciante) | Genera e imprime una copia del recibo para el comerciante con fines de registro. |
Allowed Payment Brands (Marcas de pago permitidas) | Selecciona qué métodos de pago basados en código QR debe aceptar tu terminal POS. |
ApplePay Domains (Dominios de Apple Pay) | Introduce el dominio de tu(s) sitio(s) web (donde el archivo de asociación de Apple Pay reside) para habilitar los pagos con Apple Pay |
📒 NOTA Antes de añadir el dominio de tu sitio web en la configuración del gateway, asegúrate de haber completado todos los pasos para integrar Apple Pay con Adyen, incluido alojar el archivo de asociación de Apple en tu dominio. | |
⛔️ WARNING (ADVERTENCIA) No actualices la configuración de Apple Pay directamente en el área de clientes de Adyen. Todas las configuraciones de Apple Pay deben gestionarse a través del panel de Ventrata. | |
Allow Manual Key Entry (MKE) (Permitir introducción manual) | Permite a los clientes introducir manualmente los datos de su tarjeta en un dispositivo terminal cuando este no puede leerla. |
VivaWallet
VivaWallet
VivaWallet
Campo | Descripción |
Currency (Moneda) | Debe coincidir con la moneda configurada en tu cuenta de VivaWallet. |
Demo Account (Cuenta de demostración) | Indica si estás conectándote a una cuenta de demostración de VivaWallet. |
Merchant ID (ID de comerciante) | Un identificador único para tu cuenta de VivaWallet. En tu cuenta de VivaWallet, navega a Settings > API Access. |
API Key (Clave API) | Se utiliza para autenticar las solicitudes API con VivaWallet. En tu cuenta de VivaWallet, navega a Settings > API Access para obtener tu clave. |
Native Checkout Client ID (ID de cliente de Native Checkout) | Un identificador único para tu Native Checkout, usado para procesar pagos. |
Native Checkout Client Secret (Clave secreta de cliente de Native Checkout) | Se utiliza para autenticar los pagos realizados a través de tu Native Checkout. |
Smart Checkout Client ID (ID de cliente de Smart Checkout) | Un identificador único para Smart Checkout, la pasarela de pago en línea de VivaWallet para plataformas de comercio electrónico. En tu cuenta de VivaWallet, navega a Settings > API Access para obtener este ID. |
Smart Checkout Client Secret (Clave secreta de cliente de Smart Checkout) | Se utiliza para autenticar tu aplicación con la pasarela de pago Smart Checkout. En tu cuenta de VivaWallet, navega a Settings > API Access para obtener esta clave. |
Source Code (Código de origen) | Un código de cuatro dígitos que identifica una fuente de pago específica en tu cuenta de VivaWallet. En tu cuenta de VivaWallet, navega a Sales > Online Payments > Website Apps para encontrar tu Source Code. |
Print Customer Receipt (Imprimir recibo del cliente) | Genera e imprime recibos para el cliente. |
Printer Merchant Receipt (Imprimir recibo del comerciante) | Genera e imprime una copia del recibo para el comerciante con fines de registro. |
Order Gateways (Ordenar Gateways)
En la tabla Gateways (Pasarelas), toma la parte más a la izquierda de cada fila y reordena tus gateways existentes en el orden en que se utilizarán en los
Origenes,
monedas,
destinos,
checkouts,
y portales
que admite el gateway, consulta Crear pasarela arriba.
Reordenar Gateways
📒 NOTA
El orden en que se listan los gateways no afecta cómo las ubicaciones y terminales solo utilizan gateways. Las ubicaciones y los terminales también ignoran si el gateway está 'active' (activo) y los origenes seleccionados.
Las ubicaciones y los terminales utilizan el gateway seleccionado en los formularios de ubicación y terminal, respectivamente.












