Portal de Integraciones Koin

Al elegir Koin, ofreces a tus clientes una forma de pago simple, segura y extremadamente flexible, con la opción de pagar en cuotas sin tarjeta, haciendo que todo sea más práctico y conveniente.

Este sencillo guía te ayudará a configurar la solución en tu tienda Wake en pocos pasos.

2.0 Requisitos previos

Para el correcto funcionamiento del plugin, tenga en cuenta los requisitos previos a continuación:

Cuenta creada en Koin;

Credenciales Koin (información enviada en el onboarding por Koin)

Acceso de administrador de la plataforma Wake.

¡Atención!
En el servicio de pago BNPL (¡Paga a plazos sin tarjeta!), se emplea la tecnología de huella digital del dispositivo, implementada a través de un script de JavaScript. Este script realiza la recopilación de datos de comportamiento del usuario — como características del navegador, sistema operativo, entre otros — con el objetivo de identificar el dispositivo y fortalecer el análisis antifraude.
La orientación para la inserción del script en la Wake está en el paso 7.0 Inclusión del Script.

3.0 Crear Token Wake

Antes de iniciar la configuración de Koin en su plataforma Wake, será necesario crear un token que se utilizará en los siguientes pasos de creación.

Inicie sesión en su plataforma Wake y acceda al camino a continuación para crear el Token Wake:

En el menú lateral, haga clic en Configuraciones;
A continuación, haga clic en Integraciones;
Después haga clic en Tokens;
Haga clic en Agregar Token;
En el campo Nombre de la Aplicación, complete con Koin;
En Permisos, marque las siguientes opciones:
- Pedido - marque la opción "GET pedidos/{pedidoId}"
- Webhook - marque las opciones a continuación:
  - "GET /webhook/inscripcion"
  - "POST /webhook/inscripcion"
  - "PUT /webhook/inscripcion/{inscripcionId}/Activar
Haga clic en Guardar.
¡Atención!
Copie el Token generado, ubicado al lado del Nombre de la Aplicación, será necesario utilizarlo para configurar el conector de pago de Koin, en la etapa 4.0.

To embed a website or widget, add it to the properties panel.

4.0 Configurar Conector de Pagos

En esta etapa, es necesario instalar el conector de pagos "Koin - Pix Parcelado".

Acceda a la opción Pagos, en el menú lateral;
Haga clic en Conectores de Pagos;
En la siguiente pantalla, localice la opción "Koin - Pix Parcelado" y haga clic en "Instalar Configuración";
A continuación, se abrirá la ventana de configuración del conector. Rellene los campos a continuación con la información proporcionada por Koin y con el wake_token, generado en su plataforma Wake (etapa 3.0)
Los campos necesarios para el llenado son:
- store_code: {Código de la tienda Koin};
- account: {Cuenta de la tienda Koin};
- private_key: {Clave privada Koin};
- org_id: {Clave orgId Koin};
- wake_token: {Token de integración de Wake generado en el paso 3};
- expiration_minutes: {Tiempo de expiración del QRCode en minutos};
- User-Agent: insertar en el valor del campo koin;
En Antifraude, seleccione la opción "Ninguno";
Finalice haciendo clic en Actualizar.

En esta etapa, es necesario instalar el conector de pagos "Koin - Pix Parcelado".

Acceda a la opción Pagos, en el menú lateral;
Haga clic en Conectores de Pagos;
En la siguiente pantalla, localice la opción "Koin - Pix Parcelado" y haga clic en "Instalar Configuración";
A continuación, se abrirá la ventana de configuración del conector. Complete los campos a continuación con la información proporcionada por Koin y con el wake_token, generado en su plataforma Wake (etapa 3.0)
Los campos necesarios para completar son:
- store_code: {Código de la tienda Koin};
- account: {Cuenta de la tienda Koin};
- private_key: {Clave privada Koin};
- org_id: {Clave orgId Koin};
- wake_token: {Token de integración de Wake generado en el paso 3};
- expiration_minutes: {Tiempo de expiración del QRCode en minutos};
- User-Agent: ingresar en el valor del campo koin;
En Antifraude, seleccione la opción "Ninguno";
Finalice haciendo clic en Actualizar.

