Al elegir Koin, ofreces a tus clientes una forma de pago simple, segura y extremadamente flexible, haciendo todo más práctico y conveniente.
Esta guía sencilla te ayudará a configurar la solución en tu tienda Woocommerce en pocos pasos.
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 por Koin);
Wordpress 5.0 (o superior);
PHP 7.4 (o superior);
Woocommerce (instalado y activado).
Instalación
Antes de iniciar la configuración del plugin, será necesario realizar la instalación del módulo como se indica a continuación:
Hay dos formas de realizar la instalación del plugin Koin para Woocommerce:
- Instalación a través de la tienda de plugins (Recomendado);
- Instalación manual.
¡Atención!
Antes de continuar con la instalación del plugin de Koin, verifica si el plugin Woocommerce está instalado y activado.
A continuación se muestra el paso a paso para realizar la instalación del plugin de Koin:
Instalación a través de la tienda de plugins
Acceda a la página de plugins del panel administrativo de WordPress.
En la parte superior de la página, haga clic en “Agregar plugin”.
Busque “Koin Official Payments for WooCommerce” en la barra de búsqueda y haga clic en “Instalar”.
A continuación, active el plugin.
Aquí hay un video demostrativo de los pasos mencionados anteriormente:
Instalación manual (carga de archivo)
Acceda a la página del plugin en el repositorio oficial de WordPress. (Enlace)
Haga clic en “Descargar”;
Después de descargar el plugin Koin, acceda a su panel administrativo de WordPress;
Haga clic en la opción “Plugins” y luego en “Añadir Plugin”;
En la siguiente página, haga clic en “Enviar Plugin”;
Luego, haga clic en “Seleccionar el archivo” y localice el archivo comprimido del plugin que comienza con “wc-koin-official”;
A continuación, haga clic en “Instalar Ahora”;
Después de la instalación, es necesario activar el plugin.
Koin ofrece un menú de opciones en la barra lateral izquierda, donde se encuentran todos los menús de configuración de WordPress:

Obs: Solo continúe con la etapa de configuración si tiene sus credenciales de Koin.
Con sus credenciales de Koin, siga los pasos a continuación:
Haga clic en Configuraciones y configure los campos a continuación:
Ambiente: Sandbox o Producción - el campo define el tipo de transacción que realizará con el plugin. (Sandbox = transacciones de prueba, Producción = transacciones reales)
Código de la Tienda (información enviada por Koin)
Cuenta de la Tienda (información enviada por Koin)
Clave Secreta (información enviada por Koin)
ID de la organización (información enviada por Koin)
Estado de éxito para pedidos - define cuál será el estado de éxito en los pedidos, “Procesando” o “Concluido”.
Países de Transacción (Define los países que el plugin irá aceptar transacciones, como Brasil y países LATAM);
Para finalizar las configuraciones, habilite las opciones:
- Registros (habilita el registro temporal de los logs de Koin en Woocommerce)
- Mi Cuenta (esta opción crea una nueva sección en su página de mi cuenta. En esta sección se listarán solamente los pedidos de Koin)
- Opciones de sincronización de pedidos (crea un botón de sincronización de pedidos en las páginas de los pedidos que fueron creados con el plugin)Para finalizar, haga clic en “Guardar cambios”.
Vea el video demostrativo:
Pix Parcelado (BNPL - ¡Paga en cuotas sin tarjeta!)
Configuraciones
Página de finalización (checkout)

Página de agradecimiento (Página de agradecimiento)

Pix (a la vista)
Configuraciones
Marque a opção “Activar” para activar el método de pago.
Complete el campo “Título” con el texto que desea mostrar en la lista de métodos de pago en el checkout.
Complete el campo “Descripción” con el texto que desea mostrar en la descripción del método de pago en el checkout.
Defina una opción para “Tiempo de validez” para definir el tiempo máximo de validez del QrCode generado.
Configuración adicional:
Aplicar descuento en el método de pago
Permite aplicar un descuento al comprador cuando se selecciona el método de pago.
Configuración:
Dentro de la configuración del método de pago “Tarjeta de crédito”, tiene la opción “Tipo de descuento”.
Selecciona el tipo de descuento para activar la funcionalidad, siendo: por porcentaje o valor fijo.
Luego, añade en el campo “Valor del descuento” el valor que se aplicará en el carrito.
Página de finalización (checkout)

Página de finalización (checkout)
Página de agradecimiento (Página de agradecimiento)
Tarjeta de Crédito con antifraude
Configuraciones
Regla de Parcelamiento (configuración)
Sincronización de pedidos
Pedidos
Sincronización de pedidos
Esta funcionalidad sirve para forzar la verificación del estado del pedido en la plataforma de Koin. Al hacer clic en el botón, el plugin consultará y actualizará el estado del pedido de acuerdo con el estado de Koin.
Información del pedido
La información de los pedidos de Koin puede aparecer en 2 formatos:
1.0 Edición del pedido (Administrador):
2.0 Visualización del pedido y página de agradecimiento (cliente):
En la página "Mi Cuenta", el plugin crea un menú llamado "Pagos Koin". Todos los pedidos realizados con el plugin Koin serán listados allí.
Reembolso y Cancelación
Reembolso
Para realizar la devolución de una transacción realizada a través de los métodos de pago de Koin, accede al pedido dentro del panel de administrador de WooCommerce. Ruta: Menú WooCommerce > Pedidos.
Sigue los pasos a continuación:
localiza y haz clic en el botón "Devolución" dentro del pedido;
En total reembolsado, ingresa el valor de la devolución;
Y por último, haz clic en "Devolución por Koin".
A continuación, sigue el video demostrativo:
Cancelación
Para realizar la cancelación de una transacción realizada por los métodos de pago de Koin, acceda al pedido dentro del panel de administración de Woocommerce.
Caminho: Menú Woocommerce > Pedidos.
¡Atención!
Solo se pueden cancelar pedidos que estén abiertos, es decir, que no hayan tenido la confirmación de pago.
Siga los pasos a continuación:
localice la opción "Estado" y cambie a "Cancelado" dentro del pedido;
A continuación, haga clic en "Actualizar" para confirmar la acción de cancelar el pedido.
A continuación, se muestra un video demostrativo: