Banco Mercantil para PrestaShop

Descripción

Integra la pasarela de pago del Banco Mercantil en PrestaShop para aceptar tarjetas Visa, Mastercard, C2P y Pago Móvil. Este módulo 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 PrestaShop

Métodos de Pago

El módulo 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 módulo, sigue las instrucciones generales de instalación de módulos de PrestaShop que puedes encontrar en nuestra guía de instalación de PrestaShop.

Cómo Configurar

Configuración General

Activa el módulo en PrestaShop y luego ve a Módulos -> Módulos instalados -> Banco Mercantil
Ingresa tu licencia de Cujiware (ver guía de licencias)
Configura las opciones generales:
- Endpoint: Selecciona entre Sandbox o Producción
- Credenciales:
  - 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
- Conversión de Tasas:
  - Manejada por PrestaShop
  - Usar la tasa de conversión oficial (Solo aplica a USD/EUR a Bolivares)
- Aplicar tasa a PrestaShop: Activa/Desactiva la aplicación automática de tasas
- 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 PrestaShop
- Bloquear al cliente por muchos intentos fallidos: Activa/Desactiva el bloqueo por intentos fallidos
- Número de reintentos: Establece el número máximo de intentos antes de bloquear
- Mensaje de bloqueo: Personaliza el mensaje mostrado al usuario bloqueado
- Estado de pago aceptado: Selecciona el estado de la orden cuando el pago es aceptado
- Debug: Activa/Desactiva el registro de logs

Configuración de Tarjetas de Crédito

Activar Tarjetas de Crédito: Activa/Desactiva el método de pago
Opciones de Validación:
- Solicitar nombre del titular
- Solicitar DNI/Cédula/Pasaporte para tarjetas internacionales
- Solicitar adjuntar foto del documento para tarjetas internacionales
Credenciales:
- Client ID
- Clave de Cifrado
- Código de Afiliación
Personalización:
- Nombre visible del método de pago
- Porcentaje de comisión extra

Configuración de Tarjetas de Débito

Activar Tarjetas de Débito: Activa/Desactiva el método de pago
Credenciales:
- Client ID
- Clave de Cifrado
- Código de Afiliación
Personalización:
- Nombre visible del método de pago
- Porcentaje de comisión extra

Configuración de Pagos C2P

Para más información sobre el sistema C2P, consulta nuestra documentación detallada.

Activar Pagos C2P: Activa/Desactiva el método de pago
Datos del Receptor:
- Número de Celular
Credenciales:
- Client ID
- Clave de Cifrado
- Código de Afiliación
Personalización:
- Nombre visible del método de pago

Configuración de Pagos P2C

Activar Pagos P2C: Activa/Desactiva el método de pago
Datos del Receptor:
- Número de Celular
- R.I.F.
Credenciales:
- Client ID
- Clave de Cifrado
- Código de Afiliación
Personalización:
- Nombre visible del método de pago
- Porcentaje de comisión extra

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

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

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

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

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

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​

Configuración de Tarjetas de Crédito​

Configuración de Tarjetas de Débito​

Configuración de Pagos C2P​

Configuración de Pagos P2C​

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)​