Pasarela de pago 4B para osCommerce / ZenCart

Módulo de pago con Pasat 4b para OsCommerce y ZenCart

Las mejoras que ofrece este módulo sobre el que teníamos publicado en http://zhenit.com y el resto que están disponibles de forma gratuita son importantes:

1. El pedido se registrará siempre en la administración, aunque el cliente no pulse en volver a la tienda
2. El módulo de pago puede funcionar en modo multimoneda, bien aplicando el tipo de cambio que tengamos configurado en la tienda o si tenemos el modo divisa contratado en 4B cobrando directamente en la moneda que use el cliente.
3. Es multitienda, con sólo tener contratado un tpv en 4b, podremos instalar el módulo en diferentes tiendas/dominio. La url que configuremos en la administración de 4b , pertenecerán a la tienda principal y en el resto de tiendas, sólo tendrémos que indicar en la configuración de osCommerce/Zencart del módulo el dominio de la tienda principal. 

AVISO: Estamos viendo que los tpv virtuales contratados a paritr del 1 de mayo en bancos que usaban 4B, ahora son de tipo Servired / Redsys. Si su código de comercio no empieza por "PI" necesitará el módulo de Redsýs

1. INSTALACIÓN

Lo primero que hay que hacer es subir los ficheros de la carpeta catalog a nuestro servidor, donde tenemos la tienda, esta es la lista de los archivos que se incluyen en el paquete:

1. catalog/includes/languages/espanol/modules/payment/Qb_ZhenIT.php
2. catalog/includes/languages/english/modules/payment/Qb_ZhenIT.php
3. catalog/includes/languages/german/modules/payment/Qb_ZhenIT.php
4. catalog/includes/modules/payment/Qb_ZhenIT.php
5. catalog/includes/compat_ZhenIT/*
6. catalog/4b_ZhenIT_return.php
7. catalog/4b_ZhenIT_process.php
8. catalog/4b_ZhenIT_order.php
9. leame.html

Los 3 primeros tienen los textos que se le mostrará al cliente. Cambie el correspondiente a "MODULE_PAYMENT_4B_TEXT_TITLE" y "MODULE_PAYMENT_4B_DESCRIPCION_PUBLICA" a su gusto.

Tendremos que modificar el fichero checkout_confirmation.php de nuestra tienda de la siguiente manera:
Buscamos las líneas:

  if (is_array($payment_modules->modules)) {
    echo $payment_modules->process_button();
  }

Las cortamos y las pegaremos unas líneas más arriba, justo antes de la línea:

  if (tep_not_null($order->info['comments'])) {

2. CONFIGURACIÓN

Para la instalación de este módulo tendremos que configurar por una parte la pasarela Pasat de 4B y por otra el módulo propiamente dicho en nuesra tienda

Configuración de Pasat 4b:
Accedemos al panel de configuración y configuramos las siguientes urls en los campos correspondientes, sutituyendo antes "http://tutienda.com/catalog" por lo que corresponda.

IMPORTANTE

1. Para que el pedido se registre siempre que activemos las páginas personalizadas de recibo. Adicionalmente si se quiere, se pueden activar las páginas personalizadas de pago y subir los html correspondientes, pero no es necesario.
2. en "Modo ventana Autenticación" tendremos que indicar "incrustada".
3. La parte emborronada de las url tendría que ser el dominio de vuestra tienda

Configuración de la tienda:
Accedemos a la administración de la tienda -> módulos -> Pagos. Para configurar el módulo, hay que instalarlo en el panel de control, para ello, seleccionamos el módulo en la lista y luego pulsamos el botón Instalar, situado en la derecha. Posteriormente, hay que pulsar editar, y podremos editar todos los parámetros que configuran el módulo de pago, que se explican a continuación:

Activar módulo

Si se quiere habilitar el módulo o no

Preferencia ordinal al mostrar

La posición en la que se le mostrará esta opción de pago al cliente.

Clave de Comercio 4B

Es el código de comercio que le haya asignado 4b, este dato se lo proporcionan al formalizar el contrato

Estado de los pedidos

Estado que desea asignar a los pedidos al ser pagados mediante este método.

Entorno Pasat 4b

Si acaba de contratar la pasarela de pago tendrá el entorno de pruebas, cuando consiga que todo funcione bien en este entorno deberá solicitar en la configuración de pasat 4b el paso a producción. En ese instante deberá, tmabién, cambiar el entorno en esta opción del módulo de pago.

Zonas de pagos

Zona para las que desea habilitar el método.

Comercio principal

Una de las novedades de esta versión es la posibilidad de usar el mismo TPV de passat 4b para varios comercios osCommerce, uno de ellos será el principal, cuyas URLs hayamos configurado en https://tpv.4b.es/config y el resto, serían comercios secundarios. en el principal dejaremos este campo vacio y en el resto indicaremos aquí el dominio (sin http) del comercio principal

Moneda contratada

La moneda en la que se haya contratado el TPV normalmente EUR

Modo dvisa

Si se tiene activado el modo divisa o no, esto es si hemos contratado el TPV con la posibilidad de cobrar en otra monedas además de la que hayamos contratado.

3. Notas

• Contratando la instalación completa, podemos hacer funcionar este módulo también en  XT:Commerce
• Entidades que usan este sistema: Banco Santander, Santander Consumer Finance, Open Bank, Banif, Banco Popular,Banco Español de Crédito,Banca March,Banco de Valencia,Banco Pastor,Banco Guipuzcoano,Banco Gallego

ATENCIÓN:

Este módulo crea una tabla cuando se instala y la borra cuando se desinstala, por lo que los números de pedido de 4B se empiezan a generar de 0 otra vez.
Esto podría causar duplicación de número de pedido de 4B si se vuelve a instalar al de poco tiempo. Instale esta contribución bajo su responsabilidad.

Entidades que usan Pasat 4B

Banca March,Banco Gallego,Banco Pastor,Banco Popular,Banco Santander,Banco de Valencia,Banif,Open Bank,Santander Consumer Finance...