Configuración de la cuenta

Estos endpoints existen para que puedas dar de alta y configurar una cuenta entera sin entrar al panel — útil si gestionas muchos alojamientos o si automatizas el onboarding de tus clientes.

Ajustes generales

curl -X PATCH https://api.kinapi.es/api/v1/settings \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{"ses":{"submitRequiresSignature":true}}'

curl -X PATCH https://api.kinapi.es/api/v1/settings \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{"notifications":{"guestInvitations":{"enabled":false,"reminder":true,"lastCall":true},"guestReplyTo":"reservas@example.com"}}'

Marca del formulario (marca blanca)

Personaliza lo que ven tus huéspedes con tu color, tu logo y tu nombre comercial: su página de registro y la cabecera de sus correos. Nunca cambia el panel ni los contratos.

# color y logo a la vez
curl -X PATCH https://api.kinapi.es/api/v1/branding \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d "{\"primaryColor\":\"#0B6E4F\",\"logo\":\"$(base64 -i logo.png)\"}"

Webhook saliente

Configura a qué URL te avisamos y de qué eventos. El GET devuelve además la lista de eventos disponibles y el secreto con el que firmamos cada entrega — el mismo que necesitas para verificar la cabecera x-kinapi-signature-sha256 (cómo verificarla).

curl -X PUT https://api.kinapi.es/api/v1/webhook \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://tu-sistema.com/hooks/kinapi","events":["ses.confirmed","ses.error"]}'

Probar y depurar el webhook

La prueba envía una entrega real y te devuelve el resultado del intento (código HTTP, duración y el cuerpo que respondió tu servidor), sin esperar a que ocurra un evento. El historial guarda los intentos de los últimos 30 días.

curl -X POST https://api.kinapi.es/api/v1/webhook/test \
  -H "ocp-apim-subscription-key: TU_API_KEY"

Portal de facturación

Devuelve una URL de un solo uso al portal de Stripe, donde tu cuenta puede ver facturas y cambiar el método de pago. Caduca: pide una nueva cada vez, no la guardes.

Avisos por correo

Kinapi puede escribir al huésped para que haga su registro, y avisarte a ti cuando una reserva queda completa. Los dos vienen apagados, y a propósito: si tu PMS ya reparte el enlace dentro de su mensaje de bienvenida, encenderlos haría que el huésped reciba dos correos del mismo alojamiento diciendo lo mismo. Se activan en Configuración → Notificaciones, o por API con notifications.guestInvitations.

Si el enlace lo mandas tú —desde tu PMS, con la url que devuelve la API—, apaga la invitación y deja encendidos el recordatorio y el último aviso. Kinapi solo escribe a quien todavía no se ha registrado: quien rellene con tu enlace no recibe nada nuestro, y quien no, recibe el recordatorio y el último aviso.

Tus textos en los correos al huésped

Puedes cambiar el asunto, el titular y el texto de entrada de la invitación, el recordatorio y el último aviso, en cada idioma. Lo que no rellenes sale con el texto de Kinapi. En el panel está en Configuración → Notificaciones → Textos de los correos, con vista previa y envío de prueba; por API, en guestEmails de PATCH /settings.

curl -X PATCH https://api.kinapi.es/api/v1/settings \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{"guestEmails":{"reminder":{"es":{"subject":"{nombre}, te esperamos en {alojamiento}","body":"Aún nos faltan tus datos.\n\nSon dos minutos y llegas con todo hecho."},"en":null}}}'

Cuándo se manda la invitación. El plazo lo decides tú, pero conviene no irse a ninguno de los dos extremos. Muy pronto no funciona: quien recibe el correo tres semanas antes no tiene a mano los documentos de todos los viajeros, lo aparca y no vuelve — y además la reserva aún puede cambiar o anularse. El mismo día tampoco: el huésped está viajando, no lo abre, y esa noche el parte sale incompleto. El valor por defecto deja margen para que quepa el recordatorio y para que te dé tiempo a reaccionar si nadie contesta.

Como máximo salen tres correos por reserva, y dejan de salir en cuanto todos los huéspedes se han registrado. Si dos de ellos cayeran el mismo día, solo se manda uno.