API
Facturació fiable des del teu producte.
REST sobre JSON, permisos clars i idempotència perquè un reintent no creï una altra factura.
- 10 dies de prova
- Sense targeta
- Cancel·les quan vulguis
Integracions i formats 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ó i el que torna. Les capçaleres de la resposta són el contracte.
Idempotència
Cada reintent conserva una sola factura
Repeteix el mateix POST sense crear una altra factura. La clau d'idempotència retorna la primera resposta i protegeix la numeració fiscal.
- La primera resposta queda desada durant 24 hores.
- La mateixa clau amb un cos diferent s'atura amb un 409.
- L'accepten 158 de les 413 operacions: les que creen, modifiquen o esborren alguna cosa. Un UUID v7 per intent de negoci ja n'hi ha prou.
POST /v1/invoices
Idempotency-Key: 0192…1d4b
Sense la capçalera
- 201 CreatedF-2026-0184
Amb la capçalera
- 201 CreatedF-2026-0184
Límits
Quantes peticions hi caben
L'API i el servidor MCP van inclosos a tots els plans de pagament, sense cost per crida. Cada pla aporta capacitat per minut i per mes, que pots ampliar amb un boost sense canviar de pla.
Prova10 dies, sense webhooks
10per minut
100 al mes · 1 claus · 0 webhooks
Emprendedor
30per minut
5.000 al mes · 3 claus · 1 webhooks
Empresario
300per minut
50.000 al mes · 25 claus · 10 webhooks
Enterprise
A mida
Capacitat, claus i webhooks adaptats al volum acordat.
El comptador ve a cada resposta
X-RateLimit-Limit: 300 X-RateLimit-Remaining: 297 X-RateLimit-Reset: 1789381860
429 Too Many Requests Retry-After: 12
I en un 429, Retry-After amb els segons que cal esperar. Espera'ls. Per als 5xx, reintent amb espera creixent i una mica d'atzar, per no tornar tots alhora.
El minut és lliscant: es compten els últims 60 segons, no el minut del rellotge. Això treu el pic que s'escola just en canviar de minut.
Versionatge
El que pot aparèixer i el que no es mourà
Les versions són dates. Es fixen per petició amb una capçalera o d'una vegada en crear la clau; si no n'envies cap s'usa la de la clau i, si no en té, l'última. Ometre-la mai no és un error.
El que envies
POST /v1/invoices Factuarea-Version: 2026-06-01
El que torna
201 Created Factuarea-Version: 2026-06-01
La versió efectiva torna a cada resposta, així que sempre saps contra quina parles.
Pot aparèixer sense avisar
- Un camp nou en una resposta
- Un paràmetre opcional nou
- Un endpoint nou
- Un missatge d'error més clar
No passa dins de /v1
- Esborrar o reanomenar un camp
- Canviar el tipus d'un camp
- Canviar el codi d'estat d'una resposta
- Tornar obligatori un camp que era opcional
- 12 mesos
- convivint /v1 i /v2 el dia que arribi la segona
- 12 mesos
- com a mínim abans de retirar un endpoint marcat com a obsolet
- 24 mesos
- de vida garantida per al que integris avui contra /v1
Un detall que estalvia un ensurt: error.type està versionat i error.code no. Si vols ramificar per alguna cosa que no es mogui amb la versió, ramifica per code.
Superfície publicada
Una integració que encaixa amb el teu stack
El contracte OpenAPI, els SDK i el servidor MCP parteixen de la mateixa API. Les xifres es revisen contra la superfície publicada perquè puguis avaluar l'abast i el manteniment abans d'integrar.
- operacions API
- 413
- recursos
- 37
- eines MCP
- 391
- pàgines de documentació
- 797
Tecnologies i clients compatibles
TypeScript
PHP
OpenAPI
Stripe
Els logotips identifiquen tecnologies o clients compatibles; no impliquen una relació comercial ni un testimoni.
Dubtes
El que es pregunta en avaluar l'API
L'API i el servidor MCP van inclosos a tots els plans de pagament; no hi ha cap complement per comprar ni cost per crida. El pla de prova dura 10 dies i deixa 10 peticions per minut i 100 al mes, però no permet webhooks: la seva quota és zero.
La primera crida són cinc minuts
Una clau de proves, un POST i una factura registrada. Sense targeta i sense parlar amb ningú.