Organizações, aplicações e ambientes

Uma organização contém a tua equipa e a faturação; as aplicações contêm fluxos de trabalho e chaves de API, e cada uma é live ou sandbox. Perceber bem esta estrutura evita a maioria dos comportamentos confusos.

Escrito pelo suporte da Didit · Atualizado a 15 de setembro de 2026

#Os dois níveis

Organização é a tua conta. Contém:

• A tua equipa e as suas funções
• O teu saldo de faturação e as faturas
• O teu registo de auditoria
• Todas as tuas aplicações

Aplicação é um espaço de trabalho dentro da organização. Contém:

• Os seus próprios fluxos de trabalho
• A sua própria chave de API
• Os seus próprios destinos de webhook
• A sua própria política de retenção de dados
• Um modo: live ou sandbox

Muda entre aplicações a partir da lista pendente no topo da consola.

#Porque é que isto importa mais do que parece

Quase todos os relatórios do tipo "alterei isto e não aconteceu nada" resolvem-se nesta estrutura:

• Editaste um fluxo de trabalho na aplicação A enquanto as tuas sessões correm na aplicação B.
• Adicionaste um destino de webhook a uma aplicação e esperavas eventos de outra.
• Estás a chamar com uma chave de uma aplicação diferente do recurso a que te estás a dirigir, e a receber um 404 ou 403 para algo que claramente existe.

Antes de depurares qualquer outra coisa, confirma a aplicação. Consulta erros de API e o que significam.

#Live e sandbox são aplicações separadas

Não existe um interruptor de modo de teste dentro de uma aplicação em produção. O modo é escolhido por aplicação, por isso testar significa criar uma segunda aplicação em modo sandbox e usar a sua chave.

Essa separação é o objetivo: o tráfego de teste e os dados de produção nunca se misturam, e uma chave sandbox não consegue gastar créditos reais por acidente. Consulta testar em sandbox.

#Quantas aplicações deves ter?

No mínimo, uma live e uma sandbox. Além disso, divide por tudo o que precise da sua própria configuração ou do seu próprio isolamento:

• Por produto, quando produtos diferentes precisam de fluxos de trabalho diferentes e de endpoints de webhook diferentes.
• Por ambiente, se correres mais do que um ambiente de pré-produção.
• Por marca, se ofereceres 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 teu saldo, que é ao nível da organização. Todas as aplicações consomem os mesmos créditos.

#Criar aplicações adicionais

As aplicações adicionais são criadas na consola. Se a opção estiver em falta, ou precisares de criar uma através da API em vez da consola, isso é uma questão de permissão ao nível da conta que vale a pena perguntar ao suporte em vez de tentares contornar - especialmente para uma segunda aplicação em produção, onde a resposta pode depender do teu plano.

#Várias organizações

O e-mail de uma pessoa pertence a uma organização de cada vez, e não há forma de criar suborganizações ou subcontas sob a sua. Se serve vários clientes próprios, a estrutura suportada é uma aplicação por cliente dentro da sua única organização: cada aplicação tem os seus próprios fluxos, marca, chaves de API, resultados e relatórios de utilização, totalmente isolados dos restantes, enquanto a faturação fica ao nível da organização.

#Revender a Didit

Se quer incluir a Didit no seu próprio produto e cobrá-la aos seus clientes, isso é o modelo de revenda. Como funciona, nos termos que o suporte dá a todos os que perguntam:

• Crédito pré-pago. Uma compra inicial mínima de 5.000 USD, pré-paga, num acordo de um ano. O crédito nunca expira, fica ao nível da sua organização e é consumido por todos os clientes finais que trouxer, e inclui um desconto por volume que cresce com o montante.
• O painel é construído por si. Integra a API da Didit no seu próprio front-end e os seus clientes gerem aí os seus fluxos, marca e funções. A Didit não fornece uma cópia white label da Business Console; os ecrãs de verificação que os seus utilizadores finais veem podem levar a sua marca (veja white label), a consola não.
• A sua margem é sua. Define o preço que os seus clientes pagam. A Didit fatura-lhe por funcionalidade concluída aos preços unitários fixados pelo prazo do acordo.
• Não é um programa de parceiros locais. A Didit faz demonstrações, integração e suporte diretamente com os clientes e não procura parceiros de distribuição ou implementação.

Se preferir não gerir a revenda, use a opção de recomendação: na barra lateral da Business Console, abra Recomendações, aceite os termos do programa e partilhe a sua ligação. Ganha 10% de comissão sobre cada depósito em dinheiro que uma organização recomendada fizer, durante 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 nem de suporte. Pode construir e testar a sua integração no plano gratuito antes de se comprometer com qualquer uma das opções.

#Eliminar uma aplicação

Eliminar uma aplicação remove os seus fluxos de trabalho e configuração. Os seus dados de verificação seguem a política de retenção e as regras de eliminação desses dados, e não o ciclo de vida da aplicação - por isso, se o teu objetivo é apagar dados de clientes, elimina os dados explicitamente em vez de presumires que remover a aplicação o faz. Consulta eliminar sessões e dados pessoais.

#Tudo é atribuível

Cada chamada de API regista a que aplicação pertencia, no registo de auditoria, durante 365 dias. É isso que torna uma estrutura com várias aplicações auditável e não apenas organizada. Consulta usar os registos de auditoria.