Personalización del Checkout de Koin
Introducción
El Checkout de Koin puede personalizarse para reflejar la identidad visual de la tienda y, opcionalmente, utilizar un dominio propio en lugar de la URL estándar de Koin. Ambas configuraciones son opcionales: si no se realizan, el checkout se mostrará con los colores, logo y URL por defecto de Koin.
Existen dos tipos de personalización disponibles:
- Marca y Look & Feel: permite configurar el logo, dominio, título y color principal de la tienda en el checkout. El favicon se genera automáticamente a partir del logo. A medida que se completan los campos, una vista previa muestra en tiempo real cómo quedará el checkout.
- URL personalizada: permite utilizar un dominio propio (ej:
https://koin.nombreempresa.com) en lugar de la URL estándar de Koin. Requiere coordinar el proceso técnico con el equipo de Koin.
Desde este módulo se podrá:
Requisitos previos
Antes de comenzar, es necesario que las siguientes configuraciones hayan sido completadas con el equipo de Soporte de Koin. Sin estas configuraciones, no será posible realizar la personalización o algunas opciones no estarán disponibles.
| # | Requisito | Descripción | Obligatorio |
|---|---|---|---|
| 1 | Usuarios y roles | Compartir con el equipo de Soporte los usuarios que podrán realizar las configuraciones de marca en el Portal Koin. Sin esta configuración, la sección de Configuración no será visible. | Sí |
| 2 | Activos de marca | Logo en formato .svg y color principal en formato RGB o código hexadecimal (#). | Solo para L&F |
| 3 | Subdominio definido | Subdominio propio que se utilizará para el checkout (ej: https://koin.nombreempresa.com). | Solo para URL personalizada |
| 4 | Contacto técnico | Persona técnica responsable de la configuración DNS, quien será el interlocutor directo del equipo de Koin. | Solo para URL personalizada |
Si alguno de los requisitos obligatorios no ha sido configurado, contactar al equipo de Soporte de Koin antes de continuar.
Términos clave
| Término | Descripción |
|---|---|
| Look & Feel | Apariencia visual del checkout: colores, logo y estilo general. |
| Color principal | Color principal de la marca. Se verá en comunicaciones, pantallas y botones del checkout. |
| Favicon | Pequeño ícono que aparece en la pestaña del navegador. Se genera automáticamente a partir del logo subido. |
| Store Code | Nombre del comercio tal como aparece en Store Manager. Se utiliza para identificar la tienda al momento de configurar la personalización. |
| Vista previa | Panel en tiempo real que muestra cómo quedará el checkout con las configuraciones aplicadas. |
| Dominio de Checkout | URL personalizada del checkout (ej: https://koin.nombreempresa.com). |
| Título de Checkout | Texto que aparece en la pestaña del navegador al momento del checkout. |
| Dominio de Estrategias de Recupero | URL personalizada de las páginas de recupero (ej: validación de identidad). |
| Título de Estrategias de Recupero | Texto que aparece en la pestaña del navegador en las páginas de recupero. |
| Subdominio | Parte del dominio principal que se utilizará para el Checkout de Koin (ej: koin.nombreempresa.com). Al configurarlo, se cede a Koin el control del ruteo de ese subdominio. |
| DNS | Sistema que permite asociar un nombre de dominio con una dirección de internet. La configuración DNS es gestionada por el proveedor de dominio del cliente. |
| Certificado SSL | Certificado de seguridad que habilita la conexión HTTPS en el subdominio configurado. Es gestionado y emitido por Koin. |
Configuración de marca y Look & Feel
Acceder a la configuración
- Ingresar al Portal Koin.
- En el menú de navegación superior, hacer clic en Configuración.
- Completar los campos del formulario en la sección Personalizar tu marca.
Si la sección Configuración no es visible, contactar al equipo de Soporte de Koin para solicitar los permisos correspondientes.
A medida que se completan los campos, la vista previa en la parte derecha de la pantalla mostrará en tiempo real cómo quedará el checkout con las configuraciones aplicadas.
Comercio
Seleccionar el comercio cuya configuración se desea editar. Si solo hay una tienda asociada a la cuenta, este campo se completará automáticamente. Si hay más de una, seleccionar la tienda deseada del listado.
País
Seleccionar a qué países aplicará la personalización de marca. Si aplica para todos los países, seleccionar "Todos".
Logo
Subir una imagen en formato .svg. Esta imagen reemplazará el logo de Koin en las interfaces donde la marca esté presente.
Dominio de Checkout
Ingresar únicamente el dominio de la página en formato https://koin.example.com. Para que este dominio quede activo es necesario coordinar el proceso técnico con el equipo de Koin. Ver Configuración de URL personalizada.
Título de Checkout
Texto que aparecerá en la pestaña del navegador del comprador durante el proceso de pago. Ejemplo: NombreCliente - Checkout.
Dominio de Estrategias de Recupero
Ingresar únicamente el dominio de las páginas de recupero en formato https://koin.example.com. Para que este dominio quede activo es necesario coordinar el proceso técnico con el equipo de Koin. Ver Configuración de URL personalizada.
Título de Estrategias de Recupero
Texto que aparecerá en la pestaña del navegador del comprador durante las páginas de recupero. Ejemplo: NombreCliente - Recupero.
Favicon
El favicon se genera automáticamente a partir del logo subido. Aparecerá en la pestaña del navegador del comprador junto al título del checkout.
Color principal
Elegir el color principal de la marca. Este color se verá en comunicaciones, pantallas y botones del checkout. Se puede seleccionar manualmente desde el selector de color o ingresar el código hexadecimal (#) directamente.
Si no se realiza ninguna configuración, el checkout se mostrará con los valores por defecto de Koin.
Configuración de URL personalizada
Introducción
Por defecto, los compradores son redireccionados a la URL estándar de Koin (https://payments.koinlatam.com/checkout/) al momento del pago. Para utilizar un dominio propio, lo primero es coordinar el proceso técnico con el equipo de Koin. Una vez finalizado ese proceso, se podrán configurar los campos correspondientes en el Portal Koin.
Importante: No realizar ninguna configuración DNS hasta que el equipo de Koin lo indique.
Paso 1 — Enviar la información inicial al equipo de Koin
Enviar al equipo de Soporte de Koin los siguientes datos:
- Subdominio que se desea utilizar (ej:
koin.nombreempresa.com) - Nombre y e-mail de la persona técnica responsable de la configuración DNS
El subdominio debe ser uno sobre el cual se tenga control total de DNS. Al configurarlo, se estará cediendo a Koin el control del ruteo de ese subdominio.
Importante: No realizar ninguna configuración DNS hasta que el Equipo de Seguridad de Koin lo indique.
Paso 2 — Koin gestiona el proceso técnico
El equipo de Koin recibe la información. A partir de este punto, el equipo de Seguridad de Koin tomará contacto directo con el responsable técnico del cliente para gestionar todo el proceso, hasta confirmar que el redireccionamiento esté funcionando correctamente.
El contacto inicial del equipo de Seguridad de Koin se realizará por e-mail.
Paso 3 — Koin valida el funcionamiento
Una vez finalizado el proceso técnico, el equipo de Soporte de Koin se comunicará con el cliente para confirmar que el redireccionamiento al Checkout de Koin esté funcionando correctamente.
Paso 4 — Configurar los campos en el Portal Koin
Con el proceso técnico finalizado, ingresar al Portal Koin y en la sección Personalizar tu marca, completar los siguientes campos:
- Dominio de Checkout: ingresar el dominio personalizado en formato
https://koin.nombreempresa.com. - Dominio de Estrategias de Recupero: ingresar el dominio personalizado de las páginas de recupero en formato
https://koin.nombreempresa.com.
Resumen del flujo
Marca y Look & Feel
| Paso | Acción | Responsable |
|---|---|---|
| 1 | Completar los campos del formulario en la sección Personalizar tu marca del Portal Koin | Cliente |
URL personalizada
| Paso | Acción | Responsable |
|---|---|---|
| 1 | Enviar al equipo de Soporte de Koin el subdominio elegido y los datos del contacto técnico | Cliente |
| 2 | El equipo de Seguridad de Koin gestiona todo el proceso técnico hasta confirmar el correcto funcionamiento del redireccionamiento | Koin |
| 3 | El equipo de Soporte de Koin valida que el redireccionamiento al Checkout esté funcionando correctamente | Koin |
| 4 | Configurar los campos de dominio y título en el Portal Koin | Cliente |
Preguntas frecuentes
¿Qué sucede si no se configura el DNS a tiempo?
Los datos DNS que Koin envía tienen una vigencia limitada. Si no se configuran antes de la fecha indicada, será necesario solicitar nuevos datos a Koin y reiniciar esa etapa del proceso.
¿Es posible usar cualquier subdominio?
El subdominio debe ser uno sobre el cual el cliente tenga control total de DNS. No es posible utilizar el dominio raíz (ej: nombreempresa.com), sino únicamente un subdominio (ej: koin.nombreempresa.com). Al configurarlo, se estará cediendo a Koin el control del ruteo de ese subdominio.
¿Qué pasa si no se visualiza correctamente el redireccionamiento?
Comunicarse con el equipo de Soporte de Koin indicando el subdominio configurado y una descripción del problema. El equipo realizará las verificaciones correspondientes.