Visión General
Integra pagos con tarjeta presente a través de OEL
Conecta terminales de pago, aplicaciones Android y equipos propios a nuestra plataforma de procesamiento de pagos. Consulta las modalidades de integración disponibles, conoce las operaciones que puedes implementar y accede a la documentación técnica para comenzar tu desarrollo.
¿Qué son los pagos presenciales?
Los pagos presenciales, también conocidos como Tarjeta Presente (Card Present), permiten procesar operaciones en las que el cliente se encuentra físicamente en el punto de venta y presenta su tarjeta o utiliza un medio de pago compatible con el dispositivo.
OEL proporciona servicios para integrar este tipo de operaciones con terminales de pago y aplicaciones comerciales, permitiendo que los sistemas del comercio se comuniquen con el Gateway para solicitar operaciones y recibir sus resultados.
La solución está diseñada para integrarse en distintos escenarios, como tiendas, restaurantes, comercios minoristas, puntos de venta y aplicaciones de cobro en campo, de acuerdo con los dispositivos y servicios habilitados para cada implementación.
¿Qué puedes desarrollar?
Aplicaciones de punto de venta (POS).
Integraciones con terminales de pago compatibles.
Aplicaciones Android mediante SDK.
Integraciones SOAP con equipos y sistemas propios.
Flujos de venta, preautorización y operaciones posteriores.
Consultas transaccionales y herramientas de apoyo para conciliación.
Elige tu modalidad de integración
Selecciona el camino que mejor se adapte a tu infraestructura, dispositivos y arquitectura de software.
1. Integración mediante SDK Android
Ideal para: desarrolladores que integran pagos en una aplicación Android y utilizan dispositivos compatibles con el SDK de OEL.
El SDK proporciona los componentes de integración necesarios para implementar el flujo de pago desde una aplicación compatible, de acuerdo con las capacidades del dispositivo y la versión del SDK.
Encontrarás en esta sección:
Requisitos de desarrollo.
Dispositivos y versiones compatibles.
Instalación y configuración.
Inicialización del SDK.
Ejecución de operaciones.
Manejo de resultados y errores.
Ejemplos de implementación.
2. Integración SOAP con equipos propios
Ideal para: integradores que cuentan con hardware, aplicaciones POS o sistemas propios y necesitan consumir directamente los servicios SOAP de OpGateway.
Esta modalidad permite invocar los métodos habilitados para pagos presenciales mediante solicitudes SOAP, respetando los requisitos de autenticación, estructura de mensajes y tratamiento de datos definidos por el servicio.
Encontrarás en esta sección:
Arquitectura de integración.
Configuración del servicio y autenticación.
Contratos WSDL y estructura de mensajes.
Métodos y parámetros de entrada.
Estructuras de respuesta.
Ejemplos de solicitudes SOAP.
Manejo de errores y validación de operaciones.
3. Terminales compatibles
Ideal para: comercios e integradores que necesitan identificar los dispositivos disponibles para una solución de pagos presenciales.
Consulta los equipos compatibles, sus características y las modalidades de integración aplicables a cada modelo.
La compatibilidad puede variar según el hardware, sistema operativo, versión de software, certificaciones y configuración de procesamiento.
Encontrarás en esta sección:
Catálogo de terminales.
Especificaciones técnicas.
Capacidades de lectura y conectividad.
Compatibilidad con SDK.
Requisitos de configuración.
Documentación disponible por dispositivo.
¿Cómo funciona una transacción presencial?
El flujo general permite que la aplicación o terminal inicie una operación, el Gateway gestione la solicitud y el sistema reciba el resultado del procesamiento.
Flujo general
Inicio de la operación. El sistema del comercio genera una solicitud de pago con los datos requeridos para la transacción.
Captura del medio de pago. El dispositivo obtiene los datos necesarios mediante los mecanismos de lectura que tenga habilitados.
Procesamiento seguro. La solución transmite la operación a través del mecanismo de integración correspondiente.
Autorización. La solicitud se procesa a través de la infraestructura de pagos aplicable.
Respuesta. El sistema recibe el resultado de la operación y los datos de respuesta disponibles.
Registro y conciliación. El comercio registra el resultado y lo relaciona con su pedido, venta o referencia interna.
El comportamiento exacto, los datos transmitidos y los pasos adicionales dependen de la modalidad de integración y del tipo de operación.
Operaciones disponibles
OpGateway contempla distintos métodos para administrar el ciclo de vida de una transacción presencial. La disponibilidad de cada método depende del servicio, la configuración del comercio y las capacidades habilitadas para su integración.
Operaciones de pago
Venta — OpVenta
Permite solicitar el procesamiento de una operación de venta mediante la integración presencial correspondiente.
Preautorización — OpPreAutorizacion
Permite solicitar una autorización previa, cuando el producto y la configuración lo admiten, antes de completar el cargo definitivo.
Postautorización — OpPostAutorizacion
Permite completar el proceso asociado a una preautorización, de acuerdo con las reglas aplicables al servicio.
Operaciones posteriores
Cancelación — OpCancelacion
Permite solicitar la cancelación de una operación cuando cumple las condiciones establecidas por el servicio.
Devolución — OpDevolucion
Permite solicitar la devolución de una operación previamente procesada, de acuerdo con las reglas aplicables.
Reversa — OpReversa
Permite gestionar una reversa conforme al flujo y las condiciones definidos para la operación.
Consultas y servicios complementarios
OpObtenerVenta: consulta de información de una venta.OpTransacciones: consulta de transacciones.OpCortesDiarios: consulta de información de cortes diarios.OpVersion: consulta de información de versión del servicio.enviaVoucher: envío de información de voucher, cuando corresponda.enviaVoucherImagen: envío de imágenes de voucher, cuando corresponda.
Consulta la referencia técnica para conocer los parámetros, respuestas, restricciones y condiciones de uso de cada método.
Seguridad en pagos presenciales
La seguridad debe formar parte de la implementación desde el inicio. Cada integrador es responsable de cumplir los requisitos técnicos y operativos correspondientes a su modalidad de integración.
Recomendaciones generales:
Utiliza los mecanismos de comunicación segura establecidos para el servicio.
Protege las credenciales y evita incluirlas directamente en el código fuente.
No almacenes datos sensibles de tarjeta ni datos de autenticación prohibidos por los requisitos aplicables.
Respeta los mecanismos de captura, cifrado y tratamiento de datos definidos para el dispositivo y la integración.
Valida las respuestas antes de actualizar el estado de una venta.
Registra identificadores de transacción y datos operativos necesarios para la trazabilidad, sin exponer información sensible.
Implementa manejo de errores, tiempos de espera y recuperación ante interrupciones de comunicación.
Importante: una interrupción de comunicación no significa necesariamente que una operación haya sido rechazada. Antes de reintentar un cobro, utiliza los mecanismos de consulta o recuperación disponibles para determinar su estado y reducir el riesgo de duplicidad.
¿Qué necesitas para comenzar?
Antes de iniciar el desarrollo, asegúrate de contar con los siguientes elementos:
Modalidad de integración seleccionada.
Dispositivo compatible, cuando aplique.
Credenciales y endpoint de desarrollo.
Documentación técnica correspondiente.
Métodos habilitados para tu comercio.
Entorno de desarrollo configurado.
Estrategia de manejo de errores y trazabilidad.
Casos de prueba definidos.
Si todavía no cuentas con credenciales o desconoces qué métodos están habilitados para tu comercio, solicita esa información al equipo responsable de la integración antes de comenzar las pruebas.
Continúa con la documentación técnica
Selecciona la siguiente sección según el camino de desarrollo que utilizarás.
Integración SDK Android
Implementa pagos desde una aplicación Android compatible.
Integración SOAP con equipos propios
Consulta los contratos, métodos, parámetros y ejemplos de OpGateway.
Terminales compatibles
Identifica los dispositivos y requisitos técnicos de cada modelo.
Primeros pasos
Revisa los conceptos generales, los ambientes y el flujo recomendado de integración.
¿Listo para integrar pagos presenciales?
Selecciona tu modalidad de integración, prepara el ambiente de desarrollo y valida el flujo transaccional antes de solicitar la habilitación productiva.