GalmiaVolver a Integraciones →

Guía de integración

Cómo conectar Khipu con Galmia

Con Khipu conectado, tu cliente paga un abono al reservar por transferencia bancaria directa y el dinero llega a tu cuenta bancaria al día siguiente hábil. Nunca pasa por Galmia.

Pasos

  1. 1

    Crea tu cuenta en Khipu

    Si aún no tienes cuenta, regístrate en khipu.com. Verás tu perfil y las opciones de configuración.

  2. 2

    Crea una Cuenta de cobro

    Ve a Configuración → Cuentas de cobro y usa el botón “Crear una nueva cuenta de cobro”. Vas a necesitar los datos bancarios donde quieres recibir el dinero.

  3. 3

    Crea una API Key y cópiala

    Dentro de la Cuenta de cobro recién creada, entra a la sección “Para integrar Khipu a tu sitio web” y busca el bloque API Keys. Haz clic en Nueva API Key, asígnale un alias (por ejemplo, “Galmia”) y cópiala.

    Importante: el valor completo de la API Key solo se muestra una vez, al momento de crearla. Después solo verás los primeros caracteres. Si la pierdes, tendrás que crear una nueva.
  4. 4

    Pégala en Galmia

    Vuelve a Integraciones en tu panel, abre la tarjeta de Khipu y pega la API Key. Verificamos las credenciales al instante y quedarás conectado.

¿Y la URL de notificación instantánea que aparece en Khipu?

No hace falta que la configures manualmente. Galmia adjunta automáticamente la URL de confirmación a cada cobro que crea, así que las reservas se confirman solas cuando el cliente paga. Puedes dejar ese campo vacío en el panel de Khipu.

Opcional: verificación estricta de firma

Khipu firma cada notificación con un secret merchant para que puedas verificar que efectivamente viene de Khipu (y no de un atacante). Si lo configuras, Galmia rechaza cualquier notificación con firma inválida.

  1. En Khipu, dentro de tu Cuenta de cobro, busca el bloque de configuración del webhook y genera/copia el secret merchant.
  2. En Galmia, abre el modal de conexión de Khipu y pégalo en el campo “Secreto de notificaciones (opcional)”.

Si no lo configuras, las notificaciones se procesan igual pero sin validación de firma (aceptable para arrancar).

Puedes ignorar estos otros campos de la pantalla de Khipu:

  • Identificación del cobrador (Id de cobrador + Llave): son de la API v2 legacy de Khipu. Galmia usa la API v3, así que no las necesitamos.
  • URL para reporte diario de rendición (DRN-2.0) y URL para reporte diario de transacciones (DTN-1.0): son para conciliación contable masiva. No hacen falta para cobrar abonos.

Consideraciones importantes

  • ▸
    Tope inicial de $5.000 CLP por cobro. Todas las cuentas de cobro nuevas parten con este límite. Khipu lo amplía en unas 72 horas hábiles después de evaluar tu cuenta. Mientras tanto, configura los abonos por debajo de ese monto o serán rechazados. Si necesitas más información escribe a soporte@khipu.com.
  • ▸
    Liquidación bancaria directa. El dinero llega a tu cuenta bancaria al día siguiente hábil, sin pasar por una wallet intermedia.
  • ▸
    Comisión de Khipu. Aproximadamente 1% – 1.5% por transacción (varía según tu plan con Khipu). Menos que un agregador tradicional.
  • ▸
    Solo transferencia bancaria. Khipu no acepta tarjetas. Si un cliente no tiene banca online, tendrá que pagar con otro medio.

¿Quieres probar sin cobrar dinero real?

Khipu tiene un Modo desarrollador que te permite crear una Cuenta de cobro paralela con bancos ficticios. Los pagos se simulan (no se transfiere dinero real) y puedes probar todo el flujo antes de activar la cuenta con datos bancarios reales.

  1. Activa el toggle Modo desarrollador en tu perfil de usuario.
  2. En Cuentas de cobro aparecerá el botón “Crear cuenta en modo desarrollador”. Créala y copia su API Key.
  3. Pega esa API Key en Galmia y marca la opción “Usar entorno sandbox (pruebas)” en el modal de conexión.
  4. Cuando estés listo para cobrar de verdad, crea la cuenta regular (paso 2 de arriba) y reemplaza la API Key.

Preguntas frecuentes

¿Galmia toca el dinero en algún momento?
No. El cobro va directo de la cuenta del cliente a tu cuenta bancaria vía Khipu. Galmia solo genera el link de pago y escucha el aviso de Khipu para confirmar la reserva.
¿Qué pasa si el cliente no paga a tiempo?
La cita queda bloqueada por el tiempo que hayas configurado (por defecto 30 minutos). Si no llega el pago, el horario se libera automáticamente para que otro cliente pueda reservarlo.
¿Puedo cambiar la API Key después?
Sí. Puedes rotar la key desde Khipu cuando quieras y actualizarla en Galmia sin perder configuración. Los cobros pendientes con la key anterior seguirán funcionando hasta que expiren.
¿Puedo usar Khipu junto con Flow o MercadoPago?
Sí. Puedes conectar los tres y elegir cuál usar por defecto en la configuración de tu agenda. También puedes dejar que el cliente elija al momento de pagar.

Documentación oficial de Khipu: docs.khipu.com