Este artículo explica cómo ofrecer facturación vinculada, que permite a tus clientes vincular su propia organización de Claude Console a tu aplicación. Nosotros les facturamos directamente y tú nunca tienes su clave de API.
La facturación vinculada está en versión beta.
Cómo funciona la facturación vinculada
Un cliente vincula su organización de Claude Console a tu plataforma usando OAuth en lugar de pegar una clave de API. Tu plataforma guarda un ID de conexión, no una clave. Ejecutas Claude para el cliente y nosotros le facturamos directamente.
Qué cubre la facturación vinculada
La facturación vinculada cubre los puntos finales /v1/messages y /v1/chat/completions. Tú eliges quién paga en cada solicitud: el cliente o tú.
La API de Message Batches y Claude Managed Agents aún no están cubiertos.
Las solicitudes pagadas por el cliente no pueden usar ejecución de código facturable. La API devuelve un error 400, así que envía esas solicitudes como pagadas por la plataforma.
Si solo algunas funciones facturan al cliente, dile cuáles son. No digas que todo el uso de Claude se factura a su organización a menos que sea así.
La facturación vinculada funciona solo para clientes cuya organización de Claude Console es facturada directamente por Anthropic.
Lo siguiente no se puede vincular:
Los clientes que obtienen Claude a través de un proveedor de nube, como Bedrock, Vertex AI o Foundry, no pueden vincular
Los planes de suscripción de Claude (Pro, Max, Ultra, Team y Enterprise) no se pueden vincular
Las organizaciones de Claude Console que pagan a través del mercado de AWS, Google Cloud o Azure no pueden usar facturación vinculada
Las solicitudes se ejecutan en la organización de tu plataforma, no en la del cliente. Solo la facturación va al cliente. La configuración en la organización del cliente, como listas de IP permitidas, claves de cifrado y retención de datos, no se aplica, y el contenido se maneja bajo el acuerdo de tu organización con Anthropic.
Todos tus clientes vinculados comparten los límites de velocidad, acceso a modelos y nivel de servicio de tu organización.
Migrar clientes desde claves de API
Puedes seguir ofreciendo claves de API de cliente junto con facturación vinculada y migrar clientes a tu propio ritmo.
Para migrar un cliente:
Sigue usando la clave de API del cliente hasta que hayas guardado su ID de conexión.
Marca las solicitudes del cliente como pagadas por el cliente.
Elimina la clave de API guardada y dile al cliente que lo hiciste.
Configurar facturación vinculada
Para configurar facturación vinculada:
Crea una aplicación OAuth en Claude Console.
En Lo que la aplicación puede hacer, selecciona «Facturar y vincular a organizaciones.»
Acepta los Términos de Facturación Vinculada cuando se te solicite.
En la pestaña Autenticación del cliente de la aplicación, configura la autenticación del cliente, una cuenta de servicio del operador y un espacio de trabajo predeterminado.
Añade un botón a tu aplicación que inicie la vinculación, como «Vincula tu organización de Claude.» Usa nuestras muestras de marca.
Crea un perfil de usuario para cada organización de cliente que vaya a pagar. Cada aplicación permite un perfil por organización de cliente y una organización de cliente por perfil.
En cada solicitud que el cliente deba pagar, envía el ID de perfil del cliente, el encabezado de facturación beta y
billing_policyconbill_toestablecido enuser_profile.Publica la aplicación cuando estés listo para los clientes.
Una aplicación nueva comienza en prueba. Solo los usuarios de prueba que enumeres (hasta 10) pueden vincularla, cada uno con un límite mensual de $50 o menos. A menos que tu organización tenga facturación por factura, verifiques el dominio de tu aplicación y Anthropic revise la aplicación antes de que esté en vivo.
Reglas de vinculación
Si la organización de un cliente ya está vinculada a tu aplicación a través de otro perfil, se rechaza el vínculo.
Un perfil que ya está vinculado a tu aplicación no se puede vincular a una segunda organización.
Para mover un vínculo, desvinculalo primero y luego vincula de nuevo.
No puedes vincular tu aplicación a la organización de Claude Console que la posee. Para probar la facturación vinculada como lo haría un cliente, usa una segunda organización de Claude Console que pueda vincular.
Usa el mismo ID de perfil de usuario para iniciar el vínculo y para hacer las solicitudes de ese cliente.
Una solicitud pagada por el cliente que nombra un perfil sin vínculo se rechaza con un error 403, incluso cuando la Console del cliente muestra tu plataforma como Vinculada.
Una solicitud pagada por el cliente que nombra otro de los perfiles de tus clientes se factura a ese cliente.
Para pagar por tu propio uso, envía solicitudes sin billing_policy.
Para los pasos completos y valores de encabezado, consulta la Documentación de la Plataforma Claude.
Lo que ven los clientes cuando vinculan
Cuando los clientes vinculan su organización:
Hacen clic en el botón que añadiste a tu aplicación, como «Vincula tu organización de Claude.»
Inician sesión en Claude. Si su correo electrónico pertenece a más de una organización, eligen una. Si aún no tienen una cuenta de Claude o una organización de Claude Console, pueden crearlas aquí, añadir créditos y luego volver para terminar la vinculación.
Leen cómo funciona la facturación y luego establecen un límite de gasto mensual para tu aplicación o continúan sin uno. Si tu aplicación aún está en prueba, deben establecer un límite de $50 o menos.
Ven una página de aprobación con el nombre de tu aplicación y lo que estás pidiendo. Dice que el uso se factura bajo los términos de facturación existentes de la organización.
Aprueban y vuelven a tu aplicación.
Solo un usuario con el rol Admin o Billing puede aprobar. Obtén más información sobre roles y permisos de Claude Console. Si alguien más intenta aprobar, los enviamos de vuelta a tu aplicación con un error de acceso denegado. Planifica una transferencia, como una forma de pasar la solicitud a un administrador.
Una aprobación cubre toda la organización. El vínculo pertenece a la organización, así que permanece activo si el aprobador se va. Cada organización puede tener un vínculo por aplicación.
Después de la aprobación, los miembros Admin y Billing del cliente generalmente reciben un correo electrónico que confirma el vínculo y otro si lo desvinculan.
Cómo los clientes administran un vínculo
Los clientes administran cada vínculo en la página Plataformas vinculadas en Claude Console. Pueden establecer un límite de gasto mensual para tu plataforma y desvincularse en cualquier momento. Vincula a esta página desde tu aplicación.
También puedes desvincularse de un cliente. Un Admin en tu organización hace esto en la página Perfiles de usuario. El cliente no recibe correo electrónico cuando lo desvinculan en la Console, así que díselo tú mismo. También puedes desvincularte de un cliente desde tu backend, y Anthropic generalmente les envía un correo electrónico cuando lo haces.
También puedes crear, listar y actualizar los perfiles de tus clientes con la API de Perfiles de Usuario.
Administrar clientes desvinculados
Anthropic no envía a tu aplicación una notificación cuando un cliente se desvincula. Te enteras cuando una solicitud pagada por el cliente para ese cliente se rechaza con un error 403, o desde el Estado del vínculo en tu página Perfiles de usuario en la Console. Un 403 también puede significar que el cliente no se puede facturar por otra razón.
Un estado Vinculado solo dice que el vínculo existe. Una solicitud aún puede ser rechazada, por ejemplo, cuando el cliente se queda sin crédito o ha alcanzado un límite de gasto.
Desvincularse generalmente detiene las nuevas llamadas en aproximadamente 10 segundos. Las llamadas ya en ejecución se terminan y se facturan al cliente. Muestra al cliente un mensaje claro y una forma de vincular de nuevo.
Administrar errores de facturación
Si un cliente no se puede facturar, rechazamos la solicitud. No te facturamos esa solicitud.
Si el cliente ha alcanzado su límite de gasto o Anthropic no puede facturarlo actualmente (por ejemplo, porque se quedó sin créditos o está suspendido), obtienes un error 402.
Si Anthropic no puede facturar al cliente por ninguna otra razón, obtienes un error 403.
Si Anthropic no puede confirmar en este momento si el cliente se puede facturar, es posible que obtengas un error 503. Reintentar con retroceso y no muestres un error al cliente.
Un 402 significa que el cliente tiene que actuar. Pídele que verifique sus límites y facturación en Claude Console.
Tú decides qué sucede después. Puedes pausar la función hasta que el cliente actúe, o puedes cubrir el uso tú mismo reenviando la solicitud como pagada por la plataforma. Si lo cubres, dile al cliente por cuánto tiempo.
Monitorear uso y gasto
Ves el uso de cada cliente y lo que te cuesta. Nunca ves lo que el cliente realmente paga.
Puedes monitorear el uso de cada cliente de dos formas:
En Claude Console: Selecciona un cliente en la página Perfiles de usuario para ver su uso. Tu gasto es solo lo que pagaste en nombre del cliente.
Con la API: Agrupa resultados por
user_profile_iden la API de Análisis de Uso y Costo, que está en beta. El punto final de uso devuelve tokens. En el punto final de costo,amountes tu costo antes de créditos, y es 0 para solicitudes que tu cliente paga.list_amountes el costo a precio de lista, sin importar quién pague.
Ambas vistas incluyen cada solicitud del cliente, sin importar quién pagó. Mantén tu propio registro de qué solicitudes fueron pagadas por el cliente. Los datos de la API generalmente se actualizan dentro de cuatro horas y pueden tardar hasta 24 horas.
Preguntas frecuentes
¿Pueden los clientes con requisitos de HIPAA, FERPA o CMEK vincular?
No durante la beta. Las solicitudes vinculadas se ejecutan en tu organización, así que el acuerdo de asociado comercial (BAA), las claves de cifrado y la configuración de retención del cliente, incluida la retención cero de datos, no se aplican. No vincules clientes que necesiten cobertura de HIPAA, FERPA o CMEK.
¿Qué créditos pueden pagar por el uso vinculado?
El uso vinculado se factura al saldo prepago o factura del cliente. Algunos créditos promocionales no se pueden usar.
Lo que puede pagar
Crédito que el cliente compró (su saldo prepago)
La factura del cliente, si se factura mensualmente
Correcciones de facturación de Anthropic
Créditos escritos en el acuerdo del cliente
Lo que no puede pagar
Créditos de registro limitados a productos específicos
Créditos de los programas de asociados, capital de riesgo e startups de Anthropic (aún estamos implementando esto)
Si nada en la cuenta del cliente puede pagar, sus solicitudes pueden ser rechazadas. Después de que el cliente añada fondos, la compra puede tardar algún tiempo en aplicarse. Podemos actualizar esta lista a medida que cambien nuestros programas de créditos.
