Conecta tu pasarela de pago

Una pasarela de pago es el servicio que le cobra a tu cliente con tarjeta, PSE, Nequi u otros medios y después te transfiere la plata. Cuando conectas la tuya a Klopi, cada factura puede llevar un link de pago: tu cliente lo abre, paga, y Klopi marca la factura como pagada sin que tengas que registrar nada.

Klopi trabaja con Wompi, Mercado Pago, PayU y ePayco. La cuenta en la pasarela es tuya: la plata va directo de tu cliente a tu cuenta en la pasarela, no pasa por Klopi.

Antes de empezar

El módulo Cobros, que viene en los dos planes. Si no ves Cobros en línea en Configuración → Más ajustes, revisa cómo activar un módulo.
Ser Propietario o Administrador de la empresa en Klopi. Los demás roles no ven esta pantalla.
Tu cuenta en la pasarela creada y aprobada, y acceso a su panel para copiar las llaves. Cada pasarela revisa tus documentos antes de dejarte cobrar de verdad; ese trámite se hace con ellos, no en Klopi.

Conecta la pasarela

Entra a En Klopi: Configuración, luego Más ajustes, luego Cobros en línea. Ves una tarjeta por pasarela, con los medios de pago que acepta.
En la tarjeta de tu pasarela, haz clic en Conectar. Se abre un panel que te dice, arriba, en qué parte del panel de la pasarela están las llaves.
Copia cada llave del panel de la pasarela y pégala en su campo (la tabla de abajo dice cuáles son).
Deja prendido Modo pruebas si pegaste las llaves de prueba de la pasarela. Apágalo si pegaste las de producción.
En ¿A dónde llega la plata?, elige la cuenta de Klopi donde quieres ver los cobros. Si no eliges nada, llegan al Banco predeterminado.
En ¿Cuánto se queda … de cada cobro?, copia de tu contrato con la pasarela el Porcentaje (sin IVA) y el Valor fijo por cobro (sin IVA), y deja prendido A la comisión le suman IVA si te la cobran con IVA. Si la pasarela te hace retenciones, ábrelas en Retenciones que te hace… y elige la pasarela como contacto. Lo ves en La comisión de tu pasarela.
Haz clic en Conectar.
Si usas Wompi, vuelve a abrir la tarjeta con Configurar, copia la URL de notificaciones y pégala en tu panel de Wompi, en Desarrolladores → Eventos.

Pasarela	Dónde están las llaves	Campos en Klopi
Wompi	Panel de Wompi: Desarrolladores → Llaves	Llave pública, Llave privada (opcional), Secreto de integridad y Secreto de eventos
Mercado Pago	Mercado Pago Developers: Tus integraciones → tu aplicación → Credenciales de producción (o de prueba)	Access token y Clave secreta de webhooks, que está en Tus integraciones → Webhooks → Configurar notificaciones
PayU	Módulo PayU: Configuración → Configuración técnica	Merchant ID, Account ID (el de tu cuenta en Colombia) y API Key
ePayco	Panel de ePayco: Integraciones → Llaves API	P_CUST_ID_CLIENTE, PUBLIC_KEY y P_KEY

Cuando la tarjeta dice Conectada o Predeterminada, la pasarela ya puede cobrar. Si dice Faltan llaves, abre Configurar y completa los campos que faltan.

Elige con qué pasarela salen tus links

Puedes tener varias pasarelas conectadas. Los links de pago nuevos usan la Predeterminada. La primera que conectas queda como predeterminada sola.

Para cambiarla, haz clic en Usar para los links en la tarjeta de otra pasarela conectada, o prende Usar para los links de pago dentro de su panel y haz clic en Guardar. Los links que ya enviaste siguen cobrando por la pasarela con la que se crearon.

Pasa de pruebas a producción

En la tarjeta de la pasarela, haz clic en Configurar.
Borra cada llave y pega la de producción. Las llaves secretas no se muestran: el campo dice «Guardada · escribe para reemplazarla». Si lo dejas vacío, Klopi conserva la que tenía.
Apaga Modo pruebas.
Haz clic en Guardar.
En Wompi, confirma que la URL de notificaciones esté pegada en Desarrolladores → Eventos del ambiente de producción.

Desconecta una pasarela

Abre Configurar, haz clic en Desconectar y confirma. Klopi borra sus llaves, y los links de pago que enviaste con ella dejan de funcionar. Los pagos que ya llegaron se quedan registrados. Si era la predeterminada, otra pasarela conectada toma su lugar.

Qué pasa después

Para cobrar, crea el link desde la factura, como se explica en Cobra con un link de pago.
Al terminar de pagar, tu cliente vuelve a una página de Klopi que le dice cómo quedó su pago: recibido, no realizado o en proceso. Si fue rechazado, le dice que no se le cobró nada y que puede intentarlo otra vez.
Cuando tu cliente paga, la pasarela le avisa a Klopi. Klopi registra el pago con su recibo de caja, abona la factura y deja la plata en la cuenta que elegiste en ¿A dónde llega la plata?. La contabilidad del cobro queda hecha.
Si el pago queda pendiente —por ejemplo, un PSE que el banco aún no confirma—, Klopi espera. La factura se abona solo cuando la pasarela dice que el pago fue aprobado.
Si la pasarela reversa o reembolsa un pago que ya estaba aprobado, Klopi anula ese pago, su recibo de caja queda Anulado y la factura vuelve a quedar con saldo.
Si la pasarela aprueba un valor distinto al del link, Klopi no lo registra como pago y le avisa al dueño del negocio en la campana de notificaciones. Revisa esa transacción en tu pasarela y, si la plata llegó, registra el pago a mano en la factura o devuélvesela a tu cliente.
La comisión de la pasarela se registra sola como un gasto, con su IVA y las retenciones que te hace, si escribiste tu tarifa al conectarla. Lo ves en el recibo de caja: «La pasarela se quedó» y «Te transfiere». Detalle en La comisión de tu pasarela.

Preguntas frecuentes

¿Klopi cobra comisión por los pagos en línea?

La comisión que ves es la de tu pasarela, según el contrato que tienes con ella. La plata va de tu cliente a tu cuenta en la pasarela, sin pasar por Klopi.

Mi cliente pagó, pero la factura sigue por cobrar. ¿Qué hago?

Revisa tres cosas. Primero, si usas Wompi, que la URL de notificaciones esté pegada en Desarrolladores → Eventos. Segundo, que Modo pruebas coincida con las llaves: llaves de producción con el modo pruebas prendido, o al revés, no funcionan. Tercero, que el pago no esté pendiente en el panel de la pasarela; Klopi lo abona cuando la pasarela lo aprueba.

¿Qué medios de pago puede usar mi cliente?

Los que ofrece tu pasarela y tengas habilitados con ella. En Klopi, cada tarjeta muestra los principales: Wompi acepta tarjeta, PSE, Nequi y botón Bancolombia; Mercado Pago, tarjeta, PSE y Efecty; PayU, tarjeta, PSE y efectivo; ePayco, tarjeta, PSE, Nequi, Daviplata y efectivo.

¿Puedo cambiar de pasarela sin perder los links que ya envié?

Sí, siempre que no desconectes la anterior. Conecta la nueva y márcala como predeterminada: los links nuevos salen con ella y los anteriores siguen cobrando por la pasarela con la que se crearon. Si desconectas la anterior, sus links dejan de funcionar.

¿Klopi guarda las llaves de mi pasarela?

Sí, cifradas. Las llaves secretas nunca se vuelven a mostrar en la pantalla ni llegan al navegador de tu cliente. Al desconectar la pasarela, Klopi las borra.