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 nuestros plugins para Opencart, los cuales le permitirán configurar y añadir los métodos de pago soportados en Openpay (tarjeta de crédito/débito, tiendas y pagos vía PSE) dentro del flujo de compra de su tienda basada en está plataforma.   

Requerimientos

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

  • OpenCart 2.0.1.1 en adelante
  • 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 (Revisar la configuración de su archivo .ini y la descarga de la extensión cacert)
  • Extensión ZIP habilitada.

Instalación

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

Para instalar los plugins de Openpay en su comercio de OpenCart tiene que seguir los siguientes pasos:
  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.
    Instalación de plugin PrestaShop paso 2
  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.
    Instalación de plugin PrestaShop paso 3
    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. Ir a la sección Extensions -> Payments, ubicar en el listado el plugin recién subido y dar clic en la opción Install.
    Instalación de plugin PrestaShop paso 4
  5. Confirmar que el plugin se haya instalado exitosamente.
    Instalación de plugin PrestaShop paso 5

Configuración

  1. Identificar las credenciales de API asignadas a su comercio dentro del panel de administración de Openpay.
    Configuración de plugin Opencart paso 1
    Para ver las credenciales, dar clic en el engrane del menú superior derecho y luego seleccionar la opción Credenciales de API
  2. 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.
    Configuración de plugin Opencart paso 2
  3. 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.
    • País: Seleccionar el país donde se encuentra (Colombia, México).
    • Test Merchant ID, Secret Key, Publishable Key: Credenciales de API (ver paso 1) de la cuenta de Openpay del comercio, en entorno de pruebas.
    • Live Merchant ID, Secret Key, Publishable Key: Credenciales de API (ver paso 1) de la cuenta de Openpay del comercio, en entorno de producción.
    Configuración de plugin Opencart paso 3 Gral

    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.
    • IVA: Debe contener el valor de IVA, es campo solo informativo, no tiene ningún efecto sobre el campo amount.
     

    Configuraciones pago con tarjetas

    • Guardar tarjetas: Permite a los usuarios registrados guardar sus tarjetas crédito/débito para agilizar sus futuras compras.
    • Cuotas: Puede habilitar o deshabilitar pagos con cuotas seleccionando el número de cuotas disponibles.
    Configuración de plugin Opencart paso 3 Cards

    Configuraciones pago en tiendas

    • 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 recipo de pago
    Configuración de plugin Opencart paso 3 Stores

    Configuraciones pago vía PSE

    Configuración de plugin Opencart paso 3 PSE
  4. Guardar los cambios usando el botón ubicado en la esquina superior derecha de la pantalla.
    Configuración de plugin Opencart paso 4
  5. Confirmar que la configuración del plugin haya sido guardada exitosamente.
    Configuración de plugin Opencart paso 5

Notificación de pagos

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 (https://[eCommerce domain]/), 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
# PSE
https://[eCommerce domain]/index.php?route=extension/payment/openpay_pse/webhook

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.
    Webhook PrestaShop paso 1
  2. Ubicar el apartado de Webhooks. Si el webhook fue configurado correctamente habrá un registro en estado Verificado.
    Webhook PrestaShop paso 2
    Nota: https://[eCommerce domain]/ corresponde al dominio de su Comercio.