Consejos
Consejos - Magento 2
1.0 Introducción
Este documento tiene como objetivo presentar consejos sobre el plugin de Koin para Magento 2:
Consejos de configuración general del plugin;
Dudas generales;
Consejos para la creación de reglas de financiación;
Identificando problemas y posibles soluciones.
2.0 Configuración General
A continuación, se presentan algunos consejos para la configuración general del plugin.
El camino para acceder a la configuración general es:
Ventas > Koin > Configuraciones > Ventas > Métodos de pago > Otros medios de pago > Koin > General.
2.1 Entorno de pruebas (Sandbox)
¿Koin permite realizar pruebas con el plugin Koin para Magento 2?
Sí, Koin permite realizar transacciones de prueba.
Sin embargo, recomendamos utilizar una cuenta de prueba creada por el equipo de Koin.
¿Cómo configuro mis credenciales de prueba Koin en el plugin?
Una vez que tenga las credenciales de prueba, basta con seguir el paso a paso de la configuración del plugin.
Puntos importantes:
Las credenciales de Producción y de Pruebas son diferentes.
Es importante verificar la configuración del campo “Usar Sandbox” (consultar etapa 4 de la documentación), si está seleccionada la opción “Sí”.
Para el método de pago BNPL, es importante habilitar en su navegador la extensión Modheader y configurar con la información a continuación:
En el campo name, ingrese el valor xdesp-sandbox;
En el campo value, ingrese el valor true;
Para su entorno de Producción, no olvide cambiar las credenciales de Koin, evitando enviar transacciones reales a la cuenta de pruebas
¿Puedo realizar pruebas de 3DS para tarjeta de crédito en sandbox?
Sí, es posible probar la estrategia de 3DS.
Para habilitar en Magento, acceda a Ventas > Koin > Configuraciones > Koin > General > Sandbox.
Luego, verifique si la opción "Usar Sandbox" tiene el valor "Sí";
Debajo de esta opción será necesario activar y configurar el tipo de estrategia, en los siguientes campos:
Usar Sandbox 3DS para transacciones de tarjeta - seleccione la opción "Sí";
Estrategia 3DS - elija una de las opciones: Challenge (presenta desafío OTP para el comprador) o Frictionless (no presenta el desafío OTP).
Por último, guarde las configuraciones.
¡Atención!
Para poder realizar las pruebas de la estrategia 3DS, será necesario solicitar la activación en su cuenta de prueba de Koin.
Verifique si la versión que está utilizando del conector Koin para Magento 2, ya contempla la funcionalidad de 3DS.
2.2 Habilitar Registros
¿Necesito habilitar la opción "Habilitar registro de solicitudes" en la configuración del plugin?
¡Sí! Esta opción permite que Koin registre las solicitudes enviadas desde el plugin y también identifique posibles errores en la solicitud.
Almacena la información de registro dentro de la carpeta var/logs, en la carpeta raíz de su plataforma Magento.
3.0 Dudas Generales
¿Cómo saber qué versión del plugin está instalada en mi Magento?
Para verificar la versión del plugin Koin instalado en su plataforma Magento, acceda al menú de configuraciones del plugin en Ventas > Koin > Configuraciones > Koin.
La versión se presentará justo debajo del nombre Koin.
Actualizaciones del plugin Koin
Todas las actualizaciones y correcciones se lanzan en nuestro repositorio, donde está almacenado el plugin de Koin, en Github.
Allí encontrará también toda la información sobre cada actualización.
¿Dónde veo en Magento las transacciones que se enviarons para Koin?
Hay dos lugares donde puede acceder a la información de las transacciones que se envían a Koin:
Accediendo a la información del pedido, en el menú habrá una opción con el nombre Koin. Allí se presentará la información del payload de Koin.
En el menú de opciones de Koin, dentro del menú Ventas, haga clic en Requests y Responses. En esta pantalla se presentan toda la información de las solicitudes y respuestas del plugin.
¿Por qué el pedido no actualizó el estado?
Para verificar la no actualización del estado de un pedido, verifique en su portal de comerciante de Koin si éste tuvo cambio de estado.
En caso afirmativo, a continuación se presentan algunos puntos a verificar:
Si en Requests y Responses presenta algún retorno de error;
En Callbacks, dentro del menú de opciones de Koin, si presenta algún retorno de error;
Si presenta algún registro en los logs de la plataforma. Ubicado en la carpeta var/logs, dentro de la carpeta raíz del servidor que alberga su aplicación Magento.
Verifique también la configuración de los campos de estado, dentro de las configuraciones del plugin Koin.
Si tiene un firewall configurado en el servidor que alberga su plataforma, verifique si ha realizado algún bloqueo de IP.
Checkout presenta error en la finalización de la compra
A continuación se presentan algunas posibilidades que provocan que se muestre un mensaje de error en la pantalla de checkout (Finalización de la compra):
Campos obligatorios no completados o no habilitados para el formulario de checkout;
Método de pago no habilitado en Koin;
Es importante verificar también si tiene algún registro en la opción Requests y Responses, en el menú de Koin en su plataforma de Magento;
Verifique también los logs. Ubicado en la carpeta var/logs, dentro de la carpeta raíz del servidor que alberga su aplicación Magento.
4.0 Reglas de cuotas
Ruta: Ventas > Koin > Reglas de cuotas
¡Atención!
La funcionalidad de reglas de cuotas solo está habilitada para el método de pago Tarjeta de Crédito.
A continuación se presentan algunas orientaciones sobre la creación y edición de las reglas de cuotas:
Las reglas de cuotas solo se aplican al método de pago Tarjeta de Crédito.
Evite errores en el checkout debido a conflictos de reglas. Antes de crear una regla, verifique si ya existe alguna regla con las mismas configuraciones y condiciones.
Si la regla no ha sido activada en una venta específica, verifique las configuraciones de la regla, tales como:
el campo Fecha de Término, que indica si la regla ha expirado;
Condiciones de la regla, como BIN, valor mínimo por cuota, valor mínimo o máximo del pedido.
El campo Cuenta, indica a qué cuenta de pago Koin se enviará la transacción. Si no se completa, se utilizará la cuenta de pago Koin configurada en el campo Cuenta, ubicado en las configuraciones generales del plugin.
Dada la configuración de cuotas general del plugin, en el checkout siempre aparecerá en la selección de cuota 1x.
4.1 Ejemplos de Reglas de cuotas
A continuación presentaremos algunos ejemplos de regla de parcelamiento.
Recomendamos que utilice solo como orientación en la creación de las reglas.
Para acceder directamente a cada ejemplo, haga clic en el enlace de abajo:
- Simple sin intereses;
- Simple hasta 6x sin intereses y de 7 a 12x con intereses;
- Parcelamiento con intereses específicos por cuota;
- Parcelamiento con valor mínimo de cuota;
- Configurar parcelamiento por encima de 12x;
- Regla de parcelamiento por Tarjeta;
- Regla con condición específica de cuotas.
4.1.1 Simples sin intereses
Si es aplicable en todos los casos, la configuración puede realizarse dentro de la configuración general del plugin Koin, accediendo Ventas > Koin > Configuraciones > Ventas > Métodos de Pago > Koin > Tarjeta de Crédito con Antifraude.
Configure solo los campos Mínimo de Cuotas (en pagos en efectivo) y Máximo de Cuotas.
Atención al campo Tiene interés, debe estar como no. Este campo habilita el traspaso de intereses al comprador.
Mira cómo se presentará la regla en el proceso de pago
4.1.2 Simples hasta 6x sin intereses y de 7 a 12x con intereses
Si es aplicable en todos los casos, la configuración puede realizarse dentro de la configuración general del plugin Koin.
Ruta: Ventas > Koin > Configuración > Ventas > Métodos de Pago > Koin > Tarjeta de Crédito con Antifraude.
Configure los campos:
- Min Cuotas: en pagos en efectivo
- Max Cuotas: número máximo de cuotas 12 cuotas.
- Max Cuotas Sin Interés: 6 cuotas.
- ¿Tiene Interés?: Sí
- Tipo de Interés: Simple
- Tasa de Interés: 1.99 (indicar el porcentaje de interés a aplicar)
Mira cómo aparecerá en el checkout la regla creada:
Para acceder a más ejemplos de reglas de pago en cuotas, haz clic aquí.
Mira cómo se presentará la regla en el proceso de pago
4.1.3 Parcelamento com juros específico por parcela
Se aplica en todos los casos, la configuración se puede realizar dentro de la configuración general del plugin Koin
Ruta: Ventas > Koin > Configuración > Ventas > Métodos de Pago > Koin > Tarjeta de Crédito con Antifraude
Será necesario configurar los siguientes campos:
Min Cuotas: en pagos en efectivo;
Max Cuotas: número máximo de cuotas 12 cuotas;
Max Cuotas Sin Interés: 6 cuotas;
Tiene Interés: Sí;
Tipo de Interés: Por Cuotas;
Abrirá la opción “Interés Por Cuotas”.
Haga clic en él y se abrirán los campos para configurar el porcentaje que se aplicará en cada cuota.
Ejemplo:
En la primera cuota no quiero reintegro de intereses;
En la segunda cuota quiero que se reintegre al comprador intereses del 1.20%;
En la tercera cuota quiero que se reintegre al comprador intereses del 1.25%;
En la cuarta cuota quiero que se reintegre al comprador intereses del 1.30%;
En la quinta cuota quiero que se reintegre al comprador intereses del 1.35%;
Desde la sexta cuota hasta la décimo novena, quiero que se reintegre al comprador intereses del 2%;
En la décima segunda cuota quiero que se reintegre al comprador intereses del 4%;
Vea cómo quedará la configuración:
Mira cómo se presentará la regla en el proceso de pago
4.1.4 Parcelamento com valor mínimo de cuota
Si es aplicable en todos los casos, la configuración se puede realizar dentro de la configuración general del plugin Koin.
Ruta: Ventas > Koin > Configuración > Ventas > Métodos de Pago > Koin > Tarjeta de Crédito con Antifraude
Configura los campos básicos, según sea necesario: Min Cuotas, Max Cuotas, Max Cuotas Sin Interés, ¿Tiene Interés?, Tipo de Interés.
Indica en el campo Importe Mínimo de Cuota, el valor mínimo para liberar el fraccionamiento. Ejemplo: campo Importe Mínimo de Cuota, configurado con el valor 25.
Valor total de la Compra: $75
Cuotas liberadas: 3
Cómo quedará la configuración del campo:
Mira cómo se presentará la regla en el proceso de pago
4.1.5 Configurar en más de 12 cuotas
Para habilitar el financiamiento superior a 12x para tarjeta de crédito, verifique con Koin la disponibilidad en su contrato.
La activación de este financiamiento en el plugin de Koin se realiza a través de la creación de una regla de cuotas.
Ruta: Ventas > Koin > Reglas de cuotas.
Vea la configuración de ejemplo en el video a continuación:
Mira cómo se presentará la regla en el proceso de pago
4.1.6 Regla de cuota por Bandeira
Camino: Ventas > Koin > Reglas de cuotas
¡Atención!
Para crear una regla de cuotas específica por bandera, será necesario agregar los Bines específicos de la bandera que desea activar la regla.
Ejemplo
- Regla para la bandera Visa,
- En el campo Métodos de Pago BINs, los Bines de Visa, como por ejemplo el 456514.
Ve el video de la configuración de la regla:
Mira cómo se presentará la regla en el proceso de pago
4.1.7 Regla con condición específica de cuotas
Caminho para criar a regra: Ventas > Koin > Reglas de Cuotas > Agregar Regla
- En este ejemplo citaremos la creación de una regla para un emisor de tarjeta de crédito específico. Usaré en este ejemplo Tarjeta Naranja.
- Como regla de parcelamiento, también tendrá la limitación de solo 3 cuotas sin intereses.
En este caso, será necesario crear la regla, como se cita en la opción “Regla de parcelamiento por bandera”, agregar los BINs específicos de Tarjeta Naranja y en los campos Cuotas Mínimas y Cuotas Máximas, tener el mismo valor “3”.
Ve el video de la configuración
Mira cómo se presentará la regla en el proceso de pago
- Creando la misma regla para Tarjeta Naranja, en 3x, aplicando intereses del 2%:
En este ejemplo, la configuración inicial de la regla permanece igual, pero será necesario habilitar el traspaso de intereses en el campo Has Interest, elegir el tipo de traspaso de intereses en el campo Interest Type y agregar el interés que se aplicará por cuota en el campo Interest Rate.
¡Atención!
No olvides informar los BINs referentes a la marca que será informada en las condiciones de la regla.
Ve el video de configuración de la regla
Mira cómo se presentará la regla en el proceso de pago
¡Atención!
Algunos bancos emisores de tarjeta ofrecen promociones específicas de financiación para determinados BINs de tarjeta.
Preste atención a la creación de las reglas de financiación, respecto a los intereses que se trasladarán al consumidor.