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:
1. Cliente ingresa teléfono, cédula y banco
2. Recibe token OTP por SMS/APP/Portal Web
3. Ingresa token para autorizar el pago
4. 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
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
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
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
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

Descripción​

Registro en Portal API Mercantil​

Índice​

Métodos de Pago​

1. Pago Móvil (P2C)​

2. Tarjeta de Débito (TDD)​

3. Pago Móvil C2P (Comercio a Persona)​

4. Tarjeta de Crédito (TDC)​

Cómo Instalar​

Cómo Configurar​

Configuración General​

Opciones de Configuración​

Cómo Utilizar​

Proceso de Pago Móvil (P2C)​

Proceso de Pago con Tarjeta de Crédito (TDC)​

Proceso de Pago con Tarjeta de Débito (TDD)​

Proceso de Pago Móvil C2P (Comercio a Persona)​