API
Facturación fiable desde tu producto.
REST sobre JSON, permisos claros e idempotencia para que un reintento no cree otra factura.
- 10 días de prueba
- Sin tarjeta
- Cancelas cuando quieras
Integraciones y formatos compatibles
WhatsApp
POST /v1/invoices Authorization: Bearer fact_test_… Idempotency-Key: 0192…1d4b Factuarea-Version: 2026-06-01
201 Created Factuarea-Version: 2026-06-01 Idempotent-Replayed: false X-RateLimit-Remaining: 297
Una petición y lo que vuelve. Las cabeceras de la respuesta son el contrato.
Idempotencia
Cada reintento conserva una sola factura
Repite el mismo POST sin crear otra factura. La clave de idempotencia devuelve la primera respuesta y protege la numeración fiscal.
- La primera respuesta queda guardada durante 24 horas.
- La misma clave con un cuerpo diferente se detiene con un 409.
- La aceptan 158 de las 413 operaciones: las que crean, modifican o borran algo. Un UUID v7 por intento de negocio basta.
POST /v1/invoices
Idempotency-Key: 0192…1d4b
Sin la cabecera
- 201 CreatedF-2026-0184
Con la cabecera
- 201 CreatedF-2026-0184
Límites
Cuántas peticiones caben
La API y el servidor MCP van incluidos en todos los planes de pago, sin coste por llamada. Cada plan aporta una capacidad por minuto y por mes, y puedes ampliarla con un boost sin cambiar de plan.
Prueba10 días, sin webhooks
10por minuto
100 al mes · 1 claves · 0 webhooks
Emprendedor
30por minuto
5.000 al mes · 3 claves · 1 webhooks
Empresario
300por minuto
50.000 al mes · 25 claves · 10 webhooks
Enterprise
A medida
Capacidad, claves y webhooks adaptados al volumen acordado.
El contador viene en cada respuesta
X-RateLimit-Limit: 300 X-RateLimit-Remaining: 297 X-RateLimit-Reset: 1789381860
429 Too Many Requests Retry-After: 12
Y en un 429, Retry-After con los segundos que hay que esperar. Espéralos. Para los 5xx, reintento con espera creciente y algo de azar, para no volver todos a la vez.
El minuto es deslizante: se cuentan los últimos 60 segundos, no el minuto del reloj. Eso quita el pico que se cuela justo al cambiar de minuto.
Versionado
Lo que puede aparecer y lo que no se va a mover
Las versiones son fechas. Se fijan por petición con una cabecera o de una vez al crear la clave; si no mandas ninguna se usa la de la clave y, en su defecto, la última. Omitirla nunca es un error.
Lo que envías
POST /v1/invoices Factuarea-Version: 2026-06-01
Lo que vuelve
201 Created Factuarea-Version: 2026-06-01
La versión efectiva vuelve en cada respuesta, así que siempre sabes contra cuál estás hablando.
Puede aparecer sin avisar
- Un campo nuevo en una respuesta
- Un parámetro opcional nuevo
- Un endpoint nuevo
- Un mensaje de error más claro
No pasa dentro de /v1
- Borrar o renombrar un campo
- Cambiar el tipo de un campo
- Cambiar el código de estado de una respuesta
- Volver obligatorio un campo que era opcional
- 12 meses
- conviviendo /v1 y /v2 el día que llegue el segundo
- 12 meses
- como mínimo antes de retirar un endpoint marcado como obsoleto
- 24 meses
- de vida garantizada para lo que integres hoy contra /v1
Un detalle que ahorra un susto: error.type está versionado y error.code no. Si quieres ramificar por algo que no se mueva con la versión, ramifica por code.
Superficie publicada
Una integración que encaja con tu stack
El contrato OpenAPI, los SDK y el servidor MCP parten de la misma API. Las cifras se revisan contra la superficie publicada para que puedas evaluar alcance y mantenimiento antes de integrar.
- operaciones API
- 413
- recursos
- 37
- herramientas MCP
- 391
- páginas de documentación
- 797
Tecnologías y clientes compatibles
TypeScript
PHP
OpenAPI
Stripe
Los logotipos identifican tecnologías o clientes compatibles; no implican una relación comercial ni un testimonio.
Dudas
Lo que se pregunta al evaluar la API
La API y el servidor MCP van incluidos en todos los planes de pago; no hay complemento que comprar ni coste por llamada. El plan de prueba dura 10 días y deja 10 peticiones por minuto y 100 al mes, pero no permite webhooks: su cupo es cero.
La primera llamada son cinco minutos
Una clave de pruebas, un POST y una factura registrada. Sin tarjeta y sin hablar con nadie.