Stripe Connect en marca blanca

5 de octubre de 2026 — tus clientes ya pueden conectar su cuenta de Stripe a un NIF sin salir de tu producto. Tú inicias la conexión desde tu servidor, la persona termina en Stripe y Factuarea devuelve el navegador a un host que tú has dado de alta. El paso a paso está en Conectar Stripe en marca blanca.

• Operaciones nuevas.
  • POST /v1/companies/{company}/connected-accounts/authorizations inicia la conexión de un NIF y devuelve el enlace de Stripe que hay que abrir. Exige un return_url y un Idempotency-Key, con el scope stripe_autoinvoicing:write.
  • GET /v1/accounts/{account}/connected-accounts/return-domains, POST sobre la misma ruta y DELETE …/return-domains/{return_domain} gestionan los hosts que tu cuenta permite como destino del return_url.
• Códigos nuevos. connect_return_url_not_allowed (422), connect_return_domain_already_exists (409), connect_return_domain_limit_reached (422) y connect_return_domain_not_found (404).
• Solo live. Las tres operaciones que escriben necesitan una clave fact_live_, también para las cuentas de pruebas que provisiona tu cuenta. Una clave fact_test_ se rechaza antes de escribir nada.
• El return_url se comprueba dos veces. Debe ser https y su host debe coincidir exactamente con uno de tus dominios de retorno al iniciar, y se vuelve a comprobar contra tu lista vigente cuando la persona regresa. Si retiraste el dominio entretanto, la persona aterriza en la aplicación de Factuarea y no en tu sitio.
• Qué llega en la redirección. status, provider y authorization_id siempre; company_id, connected_account_id y account si hay éxito; error y error_subcode si hay error.
• Nada de lo existente cambia. Las operaciones de la familia connected-accounts conservan su forma, y las nuevas no tienen tool MCP porque el flujo necesita una redirección del navegador.