# Organizações, aplicações e ambientes Source: https://help.didit.me/pt-BR/account-organization/organizations-and-applications Updated: 2026-10-12 A organização guarda a equipe e o faturamento; cada aplicação guarda fluxos de trabalho e chaves de API, em Produção ou Sandbox. A estrutura evita confusão. **Organização** = sua equipe, seu saldo de faturamento, seu registro de auditoria. **Aplicação** = fluxos de trabalho, chaves de API, endpoints de webhook, política de retenção e produtos, em dois ambientes: **Produção** e **Sandbox**. A maioria dos problemas do tipo "minha mudança não teve efeito" é estar na aplicação errada, ou no ambiente errado. ## Os dois níveis **Organização** é a sua conta. Ela é dona de: - Sua equipe e as funções de cada um - Seu saldo de faturamento e suas faturas - Seu registro de auditoria - Todas as suas aplicações **Aplicação** é um espaço de trabalho dentro da organização. Ela é dona de: - Seus próprios fluxos de trabalho - Suas próprias chaves de API - Seus próprios endpoints de webhook - Sua própria política de retenção de dados - Seus próprios produtos, onde a ativação de produtos por aplicação já foi liberada. Veja [produtos e o que eles incluem](https://help.didit.me/pt-BR/account-organization/products) - Dois ambientes: **Produção** e **Sandbox** Troque de aplicação pelo **cartão da aplicação** no topo da barra lateral. A troca vale na hora. O mesmo menu abre **Configurações da aplicação** e **Criar aplicação**. ## Por que isso importa mais do que parece Quase todo relato de "eu mudei isso e nada aconteceu" se resolve nessa estrutura: - Você editou um fluxo de trabalho na aplicação A enquanto suas sessões rodam na aplicação B. - Você adicionou um endpoint de webhook a uma aplicação e esperava eventos de outra. - Você está olhando para **Sandbox** enquanto o seu tráfego roda em **Produção**, ou o contrário. - Você está chamando com uma chave de uma aplicação diferente do recurso que está acessando, e recebendo um 404 ou 403 para algo que claramente existe. Antes de depurar qualquer outra coisa, confirme a aplicação. Veja [erros da API e o que significam](https://help.didit.me/pt-BR/integration/api-errors). ## Produção e Sandbox são ambientes separados As aplicações novas ficam em **Produção**. Os testes acontecem em **Sandbox**: a aplicação de teste compartilhada da sua organização, com os seus próprios dados e as suas próprias chaves. Alterne entre os dois com o seletor **Produção** e **Sandbox**, abaixo do nome da aplicação na barra lateral. Verificações, chaves de API, webhooks e listas são separados em cada ambiente. A marca é compartilhada, e os fluxos de trabalho são criados uma vez e podem ser copiados entre os ambientes. Essa separação é o objetivo: o tráfego de teste e os dados de produção nunca se misturam, e uma chave de sandbox não pode gastar créditos reais por acidente. Veja [testando em sandbox](https://help.didit.me/pt-BR/getting-started/sandbox-and-testing). > **Tip:** Nomeie as aplicações de um jeito que você nunca vá confundi-las de relance - > `acme-onboarding` e `acme-payments` é melhor que "Aplicação" e "Aplicação (2)". > Guarde as chaves no seu gerenciador de segredos com nomes que incluam o ambiente, > e nunca deixe uma variável de ambiente valendo "seja lá qual chave estiver em uso". ## Quantas aplicações você deveria ter? A maioria das equipes começa com uma, que já te dá Produção e Sandbox. Além disso, divida por qualquer coisa que precise da sua própria configuração ou do seu próprio isolamento: - **Por produto**, quando produtos diferentes precisam de fluxos de trabalho e endpoints de webhook diferentes. - **Por ambiente de pré-produção**, se você precisa de mais do que o único Sandbox. - **Por marca**, se você presta verificação sob várias marcas com estilos diferentes. - **Por política de retenção**, já que a retenção é configurada por aplicação. O que não se divide por aplicação: o seu **saldo**, que é no nível da organização. Toda aplicação consome os mesmos créditos. ## Criando aplicações adicionais Abra o cartão da aplicação no topo da barra lateral e escolha **Criar aplicação**, depois informe o **Nome do aplicativo** (onde os produtos por aplicação já foram liberados, você também escolhe para que ela serve). Se a opção estiver ausente, ou se você precisar criar uma pela API em vez do console, isso é uma questão de permissão no nível da conta que vale a pena perguntar ao suporte em vez de contornar. ## Várias organizações Uma pessoa pode pertencer a várias organizações e alternar entre elas pelo menu da organização no topo da barra lateral, onde os convites pendentes também aparecem. Criar mais de uma organização por conta própria é algo limitado a contas de revenda (contate o suporte para habilitar), e **não há como criar suborganizações ou subcontas** sob a sua. Se você atende vários clientes próprios, a estrutura suportada é **uma aplicação por cliente dentro da sua única organização**: cada aplicação tem seus próprios fluxos, marca, chaves de API, resultados e relatórios de uso, totalmente isolados dos demais, enquanto a cobrança fica no nível da organização. ## Revender a Didit Se você quer embutir a Didit no seu próprio produto e cobrar dos seus clientes por isso, esse é o **modelo de revenda**. Como funciona, nos termos que o suporte dá a todo mundo que pergunta: - **Crédito pré-pago.** Uma compra inicial mínima de **US$ 5.000**, pré-paga, num acordo de um ano. O crédito nunca expira, fica no nível da sua organização e é consumido por todos os clientes finais que você trouxer, e traz um desconto por volume que cresce com o valor. - **O painel é você quem constrói.** Você integra a API da Didit no seu próprio front-end e seus clientes gerenciam ali seus fluxos, marca e papéis. A Didit **não** fornece uma cópia white label do Business Console; as telas de verificação que seus usuários finais veem podem levar sua marca (veja [white label](https://help.didit.me/pt-BR/workflows/white-label-and-custom-domain)), o console não. - **Sua margem é sua.** Você define o preço que seus clientes pagam. A Didit cobra de você por recurso concluído aos preços unitários fixados pelo prazo do acordo. - **Não é um programa de parceiros locais.** A Didit faz demonstrações, onboarding e suporte diretamente com os clientes e não busca parceiros de distribuição ou implementação. Se preferir não cuidar da revenda, use a opção de **indicação**: no Business Console, abra **Configurações → Indique e ganhe**, pegue seu link e compartilhe. Você ganha **10% de comissão sobre cada depósito em dinheiro que uma organização indicada fizer, por 36 meses** a partir do primeiro depósito dela, utilizável como crédito Didit ou pago por transferência bancária após o período de maturação, sem obrigações de entrega ou suporte. Você pode construir e testar sua integração no plano gratuito antes de se comprometer com qualquer um dos dois. ## Excluindo uma aplicação A exclusão definitiva de uma aplicação **ainda não está disponível**: **Configurações da aplicação** tem uma Zona de perigo, mas ela informa que a exclusão não está disponível e não exclui nada. Suas opções até lá: - **Pare de usá-la.** Renomeie-a (algo como `acme-old`) para que ninguém a escolha por engano, e revogue as chaves de API dela em **Desenvolvedores → Chaves de API**. - **Apague os dados de clientes dela.** Os dados de verificação seguem a política de retenção e as regras de exclusão daqueles dados, não o ciclo de vida da aplicação - exclua os dados explicitamente. Veja [excluindo sessões e dados pessoais](https://help.didit.me/pt-BR/data-privacy/delete-verification-data). - **Comece do zero.** O suporte pode excluir a **organização inteira** para que você crie uma nova - um último recurso, já que isso leva junto a equipe, o saldo e o histórico. ## Tudo é atribuível Toda alteração registra a qual aplicação ela pertencia, no registro de auditoria. É isso que torna uma estrutura com várias aplicações auditável, e não apenas organizada. Veja [como usar os registros de auditoria](https://help.didit.me/pt-BR/account-organization/audit-logs).