Plugin de WooCommerce
Instalación
- Ve a tu panel de administración de Wordpress. Si tu no sabes acceder a este, por favor contacta primero a tu administrador o busca en las opciones de tu hosting de Wordpress.
- Desde el menú, selecciona Plugins y después da click en Add new.
- Busca Hola Cash en la lista de plugins. Puedes usar la caja de búsqueda.
- Da click en Instalar ahora. Y espera unos minutos...
- ¡Listo! La instalación del plugin está completa.
Configuración en Hola Cash
- Inicia sesión en el portal Hola Cash con tus credenciales.
- Tus llaves del API, Públicas y Privadas, se encuentran en el menú de Desarrollador, las necesitarás más tarde.
Crea un nuevo Webhook, va a apuntar al URL del webhook de tu tienda WooComerce- Del menú selecciona configuración, en Métodos de pago selecciona los métodos que quieres utilizar en tu tienda WooComerce.
- Selecciona el menú de personalización para las siguientes opciones:
- Agrega el URL de tu tienda WooComerce, este es un paso muy importante, el plugin se asociará a ese URL y no va a ser posible invocarlo desde algún otro.
- En visualización del Widget, selecciona Inline, esta es la única visualización para tiendas WooComerce, si seleccionas otro modo, puede ser que tengas problemas de visualización mientras se carga el Widget en tu tienda.
- Habilita o deshabilita la autocaptura de la transacción, por ejemplo, si necesitas revisar manualmente todos los pagos en tu tienda, entonces deshabilita esta opción, para cada transacción necesitarás capturar el cargo. Habilita la autocaptura si por ejemplo en tu tienda cuentas con un alto volumen de transacciones o no requieres de capturar las ordenes manualmente.
Configuración en WooCommerce
- Del menú de WooCommerce selecciona Settings
- Busca la sección Hola Cash y da click al botón Manage
- En el plugin de Hola Cash hay varias opciones de configuración:
- Enable: Marca la casilla para habilitar el uso del plugin, aparecerá como método de pago en tu tienda.
- Sandbox: Esto habilitará el ambiente de Sandbox. En el modo de sandbox las transacciones son procesadas en el ambiente de sandbox de Hola Cash. Estas no son transacciones reales y no hay dinero real en movimiento. Usa el modo sandbox para probar tu integración. Deshabilita el modo Sandbox para aceptar pagos reales de tus clientes.
- Public API Key: Agrega tu API Key Público
- Private API Key: Agrega tu llave secreta de API, recuerda nunca compartir esta llave.
- Webhook Key: Agrega tu llave asociada al webhook, para más información revisa nuestro tutorial de webhooks.
- Debug: Usa esta configuración para visualizar eventos en la consola.
Enviando parámetros adicionales
Puedes enviar parámetros adicionales en tu orden, pueden ser información útil relacionada a la orden de Hola Cash. Enviar estos parámetros es opcional. Además, si el $modified_additonal_data retornado no es un arreglo asociativo válido, entonces la información va a ser ignorada y no se enviará al API.
- En el server-side dentro de functions.php agrega el siguiente código:
add_filter('holacashwc_add_charge_additional_details','holacashwc_add_charge_additional_details',10,1);
/**
* Returns modified additional data array
* @param - $additional_data - current additional data array
* @return - $modified_additional_data - Modified additional data array
*/
function holacashwc_add_charge_additional_details($additional_data){
// example data
$modified_additonal_data=array(
array(
'name'=>'is_store_pickup',
'value'=>true
),
array(
'name'=>'is_customer_registered',
'value'=>false
)
);
return $modified_additonal_data;
}
Asegúrate de que la función holacashwc_add_charge_additional_details retorne un arreglo asociativo de todos los metadatos adicionales que quieres enviar a Hola Cash
Actualiza tu plugin
- Ingresa a tu cuenta de Wordpress y en el Dashboard, selecciona "Plugins"
- Activa "auto-update" ¡Listo! Activaste las actualizaciones automáticas.
