Activar pago SPEI (Conekta)

Para qué sirve. Que los residentes paguen sus cargos (mantenimiento, reservas, credenciales…) por transferencia SPEI con una CLABE que genera el sistema, y que el pago se acredite solo — sin que nadie suba comprobante ni lo valide a mano. El dinero cae directo en la cuenta Conekta de tu condominio; HabiKaan solo concilia el depósito (nunca toca el dinero).

Requisitos.

• Una cuenta en Conekta a nombre del condominio / la asociación civil, con SPEI habilitado.
• La secret key (llave privada, empieza con key_) de esa cuenta — está en el panel de Conekta en Configuración → API Keys → llave privada/secreta (NO la pública).

Pasos (admin).

1. Entra a Configuración → Pagos y baja a Pago en línea SPEI (Conekta).
2. Pega tu secret key de Conekta en el campo y toca 💾 Guardar Key. La key es obligatoria: hasta guardarla no puedes activar SPEI (el interruptor está deshabilitado). Usa el ícono de ojo del campo para verificar lo que escribes.
3. Ya con la key guardada, marca los métodos que aceptes — son independientes:

• SPEI (transferencia con CLABE, se acredita solo).
• Tarjeta (crédito/débito; el residente paga en la página segura de Conekta).
• OXXO (efectivo; el residente paga en la tienda con una referencia). Activa solo los que quieras y Guarda. Tarjeta y OXXO además deben estar habilitados en tu cuenta de Conekta (proveedores de tarjeta / efectivo).
• Meses Sin Intereses (MSI): si aceptas tarjeta, puedes activar MSI y elegir los plazos (3/6/9/12/18/24) y un monto mínimo. Junto a cada plazo se muestra la comisión referencial que absorbe el condominio (la tasa real es la de tu contrato con Conekta). Solo aplica a tarjeta de crédito y requiere MSI habilitado en tu cuenta de Conekta.

1. En tu panel de Conekta → Webhooks, agrega un webhook del evento order.paid apuntando a la URL que se muestra en pantalla. Copia la URL completa tal cual aparece: si tu servidor tiene configurado el token de origen, la URL incluye un ?t=… al final — cópialo también, porque el webhook rechaza las peticiones que no traen ese token. Sin este webhook, los pagos no se acreditan solos.

Notas / reglas.

• Cada condominio conecta su propia cuenta; el dinero nunca pasa por la plataforma.
• Si un condominio activa SPEI pero no captura key, se usa la cuenta global de la plataforma como respaldo (solo para pruebas/demostración).
• El sistema reconfirma cada depósito con Conekta antes de acreditarlo y es idempotente (un mismo depósito nunca se aplica dos veces).
• Seguridad del webhook: el endpoint valida un token secreto (se anexa a la URL como ?t=…, configurado por el proveedor en el servidor) y rechaza con error las llamadas sin él. Aun así, la acreditación real siempre se reconfirma contra Conekta, así que nadie puede simular un pago.