En esta etapa, es necesario instalar el conector de pagos "Koin - Pix Parcelado".

Acceda a la opción Pagos, en el menú lateral;
Haga clic en Conectores de Pagos;
En la siguiente pantalla, localice la opción "Koin - Pix Parcelado" y haga clic en "Instalar Configuración";
A continuación, se abrirá la ventana de configuración del conector. Complete los campos a continuación con la información proporcionada por Koin y con el wake_token, generado en su plataforma Wake (etapa 3.0)
Los campos necesarios para completar son:
- store_code: {Código de la tienda Koin};
- account: {Cuenta de la tienda Koin};
- private_key: {Clave privada Koin};
- org_id: {Clave orgId Koin};
- wake_token: {Token de integración de Wake generado en el paso 3};
- expiration_minutes: {Tiempo de expiración del QRCode en minutos};
- User-Agent: insertar en el valor del campo koin;
En Antifraude, seleccione la opción "Ninguno";
Finalice haciendo clic en Actualizar.

To embed a website or widget, add it to the properties panel.

Obs.: En este vídeo la información ingresada en el campo "valor" no es real. En su configuración, utilice la información enviada por el equipo de onboarding de Koin.

Obs.: En este vídeo las informaciones llenadas en el campo "valor" no son reales. En su configuración utilice la información enviada por el equipo de onboarding de Koin.

Obs.: En este video las informaciones completadas en el campo "valor" no son reales. En su configuración, utilice la información enviada por el equipo de incorporación de Koin.

5.0 Grupos y Parcelamientos

5.1 Crear Grupo de pago

La próxima etapa será la creación de un grupo de pago:

Acceda en el menú a la opción “Pagos” y luego haga clic en “Gestión de Pagos”;
En la pantalla de Gestión de pagos, haga clic en “+ CREAR GRUPOS”;
Se abrirá la pantalla para registrar un nuevo grupo de pago;
Agregue el nombre “Koin” en el campo “Nombre del grupo”;
También agregue el nombre “Koin” en el campo “Nombre para mostrar”;
En el campo “Valor mínimo”, agregue el valor “$ 1.00”;
No es necesario agregar o configurar información en los otros campos disponibles;
A continuación, es necesario subir la imagen del logo de Koin (descargue la imagen, haciendo clic aquí)
Después de descargar la imagen, haga clic en “Usar nueva imagen”;
Por último, haga clic en “Guardar”.

El siguiente paso será la creación de un grupo de pagos:

Acceda en el menú a la opción “Pagos” y luego haga clic en “Gestión de Pagos”;
En la pantalla de Gestión de pagos, haga clic en “+ CREAR GRUPOS”;
Se abrirá la pantalla para registrar un nuevo grupo de pagos;
Agregue el nombre “Koin” en el campo “Nombre del grupo”;
Y también agregue el nombre “Koin” en el campo “Nombre para mostrar”;
En el campo “Valor mínimo”, agregue el valor “R$ 1.00”;
No es necesario agregar o configurar información en los otros campos disponibles;
A continuación, es necesario subir la imagen del logo de Koin (descargue la imagen, haciendo clic aquí)
Después de descargar la imagen, haga clic en “Usar nueva imagen”;
Por último, haga clic en “Guardar”.

El siguiente paso será la creación de un grupo de pagos:

Acceda en el menú a la opción “Pagos” y luego haga clic en “Administración de Pagos”;
En la pantalla de Administración de pagos, haga clic en “+ CREAR GRUPOS”;
Aparecerá la pantalla para registrar un nuevo grupo de pagos;
Agregue el nombre “Koin” en el campo “Nombre del grupo”;
Y también agregue el nombre “Koin” en el campo “Nombre de visualización”;
En el campo “Valor mínimo”, agregue el valor “R$ 1.00”;
No es necesario agregar o configurar información en los otros campos disponibles;
A continuación, es necesario subir la imagen del logo de Koin (realice la descarga de la imagen, haciendo clic aquí)
Una vez descargada la imagen, haga clic en “Usar nueva imagen”;
Por último, haga clic en “Guardar”.

