Descripción

El módulo POS Mercantil C2P para Odoo 19 conecta el Punto de Venta directamente con el API Tpago C2P y Vuelto Digital del Banco Mercantil de Venezuela, permitiendo cobrar al cliente vía Pago Móvil interbancario y devolver el vuelto digital sin salir del POS.

El cajero captura los datos del cliente (cédula, banco, teléfono y OTP) en un popup OWL nativo de 5 pasos. Las llamadas al banco viajan a través de un controlador backend de Odoo que aplica el cifrado obligatorio AES/ECB/PKCS5Padding con clave derivada de SHA-256 sobre los campos sensibles (cédula, teléfonos, OTP) antes de enviarlos al endpoint apimbu.mercantilbanco.com.

Funcionalidades por bloque

Interfaz y experiencia de usuario

El cajero ve el método de pago "Pago Móvil C2P (Mercantil)" en la pantalla de pago del POS. Al seleccionarlo se abre un popup de 5 pasos guiados que precarga los datos del cliente cuando hay un partner asignado al ticket. Una vez confirmado el cobro, el indicador de procesamiento se mantiene hasta que el banco responde, y todas las referencias quedan asociadas al pago para conciliación posterior.

Configuración del método de pago

Flujo completo en el POS

Flujo de Trabajo

Configuración inicial

1. Regístrese en apiportal.mercantilbanco.com y suscriba el plan "Botón de Pagos Móviles (C2P) y Vuelto".
2. 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.
3. Edite el método "Pago Móvil C2P (Mercantil)" y cargue las credenciales en la pestaña Mercantil C2P.
4. Seleccione el modo Certificación para pruebas y verifique conectividad con el botón 🔌 Probar Conexión.
5. Asocie el método de pago al POS desde la configuración de la tienda.

Cobro C2P en el POS

1. El cajero arma el ticket y selecciona "Pago Móvil C2P (Mercantil)" en la pantalla de pago.
2. El popup captura teléfono, banco emisor y cédula/RIF del cliente (paso 1).
3. Al solicitar el OTP, el sistema decide si lo envía vía Tpago (clientes Mercantil) o muestra instrucciones específicas (otros bancos).
4. El cliente entrega el OTP al cajero, quien lo introduce y confirma el cobro (paso 2).
5. El backend cifra los datos sensibles, llama al API Mercantil y muestra la respuesta (paso 3).

Entrega de vuelto digital

1. Si el cliente pagó más del monto cobrado, el popup calcula el vuelto y ofrece enviarlo vía Pago Móvil.
2. El receptor se pre-carga con los datos del cliente; el cajero puede cambiarlos si el destino es diferente.
3. Al confirmar, el banco genera la transacción P2P y devuelve la referencia del vuelto.
4. La pantalla final muestra ambas referencias (cobro + vuelto) para imprimir o entregar al cliente.

Detalles Técnicos

• 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.
• Cifrado obligatorio AES/ECB/PKCS5Padding con clave derivada de SHA-256 (primeros 16 bytes) sobre los campos sensibles, codificación Base64/UTF-8.
• 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.

Bancos venezolanos soportados

El módulo soporta los 29 bancos venezolanos afiliados al sistema Pago Móvil interbancario: Banco de Venezuela (BDV), Venezolano de Crédito (BVC), Banco Mercantil, Banco Provincial (BBVA), Bancaribe, Banco Exterior, BOD, Banco Caroní, Banesco, Sofitasa, Banco Plaza, Bancorp, BFC Banco Fondo Común, 100% Banco, DelSur, Banco del Tesoro, BAV, Bancrecer, Mi Banco, Activo, Bancamiga, BANID, Banplus, Bicentenario, Nuevo Mundo, Banatlantico, BNC e INSOFIN.

Requisitos

Nuestros Servicios

Customización Integración Instalación

Creación y Actualización Migración Soporte

Contáctanos

Obtendrás asistencia gratuita durante 60 días por cualquier error o problema.

Para consultas o soporte: [email protected]