OdooWiki OCA HUB

POS Payment Terminal

pos_payment_terminal folder_open OCA/pos open_in_new
Point Of Sale Licencia: AGPL-3

Este módulo añade soporte para el lector de tarjetas de crédito y la impresora de cheques en el Punto de Venta.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Conecta el Punto de Venta de Odoo a un terminal de pago genérico con tarjeta o cheque a través del proxy IoT, para que los cajeros puedan enviar el importe al terminal y recibir el resultado automáticamente.

Este módulo permite usar un terminal de pago externo (lector de tarjetas o impresora de cheques) directamente desde el Punto de Venta. Se habilita por punto de venta en los ajustes: active "OCA Payment Terminal" y, opcionalmente, "Hide Back Button".

En cada método de pago puede entonces elegir "OCA Payment Terminal" como tipo de terminal, establecer si es un terminal de Tarjeta o de Cheque, introducir el identificador del terminal usado por el proxy de hardware y habilitar Fast Payment para una respuesta más rápida.

Durante el cobro, cuando el cajero selecciona dicho método de pago, el importe se envía al terminal. La pantalla muestra un estado de espera y comprueba regularmente el terminal hasta que la transacción se realiza correctamente o falla. Si no se puede contactar con el terminal, se pide al cajero que confirme el resultado manualmente. Los importes negativos se rechazan con un mensaje de error.

Si "Hide Back Button" está activado, una vez que existe una línea de pago el cajero no puede volver a la cesta desde la pantalla de pago, lo que evita cambios accidentales después de haber iniciado un pago.

El módulo añade campos a pos.config, pos.payment.method y res.config.settings, y parchea el store del frontend del Punto de Venta y el comportamiento de los pedidos.

Depende de

point_of_sale
Modelos y campos (3)
  • pos.config · amplía un modelo existenteiface_payment_terminal (OCA Payment Terminal), payment_terminal_hide_back_btn (Hide Back Button)
  • pos.payment.method · amplía un modelo existenteoca_fast_payment (Fast Payment), oca_payment_terminal_id (Terminal Identifier), oca_payment_terminal_mode (Payment Mode)
  • res.config.settings · amplía un modelo existentepos_iface_payment_terminal, pos_payment_terminal_hide_back_btn

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Este módulo está diseñado para instalarse en el servidor principal de Odoo. En la POSbox/IoTbox, debe instalar el módulo hw_x según el protocolo implementado en su dispositivo.

Los lectores de tarjetas Ingenico \ para Francia admiten el protocolo Telium implementado en el módulo hw_telium_payment_terminal para la POSbox/IoTBox.

También puede considerar el proyecto pywebdriver como alternativa a la POSbox/IoTbox.

  • Vaya a Punto de venta \> Configuración \> Métodos de pago, edite el método de pago correspondiente al lector de tarjetas y establezca el campo Usar un terminal de pago en OCA Payment Terminal. Aparecerá un nuevo campo Modo de pago, que tiene Tarjeta como valor predeterminado. Si el método de pago es para Cheques y tiene una impresora de cheques, seleccione Cheque en su lugar.
  • En el frontend del POS, cuando seleccionas un método de pago que tiene un

modo de pago con Use a Payment Terminal establecido en OCA Payment Terminal, tendrás un botón Send adicional: si haces clic en ese botón, el importe, la moneda y el modo de pago se enviarán al POSbox/IoTBox/pywebdriver.

  • Para habilitar el proxy cuando se usa OCA Payment Termail, puedes ir a

Point of Sale > Settings > Connected Devices, luego habilitar IoT Box, introducir IP Address y habilitar OCA Payment Terminal. Cuando OCA Payment Terminal está habilitado, puedes bloquear el regreso a la cesta desde la pantalla de pago habilitando la opción Hide Back Button.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.