Ir para conteúdo principal

Ofereça faturamento vinculado em sua plataforma

Este artigo explica como oferecer faturamento vinculado, que permite que seus clientes vinculem sua própria organização do Claude Console ao seu aplicativo. Nós os faturamos diretamente e você nunca mantém sua chave de API.

O faturamento vinculado está em beta.

Como funciona o faturamento vinculado

Um cliente vincula sua organização do Claude Console à sua plataforma usando OAuth em vez de colar uma chave de API. Sua plataforma mantém um ID de conexão, não uma chave. Você executa Claude para o cliente e nós o faturamos diretamente.

O que o faturamento vinculado cobre

O faturamento vinculado cobre os endpoints /v1/messages e /v1/chat/completions. Você escolhe quem paga em cada solicitação: o cliente ou você.

A API de Lotes de Mensagens e Agentes Gerenciados do Claude ainda não são cobertos.

Solicitações pagas pelo cliente não podem usar execução de código faturável. A API retorna um erro 400, então envie essas solicitações como pagas pela plataforma.

Se apenas alguns recursos faturarem o cliente, informe aos clientes quais são. Não diga que todo uso do Claude é faturado para sua organização a menos que seja.

O faturamento vinculado funciona apenas para clientes cuja organização do Claude Console é faturada diretamente pela Anthropic.

O seguinte não pode ser vinculado:

  • Clientes que obtêm Claude através de um provedor de nuvem, como Bedrock, Vertex AI ou Foundry, não podem vincular

  • Planos de assinatura do Claude (Pro, Max, Ultra, Team e Enterprise) não podem ser vinculados

  • Organizações do Claude Console que pagam através do marketplace AWS, Google Cloud ou Azure não podem usar faturamento vinculado

As solicitações são executadas na organização de sua plataforma, não na do cliente. Apenas o faturamento vai para o cliente. As configurações na organização do cliente, como listas de permissão de IP, chaves de criptografia e retenção de dados, não se aplicam, e o conteúdo é tratado sob o acordo de sua organização com a Anthropic.

Todos os seus clientes vinculados compartilham os limites de taxa, acesso a modelos e nível de serviço de sua organização.

Migre clientes de chaves de API

Você pode continuar oferecendo chaves de API de cliente junto com faturamento vinculado e migrar clientes no seu próprio ritmo.

Para migrar um cliente:

  1. Continue usando a chave de API do cliente até ter armazenado seu ID de conexão.

  2. Marque as solicitações do cliente como pagas pelo cliente.

  3. Exclua a chave de API armazenada e informe ao cliente que você fez isso.

Configure o faturamento vinculado

Para configurar o faturamento vinculado:

  1. Crie um aplicativo OAuth no Claude Console.

  2. Em O que o aplicativo pode fazer, selecione “Faturar e vincular a organizações.”

  3. Aceite os Termos de Faturamento Vinculado quando solicitado.

  4. Na guia Autenticação do cliente do aplicativo, configure autenticação do cliente, uma conta de serviço do operador e um espaço de trabalho padrão.

  5. Adicione um botão ao seu aplicativo que inicie a vinculação, como “Vincule sua organização do Claude.” Use nossas amostras de marca.

  6. Crie um perfil de usuário para cada organização de cliente que pagará. Cada aplicativo permite um perfil por organização de cliente e uma organização de cliente por perfil.

  7. Em cada solicitação que o cliente deve pagar, envie o ID de perfil do cliente, o cabeçalho beta de faturamento e billing_policy com bill_to definido como user_profile.

  8. Publique o aplicativo quando estiver pronto para clientes.

Um novo aplicativo começa em testes. Apenas os usuários de teste que você listar (até 10) podem vinculá-lo, cada um com um limite mensal de $50 ou menos. A menos que sua organização tenha faturamento por fatura, você verifique o domínio do seu aplicativo e a Anthropic revise o aplicativo antes de ele estar ativo.

Regras de vinculação

  • Se a organização de um cliente já está vinculada ao seu aplicativo através de outro perfil, a vinculação é recusada.

  • Um perfil que já está vinculado ao seu aplicativo não pode ser vinculado a uma segunda organização.

  • Para mover um link, desvinculá-lo primeiro e depois vincular novamente.

  • Você não pode vincular seu aplicativo à organização do Claude Console que o possui. Para testar o faturamento vinculado como um cliente faria, use uma segunda organização do Claude Console que possa vincular.

  • Use o mesmo ID de perfil de usuário para iniciar o link e fazer as solicitações desse cliente.

  • Uma solicitação paga pelo cliente que nomeia um perfil sem link é recusada com um erro 403, mesmo quando o Console do cliente mostra sua plataforma como Vinculada.

  • Uma solicitação paga pelo cliente que nomeia outro dos perfis de seus clientes é faturada para esse cliente.

Para pagar pelo seu próprio uso, envie solicitações sem billing_policy.

Para as etapas completas e valores de cabeçalho, consulte a Documentação da Plataforma Claude.

O que os clientes veem quando vinculam

