Skip to main content
O Infi provisiona um tenant claimable na hora — com produto seed e sk_test_* e pk_test_* — antes de você fazer login. Depois você reivindica (claim) e vira dono. É o fluxo que Cursor, Lovable e a CLI usam.
Sandbox → claim. “Sandbox” no dia a dia = tenant claimable com chave de teste. A API e a CLI usam o vocabulário claim / claimable (POST /public/v1/claimables, infi claim create). Como pegar a chave está em início rápido.

​
O que é provisionado

Uma chamada de provisionamento prepara:

Tenant anônimo

Slug aleatório (app-ec62ff27), pronto pra claim.

App + catálogo seed

Produto de exemplo, não pronto pra vender: versão 1 em draft e sem meter.

Chave sk_test_*

Retornada uma única vez, no corpo da resposta. Guarde com cuidado.

Chave pk_test_*

Chave publicável, segura para o navegador. Reservada: hoje nenhuma rota a aceita, então não construa em cima dela. A sk_test_* fica no servidor.

claimUrl

https://app-sandbox.beinfi.com/claim/{id} — você abre e faz login.
O endpoint público não aceita intent. intent (crm, prepaid-ai-chat, one-time, usage-saas) é conceito da CLI e do company file. Mandar {"intent":"…"} pro /public/v1/claimables responde 422 unrecognized field. Pra escolher a forma do catálogo, declare em company as code — ou crie os produtos direto pelo catálogo.

​
Ciclo de vida

Pra conferir o estado sem chave:
Finalize dentro do prazo. O prazo padrão é de 30 dias. Use o expiresAt retornado pela API e faça o claim antes dessa data para manter a conta e as chaves.

​
Conta preparada e email de claim

O agente pode coletar email e nome do app antes de provisionar. accountName preenche o nome da conta; email é um contato ainda não verificado. O login durante o claim confirma a identidade de quem assume a conta. Com a atualização de email de claim, o provisionamento com endereço enfileira um aviso com nome, link e prazo. O envio acontece em segundo plano, sem incluir as chaves. Há novas tentativas em caso de falha e um limite de um aviso por endereço a cada 24 horas. Contas já assumidas ou expiradas são ignoradas antes do envio. Continue a integração com as credenciais retornadas. O agente entrega a claimUrl na conversa mesmo quando há email: 201 confirma a criação, não a entrega do aviso. Não crie outra conta para tentar reenviar. Veja o cadastro pelo agente para o passo a passo.

​
Fluxo

  1. Provisiona — curl (ou CLI/MCP) devolve claimUrl, expiresAt, sk_test_* e pk_test_*.
  2. Catálogo — crie e publique o seu produto: catálogo.
  3. Cobre — link de pagamento ou checkout(), e confirme o pagamento por webhook/polling.
  4. Claim — abra a claimUrl da conversa ou do email, faça login e revise o nome. Produtos, chaves e slug são preservados.
  5. Go-live — KYC humano do provedor e sk_live_. Nunca pule KYC.

​
signup_source

A origem do provisionamento vira o signup_source do tenant — é o ref que você manda no provisionamento (lovable, cursor, bolt, claude, cli, web, mcp):
Veio do Lovable? Veja o guia de integração com Lovable.