Venezuela: POS Mercantil C2P en Vuelto Digital

Integración Pago Móvil C2P y Vuelto Digital Banco Mercantil en Odoo 19 POS

Funcionalidades del módulo

• Cobro al cliente vía Pago Móvil interbancario
• Captura de teléfono, banco y cédula del pagador
• OTP solicitado al banco emisor (Tpago para Mercantil)
• Persistencia de referencia y trace en pos.payment
• Manejo de 17 códigos de error oficiales en español
• Cálculo automático del vuelto al recibir más del cobrado
• Envío vía Pago Móvil al teléfono del cliente
• Receptor pre-cargado con datos del paso 1
• Editable si el receptor es distinto al pagador
• Referencia separada del cobro para conciliación
• Lista oficial completa del sistema Pago Móvil
• BDV, Mercantil, Provincial, Banesco, BNC, Tesoro…
• Selector con código + nombre del banco
• Instrucciones OTP específicas por banco
• SMS / app del banco / Tpago según el emisor
• AES/ECB/PKCS5Padding con SHA-256 (16 bytes)
• Cifrado siempre en backend, nunca en JS
• Secret Key restringido a base.group_system
• Logs sin datos sensibles (cédula, OTP, teléfono)
• TLS estricto (verify=True) hacia el banco
• Endpoint de certificación configurable por método
• Endpoint de producción precargado
• Botón Probar Conexión con verificación SSL
• Cambio modo sin reinicio del servidor
• Timeout configurable (default 30 s)
• Indicador visual de avance del flujo
• Validación de teléfono (11 dígitos, formato 04XX)
• Validación de cédula/RIF (V/E/J + número)
• Pre-carga de datos del partner del ticket
• Reintentos guiados desde la pantalla de error
• Regístrese en apiportal.mercantilbanco.com y suscriba el plan "Botón de Pagos Móviles (C2P) y Vuelto".
• Al recibir el correo de Mercantil con X-IBM-Client-Id, Secret Key, MerchantId y endpoint de certificación, vaya a Punto de Venta Configuración Métodos de Pago.
• Edite el método "Pago Móvil C2P (Mercantil)" y cargue las credenciales en la pestaña Mercantil C2P.
• Seleccione el modo Certificación para pruebas y verifique conectividad con el botón Probar Conexión.
• Asocie el método de pago al POS desde la configuración de la tienda.
• El cajero arma el ticket y selecciona "Pago Móvil C2P (Mercantil)" en la pantalla de pago.
• El popup captura teléfono, banco emisor y cédula/RIF del cliente (paso 1).
• El cliente entrega el OTP al cajero, quien lo introduce y confirma el cobro (paso 2).
• El backend cifra los datos sensibles, llama al API Mercantil y muestra la respuesta (paso 3).
• Si el cliente pagó más del monto cobrado, el popup calcula el vuelto y ofrece enviarlo vía Pago Móvil.
• El receptor se pre-carga con los datos del cliente; el cajero puede cambiarlos si el destino es diferente.
• Al confirmar, el banco genera la transacción P2P y devuelve la referencia del vuelto.
• La pantalla final muestra ambas referencias (cobro + vuelto) para imprimir o entregar al cliente.
• Hereda pos.payment.method, pos.payment y pos.order.
• Implementa una PaymentInterface personalizada (PaymentMercantilC2P) en el POS, con popup OWL2 nativo de 5 pasos.
• Endpoint oficial: POST https://apimbu.mercantilbanco.com/mercantil-banco/prod/v1/payment/c2p.
• Header de autenticación X-IBM-Client-Id y JSON con merchant_identify, client_identify y transaction_c2p.
• Endpoints internos JSON-RPC: /web/pos/mercantil/c2p/{pay,vuelto,request_otp,banks,search}.
• Compatible con Odoo Enterprise y Community Edition.
• Depende de: point_of_sale, base_setup y el paquete Python pycryptodome.
• Punto de Venta (point_of_sale)
• Configuración Inicial (base_setup)
• pycryptodome (cifrado AES)
• Cuenta jurídica en Banco Mercantil
• Afiliación al servicio C2P (genera el merchantId)
• Registro como desarrollador en el portal API Mercantil
• Plan "Botón de Pagos Móviles (C2P) y Vuelto" activado
• Certificado SSL válido en el servidor Odoo

En pantalla

Especificaciones

Qué incluye con Mi-ERP