Stripe Connect en marca blanca

5 d'octubre de 2026 — els teus clients ja poden connectar el seu compte de Stripe a un NIF sense sortir del teu producte. Tu inicies la connexió des del teu servidor, la persona acaba a Stripe i Factuarea retorna el navegador a un host que tu has donat d'alta. El pas a pas és a Connectar Stripe en marca blanca.

• Operacions noves.
  • POST /v1/companies/{company}/connected-accounts/authorizations inicia la connexió d'un NIF i retorna l'enllaç de Stripe que cal obrir. Exigeix un return_url i un Idempotency-Key, amb el scope stripe_autoinvoicing:write.
  • GET /v1/accounts/{account}/connected-accounts/return-domains, POST sobre la mateixa ruta i DELETE …/return-domains/{return_domain} gestionen els hosts que el teu compte permet com a destinació del return_url.
• Codis nous. connect_return_url_not_allowed (422), connect_return_domain_already_exists (409), connect_return_domain_limit_reached (422) i connect_return_domain_not_found (404).
• Només live. Les tres operacions que escriuen necessiten una clau fact_live_, també per als comptes de proves que provisiona el teu compte. Una clau fact_test_ es rebutja abans d'escriure res.
• El return_url es comprova dues vegades. Ha de ser https i el seu host ha de coincidir exactament amb un dels teus dominis de retorn en iniciar, i es torna a comprovar contra la teva llista vigent quan la persona torna. Si has retirat el domini mentrestant, la persona aterra a l'aplicació de Factuarea i no al teu lloc.
• Què arriba a la redirecció. status, provider i authorization_id sempre; company_id, connected_account_id i account si hi ha èxit; error i error_subcode si hi ha error.
• Res del que existeix canvia. Les operacions de la família connected-accounts conserven la seva forma, i les noves no tenen tool MCP perquè el flux necessita una redirecció del navegador.