Plugin de Magento

Instalación

  1. Limpia el caché de Magento
    1. Abre *System > Cache Management.
    2. Haz click en el botón Flush Magento Cache.
  2. Reindexación
    1. Abrir System > Index Management.
    2. Selecciona all the Indexer
    3. Selecciona Update by Schedule y da click en Submit
  3. Descomprime el archivo holacash.zip (Te lo proporciona el Vendedor asignado a tu cuenta)
  4. Conéctate al servidor donde esta hospedada tu tienda de Magento por medio de un cliente FTP/SFTP y ubicate en el directorio donde esta el Sourcode.
  5. Sube el módulo Hola Cash al directorio app/code/
  6. Ve al directorio raíz de Magento 2.
  7. Ejecuta los siguientes comandos:
    1. php bin/magento setup:upgrade
    2. php bin/magento setup:static-content:deploy -f
    3. php bin/magento cache:clean
  8. ¡Listo! El plugin se ha instalado correctamente.

Configuración en Hola Cash

  1. Inicia sesión en el portal Hola Cash con tus credenciales.
  2. Magento # 1
  3. Tus llaves del API Públicas y Privadas se encuentran en el menú de Desarrollador. Tenlas cerca ya que las necesitarás más tarde.
  4. Magento # 2
  5. WarningCrea un nuevo Webhook que apunte al URL del webhook de tu tienda Magento.
  6. Magento # 3
  7. Ve hacia la opción de "Configuración" dentro del menú del portal. Dentro de "Métodos de pago" selecciona los métodos que quieres utilizar en tu tienda Magento.
  8. Magento # 4
  9. Selecciona el menú de personalización para las siguientes opciones:
    1. WarningAgrega el URL de tu tienda Magento. Este es un paso muy importante ya que el plugin se asociará a ese URL. No va a ser posible invocarlo desde algún otro.
    2. Magento # 5
    3. En la visualización del Checkout Widget, selecciona la vista In-line. Esta es la única visualización para tiendas Magento que no presenta problemas de visualización en la carga del Checkout Widget en tu tienda.
    4. Magento # 5
    5. Habilita o deshabilita la autocaptura de la transacción. Si necesitas revisar manualmente todos los pagos en tu tienda, te recomendamos deshabilitar esta opción. Eso sí, necesitarás capturar el cargo para cada transacción. Si tu tienda cuenta con un alto volumen de transacciones, te recomendamos habilitar la autocaptura de las transacciones.
    6. Magento # 5

Configuración en Magento

  1. Inicia sesión en tu tienda Magento.
  2. Del menú, selecciona Stores y después Configuration.
  3. Magento # 2
  4. Selecciona Sales y después el submenú de Payment Methods
  5. Magento # 3
  6. Navega hacia la sección de pagos con Hola Cash
  7. Magento # 4
  8. En la sección de Hola Cash Payment verás varias opciones de configuración que te describimos a continuación:
    1. Enabled: Si se habilita, el plugin de Hola Cash aparecerá como uno de los métodos de pago en tu tienda.
    2. Mode: Selecciona entre Producción o Sandbox. En el modo de Sandbox las transacciones son procesadas en el ambiente de pruebas de Hola Cash. Estas son transacciones ficticias y no hay dinero real en movimiento. Usa el modo Sandbox para probar tu integración y cambia a modo de Producción para aceptar pagos reales de tus clientes.
    3. Title: Aquí puedes configurar cómo aparecerá el título de Hola Cash en los métodos de pago en el checkout de tu tienda.
    4. Production/Sandbox API Key: Agrega tu API Key Público
    5. Production/Sandbox Secret Key: Agrega tu llave secreta de API, recuerda nunca compartir esta llave.
    6. Production/Sandbox Webhook Key: Agrega tu llave asociada al webhook, para más información revisa nuestro tutorial de webhooks.
    7. Sort Order: Este es el lugar dónde el plugin será cargado si se tiene más de un método de pago.
  9. Enviando parámetros extra:
  10. Puedes agregar parámetros personalizados adicionales al pedido, esto puede ser útil para pasar información relacionada con el pedido a Hola Cash. El envío de estos parámetros es opcional.

    Agrega un campo oculto adicional al formulario de pago:

    <input type="hidden" name="charge_additional_details" value='[{"name": "test_int","data": "1"},{"name": "test_float","data": 3.45},{ "name": "test_boolean","data": false},{"name": "test_string","data": "string"}]' />

Actualiza el plugin de Magento a través de tu consola:

  1. Ingresa a tu servidor por la línea de comando
  2. Localiza la carpeta de Magento.
  3. Ejecuta el siguiente comando:
  4. composer update hola_cash/holacash-magento2;

    En el caso que quieras regresar a una versión específica como, por ejemplo, la 10.7, ejecuta el comando:

    composer update hola_cash/holacash-magento2:1.0.7
    Magento update #1
  5. Una vez se haya instalado la extensión, ejecuta:
  6. bin/magento setup:upgrade
    Magento update #2
    bin/magento setup:di:compile
    Magento update #3
    bin/magento setup:static-content:deploy
    Magento update #4
    bin/magento cache:clear; bin/magento cache:flush;

    O usa el siguiente atajo:

    bin/magento c:c; bin/magento c:f;
    Magento update #5