Inicio

Guías

Referencia

Plugins

OpenCart

¿Qué es OpenCart?

OpenCart es una solución gratuita basada en Web diseñada para poner en marcha un comercio electrónico con el mínimo de configuraciones y ajustes requeridos.

Ponemos a su disposición nuestro plugin para OpenCart, el cual le permitirá configurar y añadir los métodos de pago soportados en Openpay (tarjeta de crédito/débito, tiendas de conveniencia y SPEI) dentro del flujo compra de su tienda basada en esta plataforma.

Versiones soportadas

OpenCart 2.0.1.1 en adelante

Requerimientos

Es necesario que el servidor donde se encuentre alojado su comercio de OpenCart cuente con las siguientes configuraciones:

Servidor web Apache
Versión instalada de PHP 5.2 o mayor.
Versión instalada de MySQL 5.0 o mayor.
Contar con un certificado SSL para su comercio electrónico.

Adicionalmente para la versión de PHP es necesario que cuente con ciertas características:

Configuración Register Globals deshabilitada.
Configuración Magic Quotes GPC deshabilitada.
Configuración para subida de archivos habilitada.
Configuración Session Auto Start deshabilitada.
Extensión GD (con procesamiento de imágenes PNG) habilitada.
Extensión cURL habilitada.
Extensión ZIP habilitada.

Instalación

Para instalar los plugins de Openpay en su comercio de OpenCart tiene que seguir los siguientes pasos:

Nota: La siguiente secuencia debe realizarse por cada plugin que se desee instalar.

1. Descargar el archivo ZIP que contiene todos los plugins. Puede descargar los plugins a través de este enlace.
2. Descomprimir el archivo descargado, dentro encontrará los tres módulos de Openpay.

3. En su panel de administración de OpenCart, dirigirse a la sección Extensions -> Installer. Dar clic en la opción Upload y seleccionar el archivo ZIP del plugin del método de pago que desee instalar.

Si al instalar el plugin aparece el error FTP needs to be enabled in the settings, es necesario aplicar un fix que puede ser descargado a través de este enlace. Seguir las instrucciones proporcionadas en ese mismo sitio para aplicar exitosamente el ajuste.

4. Una vez se haya instalado el plugin aparecera el siguiente mensaje.

5. Ir a la sección Extensions -> Extensions, ubicar en el listado de busqueda el filtro payments.

6. Dar click en install para que el plugin quede instalado correctamente

Configuración

1. Dentro de su dashboard ya sea Sandbox ó Producción, en la barra superior hacer click en el icono de engrane y seleccionar “Credenciales de API”.

2.- Aparecerá una pantalla como la que se muestra a continuación.

3. En su panel de administración de OpenCart, dirigirse a la sección Extensions -> Payments. Ubicar el plugin instalado recientemente y dar clic en la opción Edit.

4. Completar el formulario de configuración contemplando los siguientes puntos:

Configuración general

Test mode: Define si el plugin estará trabajando en entorno de pruebas o producción.
Test Merchant ID, Secret Key, Public Key: Credenciales de API (ver paso 1) de la cuenta de Openpay del comercio, en entorno de pruebas.
Live Merchant ID, Secret Key, Public Key: Credenciales de API (ver paso 1) de la cuenta de Openpay del comercio, en entorno de producción.

Configuraciones comunes de los módulos

Status: Determina si el método de pago estará disponible dentro del flujo de compra de tus cliente.
Título: Nombre del método de pago a mostrar a los usuarios al momento de realizar una compra.
Total: Monto mínimo de la compra para que el método de pago pueda ser utilizado.
Ordenamiento: Orden en que se mostrará este método de pago.

Configuración pago con tarjeta

¿Cómo procesar el cargo? Define el tipo de cargo que se realizará:
1. Directo: Se realizará una evaluación del cargo y se rechazará si el sistema antifraude detectó alguna anomalía.
2. 3D Secure: Se realizará un redireccionamiento al banco para que el cliente sea autenticado en su banco.
3. Autenticación selectiva: Se realizará una evaluación del cargo y si el sistema antifraude detecta alguna anomalía, se ejecutará un cargo 3D secure.
Configuración del cargo.- Indica si el cargo se hace o no inmediatamente.
Pago con puntos.- Recibe pagos con puntos con BBVA, Santander y citibanamex.
Guardar tarjetas.- Permite a los usuarios registrados guardar sus tarjetas crédito/débito para agilizar sus futuras compras.
Meses sin intereses.- Puede hablitar o deshabilitar pagos con tarjeta con meses sin intereses seleccionando 3,6,9,12 y/o 18 meses sin intereses.

Configuración pagos en tiendas y pagos con SPEI

Límite de horas para pago: Cantidad de horas que tiene el cliente para realizar el pago, una vez generado el pedido.
Mostrar mapa: Al seleccionar esta opción, un mapa se desplegará mostrando las tiendas más cercanas al momento mostrar el recibo de pago.

Pagos en Tiendas

Pagos con SPEI

5. Guardar los cambios usando el botón ubicado en la esquina superior derecha de la pantalla.

6. Confirmar que la configuración del plugin haya sido guardada exitosamente.

Notificaciones de pagos en tiendas y SPEI

Los plugins Openpay están preparados para recibir las notificaciones de pago de forma automática, es decir, sin la necesidad de configurar su cuenta de Openpay o el plugin. Las notificaciones se envían al comercio cuando los pagos han sido realizados o cuando una referencia ha vencido.

Importante: Los plugins asumen que la tienda se encuentra en la raíz del dominio, por lo que se crea el webhook tomando como base está url.

# Pago en tiendas
https://[eCommerce domain]/index.php?route=extension/payment/openpay_stores/webhook

# SPEI (wire transfer)
https://[eCommerce domain]/index.php?route=extension/payment/openpay_banks/webhoo

Verificación de Webhook

Es importante verificar que el Webhook haya sido creado de forma correcta en Openpay.

1. En su panel de configuración de Openpay ir a Ajustes (ícono de engrane) -> Configuraciones.

2. Ubicar el apartado de Webhooks. Si el webhook fue configurado correctamente habrá un registro en estado Verificado.