Banco Mercantil para WooCommerce
Descripción
Integra la pasarela de pago del Banco Mercantil en WooCommerce para aceptar tarjetas Visa, Mastercard, C2P y Pago Móvil. Este plugin te permite procesar pagos de forma segura y confiable a través del Banco Mercantil.
Registro en Portal API Mercantil
Antes de comenzar es requerido haber completado todos los pasos dados en el registro del Portal API Mercantil:
- Ingresa a https://apiportal.mercantilbanco.com/mercantil-banco/produccion/user/register si no estas registrado y completa el formulario (Los datos deben ser exactamente igual a la cuenta jurídica que ya tienes con el banco)
- Inicia sesión con tu cuenta del banco
- Ingresa a tu Cuenta de usuario
- Crea una aplicación si aun no la tienes: https://apiportal.mercantilbanco.com/mercantil-banco/produccion/application
- Ingresar a la lista de productos disponibles: https://apiportal.mercantilbanco.com/mercantil-banco/produccion/product
- Ingresa a "Botón de Pagos Móviles C2P"
- Ubica el dialogo para suscribirse en la parte media de la pagina que abriste
- Selecciona la aplicación creada y luego click en el botón Suscribirse
- Repite los dos pasos anteriores con la opción de "Botón de Pagos con Tarjetas" y "Búsquedas de Pagos Móviles"
Una vez terminado estos pasos el banco validará en un par de días tus datos Jurídicos y te enviará por correo electrónico los datos de acceso al API en ambientes de Prueba (Sandbox).
Los datos de acceso a Producción te los proveerá el banco luego de entregar los siguientes recaudos en el banco físicamente: https://www.mercantilbanco.com/mercprod/apiportal/epagos/license/index.html
Índice
- Banco Mercantil para WooCommerce
Métodos de Pago
El plugin ofrece 4 métodos de pago diferentes:
1. Pago Móvil (P2C)
- Permite recibir pagos directamente desde la cuenta del cliente
- Requiere número de teléfono y Cédula afiliados al pago móvil
- Proceso simple y rápido para el cliente final
2. Tarjeta de Débito (TDD)
- Acepta tarjetas de débito del Banco Mercantil
- Procesamiento instantáneo de pagos
- Ideal para clientes con cuenta en el banco
3. Pago Móvil C2P (Comercio a Persona)
Para más información sobre el sistema C2P, consulta nuestra documentación detallada.
- Sistema especializado para transacciones comerciales
- Mayor seguridad y trazabilidad
- Requiere validación mediante token OTP
- Proceso:
- Cliente ingresa teléfono, cédula y banco
- Recibe token OTP por SMS/APP/Portal Web
- Ingresa token para autorizar el pago
- Confirmación inmediata para el comercio
4. Tarjeta de Crédito (TDC)
- Acepta tarjetas Visa, Mastercard y Dinners Club
- Soporta tarjetas nacionales e internacionales
- Opción para solicitar foto de documento de identidad para clientes fuera de Venezuela
Cómo Instalar
Para instalar este plugin, sigue las instrucciones generales de instalación de plugins de WooCommerce que puedes encontrar en nuestra guía de instalación de WooCommerce.
Cómo Configurar
Configuración General
- Activa el plugin en Wordpress y luego ve a WooCommerce -> Ajuste -> Pagos y ubique uno de los 4 metodos de pago que va configurar.
- Ingresa tu licencia de Cujiware (ver guía de licencias)
- Ingresa las credenciales proporcionadas por el Banco Mercantil:
- Número de Comercio (Merchant ID): Ubicado como "Merchant ID" en el correo del banco
- Llave Pública: Valor ubicado luego de "X-Ibm-Client-Id:" en el correo del banco
- Llave Privada: Contenida en "Clave de Cifrado" en el correo del banco
Opciones de Configuración
- Modo Sandbox: Activar esta opción si los datos de acceso son de pruebas y no es el entorno real
- Estado de Pago: Activar esta opción si deseas que los pagos aprobados queden de una vez en "Completado" y no en "Procesando" como lo deja normalmente WooCommerce
- Conversión de Moneda: Si tu tienda está en otra moneda que no sea Bolívares (VES), verás estas opciones:
- Desactivar Plugin: Si no deseas activar el plugin cuando la tienda está en otra moneda
- Tipo de Tasa: Seleccionar el tipo de tasa a usar (solo aplica si tu moneda base es Dólares Americanos)
- Tasa Manual: Ingresar una tasa manual personalizada
- Debug: Activa el registro de logs para depuración
Cómo Utilizar
Proceso de Pago Móvil (P2C)
-
Selección del Método de Pago
- El cliente selecciona "Pago Móvil" como método de pago durante el checkout
- Se muestra el formulario de pago móvil con los campos requeridos
-
Datos Requeridos
- Tipo de Documento: Seleccionar entre:
- V: Venezolano
- E: Extranjero
- Número de Cédula:
- Debe contener entre 6 y 9 dígitos
- Solo se permiten números
- Número de Teléfono:
- Debe contener 11 dígitos
- Solo se permiten números
- Incluir código de área
- Banco: Seleccionar el banco desde donde se realizará el pago
- Referencia del pago: Número de comprobante o referencia del pago móvil que se genera al realizar la transferencia
- Tipo de Documento: Seleccionar entre:
-
Proceso de Pago
- El sistema valida los datos ingresados
- Se procesa la transacción a través del Banco Mercantil
- El cliente recibe confirmación del pago
- La orden se marca como completada automáticamente
-
Consideraciones
- Se genera un comprobante con los detalles de la transacción
-
Confirmación
- El cliente recibe confirmación del pago exitoso
- Se redirige a la página de "Gracias por tu compra"
- Se envía el correo electrónico de confirmación de la orden
Proceso de Pago con Tarjeta de Crédito (TDC)
-
Selección del Método de Pago
- El cliente selecciona "Pagar con Tarjeta" como método de pago durante el checkout
- Se muestra el formulario de pago con tarjeta con los campos requeridos
-
Datos Requeridos
- Tipo de Documento: Seleccionar entre:
- V: Venezolano
- E: Extranjero
- Número de Cédula:
- Debe contener entre 6 y 8 dígitos
- Solo se permiten números
- Nombre del Titular:
- Debe coincidir con el nombre en la tarjeta
- Solo caracteres alfabéticos y espacios
- Número de Tarjeta:
- Visa/Mastercard: 16 dígitos
- Dinners Club: 14 dígitos
- Solo se permiten números
- Fecha de Vencimiento:
- Mes y año de vencimiento
- No debe estar vencida
- Código CVC:
- 3 dígitos
- Solo se permiten números
- Tipo de Documento: Seleccionar entre:
-
Proceso de Pago
- El sistema valida los datos ingresados
- Se procesa la transacción a través del Banco Mercantil
- Se verifica el estado de la transacción
- El cliente recibe confirmación del pago
- La orden se marca como completada automáticamente
-
Consideraciones
- Se genera un comprobante con los detalles de la transacción
- Si lo activas en la configuración, para tarjetas internacionales:
- Se requiere documento de identidad (DNI, Pasaporte o Tax ID)
- Se debe adjuntar una imagen del documento (PNG/JPG/PDF)
-
Confirmación
- El cliente recibe confirmación del pago exitoso
- Se redirige a la página de "Gracias por tu compra"
- Se envía el correo electrónico de confirmación de la orden
- Se genera un comprobante con en la Orden con:
- Número de referencia
- Estado de la transacción
- Fecha y hora
- Últimos 4 dígitos de la tarjeta
- Monto de la transacción
Proceso de Pago con Tarjeta de Débito (TDD)
-
Selección del Método de Pago
- El cliente selecciona "Débito Banco Mercantil" como método de pago durante el checkout
- Se muestra el formulario de pago con tarjeta de débito con los campos requeridos
-
Datos Requeridos
- Tipo de Documento: Seleccionar entre:
- V: Venezolano
- E: Extranjero
- Número de Cédula:
- Debe contener entre 6 y 8 dígitos
- Solo se permiten números
- Número de Cuenta:
- Debe contener exactamente 20 dígitos
- Solo se permiten números
- Debe ser una cuenta del Banco Mercantil
- Tipo de Documento: Seleccionar entre:
-
Proceso de Pago
- El sistema valida los datos ingresados
- Se procesa la transacción a través del Banco Mercantil
- Se solicita la clave de seguridad OTP del banco que le llega por SMS
- Se verifica el estado de la transacción
- El cliente recibe confirmación del pago
- La orden se marca como completada automáticamente
-
Consideraciones
- Se genera un comprobante con los detalles de la transacción
- Se requiere tener una cuenta activa en el Banco Mercantil
-
Confirmación
- El cliente recibe confirmación del pago exitoso
- Se redirige a la página de "Gracias por tu compra"
- Se envía el correo electrónico de confirmación de la orden
- Se genera un comprobante en la Orden con:
- Número de referencia
- Estado de la transacción
- Estado interno de la transacción
- Fecha y hora
- Últimos 6 dígitos de la cuenta
- Monto de la transacción
Proceso de Pago Móvil C2P (Comercio a Persona)
Para más información sobre el sistema C2P, consulta nuestra documentación detallada.
-
Selección del Método de Pago
- El cliente selecciona "Pago Móvil C2P" como método de pago durante el checkout
- Se muestra el formulario de pago C2P con los campos requeridos
-
Datos Requeridos
- Tipo de Documento: Seleccionar entre:
- V: Venezolano
- E: Extranjero
- Número de Cédula:
- Debe contener entre 6 y 8 dígitos
- Solo se permiten números
- Número de Teléfono:
- Debe contener entre 10 y 11 dígitos
- Solo se permiten números
- Incluir código de área
- Banco: Seleccionar el banco desde donde se realizará el pago
- Token OTP: Clave de seguridad que se recibe por:
- SMS
- Aplicación móvil del banco
- Portal web del banco
- Tipo de Documento: Seleccionar entre:
-
Proceso de Pago
- El sistema valida los datos ingresados
- Se procesa la transacción a través del Banco Mercantil
- Se verifica el estado de la transacción
- El cliente recibe confirmación del pago
- La orden se marca como completada automáticamente
-
Consideraciones
- Se genera un comprobante con los detalles de la transacción
- Ofrece mayor seguridad y trazabilidad que el Pago Móvil tradicional
- Requiere validación mediante token OTP para cada transacción
-
Confirmación
- El cliente recibe confirmación del pago exitoso
- Se redirige a la página de "Gracias por tu compra"
- Se envía el correo electrónico de confirmación de la orden
- Se genera un comprobante en la Orden con:
- Número de referencia
- Estado de la transacción
- Estado interno de la transacción
- Fecha y hora
- Datos del pagador (cédula, teléfono y banco)
- Monto de la transacción