Transbank¶
Producto: OpenTPV | Módulo: Integraciones | Última actualización: 2026-03-18
Introducción¶
OpenTPV se integra nativamente con los terminales de pago Transbank, permitiendo enviar el monto de la venta directamente al POS sin necesidad de digitarlo manualmente. La integración soporta pagos con tarjeta de débito y crédito, con manejo automático de cuotas, anulaciones y cierres de turno.
Requisitos¶
| Requisito | Detalle |
|---|---|
| Terminal Transbank | POS compatible con integración (Verifone, Ingenico) |
| Puerto COM | Puerto serie o USB configurado en la conexión |
| Llaves de encriptación | Proporcionadas por Transbank |
| Contrato | Contrato de comercio con Transbank vigente |
Configuración¶
Conectar el terminal¶
- Vaya a Administración → Conexiones
- En la sección de dispositivos:
- Seleccione el Puerto POS (puerto COM del terminal)
- Active POS Integrado
- Guarde la configuración
Cargar llaves de encriptación¶
- En el TPV, acceda a las funciones de Transbank (requiere permiso
Cargar Llaves) - Haga clic en Cargar Llaves
- El terminal descargará las llaves desde los servidores de Transbank
- Espere la confirmación
Flujo de Pago¶
Pago con tarjeta de débito¶
- En el formulario de cobro, seleccione Tarjeta Débito
- El sistema envía automáticamente el monto al terminal Transbank
- El terminal muestra el monto al cliente
- El cliente acerca o inserta su tarjeta
- El cliente ingresa su PIN
- El terminal procesa la transacción
- OpenTPV recibe la respuesta automáticamente:
| Dato | Descripción |
|---|---|
| Código Autorización | Código de la transacción aprobada |
| Número Operación | Identificador de la operación |
| Marca Tarjeta | Visa, Mastercard, etc. |
| Tipo Tarjeta | Débito |
| Últimos 4 Dígitos | Últimos 4 dígitos de la tarjeta |
Pago con tarjeta de crédito¶
- Seleccione Tarjeta Crédito
- El proceso es similar al débito
- Adicionalmente se registra:
| Dato | Descripción |
|---|---|
| Cantidad Cuotas | Número de cuotas seleccionadas |
| Monto Cuotas | Valor de cada cuota |
Ingreso manual¶
Si la integración no está disponible o falla: 1. Haga clic en Ingreso Manual 2. Ingrese el Número de Operación del voucher 3. Ingrese el Código de Autorización 4. Haga clic en Guardar Pago
Funciones del Terminal¶
Los usuarios con permisos correspondientes pueden acceder a:
| Función | Permiso Requerido | Descripción |
|---|---|---|
| Chequear Conexión | chkTbkChequearConexion |
Verifica que el terminal responda |
| Cargar Llaves | chkTbkCargarLlaves |
Descarga llaves de encriptación |
| Modo Desintegrado | chkTbkModoDesintegrado |
Usa el terminal sin integración |
| Cerrar Turno | chkTbkCerrarTurno |
Cierra el turno del terminal (cuadre) |
| Anular Crédito | chkTbkAnularCredito |
Anula una transacción de crédito |
| Último Pago | chkTbkUltimoPago |
Consulta la última transacción |
| Detalle Pagos | chkTbkDetallePagos |
Lista las transacciones del turno |
| Totales | chkTbkTotales |
Muestra totales acumulados |
Reintentar un Pago¶
Si la transacción falla (timeout, error de comunicación): 1. El sistema muestra el error 2. Haga clic en Reintentar Pago para enviar nuevamente al terminal 3. Si persiste el error, use Ingreso Manual para registrar la transacción procesada directamente en el terminal
Preguntas Frecuentes¶
¿Qué pasa si el terminal pierde conexión durante un pago? Si la transacción se aprobó en Transbank pero OpenTPV no recibió la respuesta, use "Último Pago" para verificar y luego "Ingreso Manual" para registrarla.
¿Puedo anular una venta con tarjeta? Solo las transacciones de crédito pueden anularse el mismo día. Las de débito no se pueden anular desde el terminal.
¿Necesito cerrar turno en el terminal? Sí. Se recomienda cerrar turno en el terminal al final del día, junto con el Cierre Z de la caja.
¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl