Saltar al contenido
Fipeo

Fipeo para desarrolladores

Acceso anticipado. La API, los webhooks y el widget están apagados para la mayoría de las cuentas mientras los probamos con las primeras escuelas y agencias. Esta documentación es pública para que puedas planear tu integración: escríbenos a [email protected] y te lo encendemos.

La API de Fipeo permite a una escuela de idiomas o a una agencia conectar sus propias herramientas con Fipeo: su web, su CRM, su programa de reservas o de contabilidad, Zapier o Make. Es una API REST por HTTPS con JSON, y cada clave solo ve los datos de su organización. Los precios son siempre lo que paga el estudiante: las comisiones y los precios netos nunca salen de Fipeo.

Qué puedes hacer

AgenciasEscuelas
LeerLas escuelas con las que estás conectado, sus cursos con el precio para el estudiante, presupuestos, reservas y estudiantesTu bandeja de reservas
EscribirAñadir estudiantes a tu CRM desde tu web o tu app, con su consentimiento—
WebhooksReservas nuevas y cambiadas, presupuestos aceptados, estudiantes nuevos, mensajes nuevosReservas nuevas y cambiadas, mensajes nuevos
WidgetLos cursos de tus escuelas conectadas con precios en vivo; las solicitudes van a tu CRMTus cursos con precios en vivo; las solicitudes van a tu bandeja

Empieza en 5 minutos

  1. Crea una clave. Entra en Fipeo y abre Integraciones en el menú (el titular o un administrador de la agencia; en una escuela, su cuenta principal). En Claves de API, ponle un nombre, marca los permisos que necesita y pulsa Crear la clave. Cópiala ahora: empieza por fpk_ y solo se enseña una vez.
  2. Guárdala en secreto. Ponla en una variable de entorno de tu servidor (nunca en una página web, una app ni una URL): export FIPEO_KEY=fpk_…
  3. Haz tu primera llamada. /me no necesita ningún permiso y te dice de quién es la clave:
bash
curl https://fipeo.net/api/public/v1/me \
  -H "Authorization: Bearer $FIPEO_KEY"
200 OK
{
  "organization": { "type": "agency", "id": "a1111111-1111-4111-8111-111111111111" },
  "key": { "id": "0f0e0d0c-0b0a-4908-8706-050403020100", "name": "Zapier", "prefix": "fpk_Xy12Ab34", "expires_at": null },
  "scopes": ["students:read", "students:write"]
}
  1. Lee o escribe algo. Una agencia con students:write puede añadir un estudiante como si hubiera rellenado uno de sus formularios (se crea una oportunidad en el embudo y se avisa a tu equipo):
bash
curl https://fipeo.net/api/public/v1/students \
  -H "Authorization: Bearer $FIPEO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1d0c3e-9b2a-4d5f-8e7c-6b5a49382716" \
  -d '{
    "first_name": "Lucía",
    "last_name": "Pérez",
    "email": "[email protected]",
    "nationality": "AR",
    "consent_text": "I agree that Agencia Sol keeps my details to send me course offers.",
    "opportunity_title": "Dublin summer"
  }'
http
HTTP/1.1 201 Created
{ "id": "5d1c…", "result": "created", "opportunity_id": "9a7e…" }

Con catalog:read, busca los cursos de tus escuelas conectadas con el precio para un estudiante:

bash
curl "https://fipeo.net/api/public/v1/courses?city=Dublin&weeks=4&start=2027-07-05" \
  -H "Authorization: Bearer $FIPEO_KEY"
  1. Entérate cuando pase algo con los webhooks, y mira todas las rutas en la referencia de la API.

La especificación OpenAPI

Toda la API está descrita en un fichero OpenAPI 3.1: rutas, parámetros, respuestas, errores, permisos y webhooks. Impórtalo en Postman, Insomnia o Bruno, o genera un cliente con tu generador de OpenAPI favorito. Un test automático comprueba en cada cambio que el fichero coincide con la API real.

Conviene saber

  • URL base: https://fipeo.net/api/public/v1. Solo HTTPS.
  • Los importes son enteros en céntimos de currency (100000 EUR = 1.000,00 €). Las fechas van como YYYY-MM-DD y las fechas con hora en ISO 8601 y UTC (2026-11-11T10:00:00Z). Los estados son códigos estables en inglés (accepted, on_request…).
  • Límites: 120 peticiones por minuto y clave (30 de ellas de escritura). Cada respuesta dice cuántas te quedan (RateLimit-Remaining, RateLimit-Reset); si te pasas, 429 con Retry-After.
  • Las listas van por páginas: sigue next hasta que sea null. Repite un POST sin miedo con la misma Idempotency-Key.
  • Los errores llegan en JSON con un código error estable y un message en el idioma de tu petición (Accept-Language).
  • Lo que no es tuyo contesta 404, nunca «prohibido»: Fipeo no revela lo que es de otros.
  • Dudas: [email protected]. Problemas de seguridad: [email protected] (mira nuestra página de seguridad).

Integraciones

Fipeo ya se conecta con:

Pagos
Stripe · PayPal · Klarna
Exportación contable
Xero · QuickBooks · Sage 50 · DATEV · Holded · A3
CRM
HubSpot
API y automatización
REST API · OAuth 2.0 · Webhooks · Zapier · Make
Tu web
WordPress · Widget
Facturación (España)
Verifactu (AEAT)
Disponibles bajo petición
Moodle · Canvas · Google SSO · Microsoft SSO · TYPO3

Algunas aún están en acceso anticipado.

¿Usas una plataforma que no está en la lista?

Cuéntanos cuál y valoraremos integrarla.

Escríbenos a [email protected] con la plataforma y para qué la necesitas.