Quando os clientes vinculam sua organização:

  1. Eles clicam no botão que você adicionou ao seu aplicativo, como “Vincule sua organização do Claude.”

  2. Eles entram no Claude. Se seu email pertence a mais de uma organização, eles escolhem uma. Se eles não têm uma conta Claude ou organização do Claude Console ainda, podem criá-las aqui, adicionar créditos e depois voltar para concluir a vinculação.

  3. Eles leem como funciona o faturamento e definem um limite de gastos mensais para seu aplicativo ou continuam sem um. Se seu aplicativo ainda está em testes, eles devem definir um limite de $50 ou menos.

  4. Eles veem uma página de aprovação com o nome do seu aplicativo e o que você está pedindo. Diz que o uso é faturado sob os termos de faturamento existentes da organização.

  5. Eles aprovam e retornam ao seu aplicativo.

Apenas um usuário com a função Admin ou Billing pode aprovar. Saiba mais sobre funções e permissões do Claude Console. Se alguém mais tentar aprovar, nós o enviamos de volta ao seu aplicativo com um erro de acesso negado. Planeje uma transferência, como uma forma de passar a solicitação para um administrador.

Uma aprovação cobre toda a organização. O link pertence à organização, então permanece ativo se o aprovador sair. Cada organização pode ter um link por aplicativo.

Após a aprovação, os membros Admin e Billing do cliente geralmente recebem um email que confirma o link e outro se desvincularem.

Como os clientes gerenciam um link

Os clientes gerenciam cada link na página Plataformas vinculadas no Claude Console. Eles podem definir um limite de gastos mensais para sua plataforma e desvinculá-la a qualquer momento. Vincule esta página do seu aplicativo.

Você também pode desvinculá-lo. Um Admin em sua organização faz isso na página Perfis de usuário. O cliente não recebe email quando você o desvincula no Console, então avise-o você mesmo. Você também pode desvinculá-lo do seu back-end, e a Anthropic geralmente o envia um email quando você faz isso.

Você também pode criar, listar e atualizar os perfis de seus clientes com a API de Perfis de Usuário.

Gerencie clientes desvinculados

A Anthropic não envia ao seu aplicativo uma notificação quando um cliente se desvincula. Você descobre quando uma solicitação paga pelo cliente para esse cliente é recusada com um erro 403, ou no Status do link na sua página Perfis de usuário no Console. Um 403 também pode significar que o cliente não pode ser faturado por outro motivo.

Um status Vinculado apenas diz que o link existe. Uma solicitação ainda pode ser recusada, por exemplo, quando o cliente está sem crédito ou atingiu um limite de gastos.

A desvinculação geralmente interrompe novas chamadas em cerca de 10 segundos. As chamadas já em execução terminam e são faturadas ao cliente. Mostre ao cliente uma mensagem clara e uma forma de vincular novamente.

Gerencie erros de faturamento

Se um cliente não puder ser faturado, recusamos a solicitação. Não o faturamos por essa solicitação.

  • Se o cliente atingiu seu limite de gastos ou a Anthropic não conseguir faturá-lo no momento (por exemplo, porque está sem crédito ou suspenso), você recebe um erro 402.

  • Se a Anthropic não conseguir faturar o cliente por qualquer outro motivo, você recebe um erro 403.

  • Se a Anthropic não conseguir confirmar agora se o cliente pode ser faturado, você pode receber um erro 503. Tente novamente com backoff e não mostre um erro ao cliente.

Um 402 significa que o cliente precisa agir. Peça-lhe que verifique seus limites e faturamento no Claude Console.

Você decide o que acontece a seguir. Você pode pausar o recurso até que o cliente aja, ou pode cobrir o uso você mesmo reenviando a solicitação como paga pela plataforma. Se você cobrir, informe ao cliente por quanto tempo.

Monitore uso e gastos

Você vê o uso de cada cliente e quanto custa para você. Você nunca vê o que o cliente realmente paga.

Você pode monitorar o uso de cada cliente de duas maneiras:

  • No Claude Console: Selecione um cliente na página Perfis de usuário para ver seu uso. Seus gastos são apenas o que você pagou em nome do cliente.

  • Com a API: Agrupe resultados por user_profile_id na API de Análise de Uso e Custo, que está em beta. O endpoint de uso retorna tokens. No endpoint de custo, amount é seu custo antes de créditos, e é 0 para solicitações que seu cliente paga. list_amount é o custo ao preço de tabela, quem quer que pague.

Ambas as visualizações incluem cada solicitação do cliente, quem quer que tenha pago. Mantenha seu próprio registro de quais solicitações foram pagas pelo cliente. Os dados da API normalmente são atualizados em quatro horas e podem levar até 24 horas.

Perguntas frequentes

Clientes com requisitos HIPAA, FERPA ou CMEK podem vincular?

Não durante o beta. As solicitações vinculadas são executadas em sua organização, portanto o acordo de associado comercial (BAA), chaves de criptografia e configurações de retenção de um cliente, incluindo retenção zero de dados, não se aplicam. Não vincule clientes que precisam de cobertura HIPAA, FERPA ou CMEK.

Quais créditos podem pagar pelo uso vinculado?

O uso vinculado é faturado ao saldo pré-pago ou fatura do cliente. Alguns créditos promocionais não podem ser usados.

O que pode pagar

  • Crédito que o cliente comprou (seu saldo pré-pago)

  • A fatura do cliente, se for faturada mensalmente

  • Correções de faturamento da Anthropic

  • Créditos escritos no acordo do cliente

O que não pode pagar

Se nada na conta do cliente puder pagar, suas solicitações podem ser recusadas. Depois que o cliente adiciona fundos, a compra pode levar algum tempo para ser aplicada. Podemos atualizar esta lista conforme nossos programas de crédito mudam.

Isto respondeu à sua pergunta?