To embed a website or widget, add it to the properties panel.

5.2 Crear Parcelamiento

A continuación, es necesario crear una forma de parcelamiento (Aunque no se use, esta configuración es necesaria).

Accede en el menú a la opción “Pagos” y luego haz clic en “Gestión de Pagos”;
Luego, haz clic en “Parcelamientos”;
Se abrirá una ventana lateral, haz clic en “+ Crear Parcelamientos”;
En la siguiente pantalla, completa los campos con la información a continuación:
- Nombre del parcelamiento: Koin;
- Número de cuotas: 1;
- Valor mínimo por cuota: 0.10.

Luego haz clic en “Guardar”.

A continuación, es necesario crear una forma de parcelamiento (Aunque no se utilice, esta configuración es necesaria).

Acceda en el menú a la opción “Pagos” y luego haga clic en “Gestión de Pagos”;
A continuación, haga clic en “Parcelamientos”;
Se abrirá una ventana lateral, haga clic en “+ Crear Parcelamientos”;
En la siguiente pantalla, complete los campos con la información a continuación:
- Nombre del parcelamiento: Koin;
- Número de parcelas: 1;
- Valor mínimo por parcela: 0.10.

A continuación haga clic en “Guardar”.

A continuación, es necesario crear una forma de parcelamiento (Aunque no se utilice, esta configuración es necesaria).

Acceda en el menú a la opción “Pagos” y luego haga clic en “Gestión de Pagos”;
A continuación, haga clic en “Parcelamientos”;
Se abrirá una ventana lateral, haga clic en “+ Crear Parcelamientos”;
En la siguiente pantalla, complete los campos con la información a continuación:
- Nombre del parcelamiento: Koin;
- Número de cuotas: 1;
- Valor mínimo por cuota: 0.10.

A continuación, haga clic en “Guardar”.

To embed a website or widget, add it to the properties panel.

5.3 Vincular Configuraciones

Después de completar las etapas de Creación de Token, Configuración de Pago Personalizado, creación del Grupo de Pago y Parcelamiento, es necesario vincular las configuraciones al Grupo creado:

Localiza el grupo de pago "Koin";
Haz clic en “Vincular formas de pago” y selecciona la opción “Koin - Pix Parcelado”;

A continuación, haz clic en “Vincular Configuraciones”;
Aparecerá un pop-up de “Formas de Pago”, haz clic en la opción “koin”;
A continuación, vincula el parcelamiento haciendo clic en “Vincular Parcelamiento”;
Aparecerá el pop-up de “Parcelamientos”, haz clic en la opción “koin”;
Por último, habilita la forma de pago vinculada al grupo de pago koin.

Después de realizar las etapas de Creación de Token, Configuración de Pago Personalizado, creación del Grupo de Pago y Parcelamiento, es necesario vincular las configuraciones al Grupo creado:

Localiza el grupo de pago "Koin";
Haz clic en “Vincular formas de pago” y selecciona la opción “Koin - Pix Parcelado”;

A continuación, haz clic en “Vincular Configuraciones”;
Aparecerá un pop-up de “Formas de Pago”, haz clic en la opción “koin”;
Luego, vincula el parcelamiento haciendo clic en “Vincular Parcelamento”;
Aparecerá el pop-up de “Parcelamientos”, haz clic en la opción “koin”;
Por último, habilita la forma de pago vinculada al grupo de pago koin.

Después de realizar las etapas de Creación de Token, Configuración de Pago Personalizado, creación del Grupo de Pago y Planificación, es necesario vincular las configuraciones al Grupo creado:

Localiza el grupo de pago "Koin";
Haz clic en “Vincular formas de pago” y selecciona la opción “Koin - Pix a Plazos”;

