Pasarela de pago BBVA para OpenCart

AVISO IMPORTANTE: Debido a la actualización del protocolo de firma SHA-256, este módulo ha quedado obsoleto. Para seguir procesando pagos de forma segura, le recomendamos utilizar nuestro módulo actualizado de Redsýs.

Ofrezca a sus clientes la posibilidad de pagar con tarjeta de crédito a través de la pasarela de pago de BBVA.
Para utilizar este módulo, es imprescindible tener contratado el servicio de TPV virtual con BBVA, conocido comercialmente como TPV Virtual Millennium.

OPCIONES DE SOPORTE

• Soporte vía email o chat: Reciba asistencia técnica por correo electrónico o chat para resolver dudas sobre el funcionamiento, instalación o configuración del módulo. Este soporte está limitado a una hora de dedicación por parte de nuestro equipo.
• Instalación completa: Nuestro equipo se encargará de la instalación del módulo en su servidor, sin que tenga que preocuparse por nada. Nos pondremos en contacto con usted para solicitar acceso y realizaremos las modificaciones necesarias para asegurar el correcto funcionamiento del módulo. Esta opción es ideal para usuarios sin perfil técnico o para aquellos que requieran soporte para múltiples monedas e idiomas.

INSTALACIÓN

Suba el contenido de la carpeta "upload" a su instalación de OpenCart utilizando un cliente FTP.

Para continuar con la instalación, necesitará la firma o palabra secreta proporcionada por BBVA.

• Genere la firma en el panel de administración de su pasarela en https://tpvvirtual.bbva.es/ -> Integración -> "Descargar Palabra Secreta". Consulte la documentación proporcionada por BBVA para obtener más información.

CONFIGURACIÓN

• Acceda a la administración de su tienda: Módulos -> Pagos.
• Instale el módulo seleccionándolo en la lista y pulsando el botón "Instalar" en la parte derecha.
• Posteriormente, pulse "Editar" para configurar los parámetros del módulo de pago.

COMPATIBILIDAD

El producto incluye dos descargas: una para la versión del módulo compatible con tiendas OpenCart 1.4.X y otra para tiendas con OpenCart 1.5.X.

POSIBLES PROBLEMAS Y SOLUCIONES

Aparecen errores en pantalla del tipo "Notice:..."

Estos "Notices" no son errores, pero es importante evitar que se muestren en pantalla. Para ello, vaya a:

Configuración -> General -> Tienda -> Servidor.

Mostrar Errores: NO
Registrar errores: Sí

De esta forma, podrá consultar el registro de errores en el fichero correspondiente y evitar comprometer la seguridad al mostrarlos en pantalla.

No se registra el pedido:

La notificación de BBVA es un XML que se envía en el GET, lo que puede generar una petición de más de 512 bytes.

Algunos servicios de hosting compartido limitan el tamaño de los GET, lo que impide que los pedidos se registren después del pago.

SOLUCIÓN: La limitación del tamaño de los GET se configura en el php.ini con los parámetros "post_max_size" y/o "suhosin.get.max_value_length". Cambie el valor de estos parámetros para que tengan al menos 700 bytes. Modifique el .htaccess si PHP está configurado como módulo de Apache o cree un php.ini en la raíz de la tienda con los parámetros modificados.

Si no es posible realizar estos cambios, solicite la modificación al administrador de su hosting.

Error Producido: 004 - Operacion No Procesada (02020000042)

Si al intentar realizar el pago, ya sea en pruebas o en producción, aparece este mensaje, según la  documentación de BBVA el error es:

004 - 02020000042 significa: "Error en la Petición del Comercio: La firma de la operación no es válida"

Si la firma no se genera correctamente, puede que los datos del BBVA no se hayan copiado correctamente en la administración de OpenCart. Revise que no haya espacios en blanco delante ni detrás del ID de comercio, la clave de la firma, etc.

También tenga en cuenta que si descarga la firma más de una vez desde el back-office del BBVA, ésta será diferente cada vez, aunque use la misma clave. En la administración de OpenCart siempre deberá introducir la última firma descargada.

Otra razón por la cual la firma puede no generarse bien es por intentar realizar pagos inferiores a 1€ o superiores a 1000€.

LIMITACIONES

Este módulo está solo en español y, en principio, solo admite pagos en euros. Para tener el módulo multimoneda o multiidioma, deberá contratar el módulo con la opción de instalación completa.