A continuación, haz clic en “Vincular Configuraciones”;
Aparecerá un pop-up de “Formas de Pago”, haz clic en la opción “koin”;
A continuación, vincula la planificación haciendo clic en “Vincular Planificación”;
Aparecerá el pop-up de “Planificaciones”, haz clic en la opción “koin”;
Por último, habilita la forma de pago vinculada al grupo de pago koin.

To embed a website or widget, add it to the properties panel.

6.0 Estructura de Pago

6.1 Información importante

La creación de la estructura de pago no es obligatoria. (ver documentación de Wake).

Cuando no haya ninguna estructura de pago configurada, en la página de cierre, se mostrarán todos los grupos de pago activos siguiendo el orden de registro del grupo.

6.2 Crear Estructura de Pagos

Si ya tiene una estructura de pagos creada, pase a la siguiente etapa (6.3).

Para crear la estructura de pagos, acceda a la opción "Organización de Pagos"

Haga clic en “+ Crear Estructura”;
Aparecerá un pop-up para ingresar el nombre de la estructura, añada “koin”;
Y luego haga clic en “+ Crear Estructura”;

Si ya tiene una estructura de pagos creada, pase a la siguiente etapa (6.3).

Para crear la estructura de pagos, acceda a la opción "Organización de Pagos"

Haga clic en “+ Crear Estructura”;
Se abrirá un pop-up para insertar el nombre de la estructura, añada “koin”;
Y luego haga clic en “+ Crear Estructura”;

Si ya tiene una estructura de pagos creada, continúe a la siguiente etapa (6.3).

Para crear la estructura de pagos, acceda a la opción "Organización de Pagos"

Haga clic en “+ Crear Estructura”;
Aparecerá un pop-up para ingresar el nombre de la estructura, añada “koin”;
Y luego haga clic en “+ Crear Estructura”;

To embed a website or widget, add it to the properties panel.

6.3 Agregar Grupo de Pago a la Estructura

Después de crear la estructura de pago, es necesario agregar el grupo de pago a ella:

Haga clic en “Seleccionar grupo de pago”;
Se abrirá una pantalla “Grupo de pagos activos”, seleccione la opción “Koin”.
A continuación, haga clic en "Guardar Estructura".

To embed a website or widget, add it to the properties panel.

7.0 Agregar Script

En esta última etapa, es necesario agregar el script de Confirmación de Pago (QrCode Pix Parcelado) :

Accede a la opción "Configuraciones", en el menú lateral izquierdo;
Haz clic en "Gestor de Scripts";
A continuación, haz clic en "Agregar Script";
En la siguiente pantalla, completa los siguientes campos:
- Nombre: "Koin - Confirmación";
- Posición en la Página: elige "Header - Primera Línea";
- Páginas: Marca "Todas" con el Identificador "*Confirmacion";
- En "Contenido del Script", añade:
  <link href="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.css" rel="stylesheet" defer>
  <script type="text/javascript" src="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.js" defer></script>
- Haz clic en "Guardar".

To embed a website or widget, add it to the properties panel.

8.0 Consejos

A continuación encontrará algunos consejos para el correcto funcionamiento del conector Koin en su plataforma Wake:

El método de pago de Koin no aparece en el Checkout
- Puede ser necesario esperar hasta 2 horas para que el método de pago de Koin aparezca en su checkout.

- Limpie la caché de su plataforma Wake.

- Verifique si el conector Koin está activado.
Ruta: Pagos > Gestión de Pagos.

- Verifique si ya hay más de una estructura de pagos creada.
Ruta: Pagos > Organización de Pagos.

- En "Urls Permitidas", verifique si ha ingresado todas las urls mencionadas en el paso 8.0 y si están activas. Ruta: Configuraciones > Políticas de Seguridad > Urls Permitidas.

- Revise y rehaga, si es necesario, todos los pasos de esta documentación.

Para más información sobre la plataforma Wake, consulte la documentación haciendo clic aquí.

<link href="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.css" rel="stylesheet" defer><script type="text/javascript" src="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.js" defer></script>

<link href="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.css" rel="stylesheet" defer>
<script type="text/javascript" src="https://api-ecommerce.koin.com.br/wake/payments/payment-confirmation.js" defer></script>