# Organizações, aplicações e ambientes

Source: https://help.didit.me/pt-PT/account-organization/organizations-and-applications
Updated: 2026-10-12

A organização reúne equipa e faturação; as aplicações contêm fluxos de trabalho e chaves de API, e cada uma é live ou sandbox. Perceber isto evita confusões.

**Organização** = a tua equipa, o teu saldo de faturação, o teu registo 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 "a minha alteração não teve efeito" é estar na aplicação
errada, ou no ambiente errado.

## 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
- As suas próprias chaves de API
- Os seus próprios endpoints de webhook
- A sua própria política de retenção de dados
- Os seus próprios produtos, onde a ativação de produtos por aplicação já foi disponibilizada. Consulta [os produtos e o que incluem](https://help.didit.me/pt-PT/account-organization/products)
- Dois ambientes: **Produção** e **Sandbox**

Muda de aplicação a partir do **cartão da aplicação** no topo da barra lateral. A mudança aplica-se de imediato. O mesmo menu abre **Definições da aplicação** e **Criar aplicação**.

## 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 endpoint de webhook a uma aplicação e esperavas eventos de outra.
- Estás a olhar para **Sandbox** enquanto o teu tráfego corre em **Produção**, ou o contrário.
- 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](https://help.didit.me/pt-PT/integration/api-errors).

## Produção e Sandbox são ambientes separados

As aplicações novas estão em **Produção**. Os testes fazem-se em **Sandbox**: a aplicação de teste partilhada da tua organização, com os seus próprios dados e as suas próprias chaves. Alterna entre elas com o seletor **Produção** e **Sandbox** por baixo do nome da aplicação na barra lateral.

As verificações, as chaves de API, os webhooks e as listas são separados em cada ambiente. A marca é partilhada, e os fluxos de trabalho são construídos uma vez e podem ser copiados entre ambientes. 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](https://help.didit.me/pt-PT/getting-started/sandbox-and-testing).

> **Tip:** Dá às aplicações nomes que nunca confundas ao primeiro olhar - `acme-onboarding`
> e `acme-payments` é melhor do que "Application" e "Application (2)". Guarda as
> chaves com nomes que incluam o ambiente no teu gestor de segredos, e nunca deixes
> que uma variável de ambiente contenha "seja qual for a chave atual".

## Quantas aplicações deves ter?

A maioria das equipas começa com uma, o que já te dá Produção e 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 de pré-produção**, se precisares de mais do que o único Sandbox.
- **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

Abre o cartão da aplicação no topo da barra lateral e escolhe **Criar aplicação**, depois introduz um **Nome da aplicação** (onde os produtos por aplicação já foram disponibilizados, escolhes também para que serve). 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.

## Várias organizações

Uma pessoa pode pertencer a várias organizações, e alterna entre elas a partir do menu da organização no topo da barra lateral, onde também aparecem os convites pendentes. Criares tu próprio mais do que uma organização está limitado a contas de revendedor (contacta o suporte para o ativar), e **não há forma de criar suborganizações ou subcontas** sob a tua. Se serves vários clientes teus, a estrutura suportada é **uma aplicação por cliente dentro da tua única organização**: cada aplicação tem os seus próprios fluxos de trabalho, marca, chaves de API, resultados e relatórios de utilização, totalmente isolados dos restantes, enquanto a faturação fica ao nível da tua organização.

## Revender a Didit

Se queres incluir a Didit no teu próprio produto e cobrá-la aos teus 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 tua organização e é consumido por todos os clientes finais que trouxeres, e inclui um desconto por volume que cresce com o montante.
- **O painel és tu que o constróis.** Integras a API da Didit no teu próprio front-end e os teus clientes gerem aí os seus fluxos de trabalho, marca e funções. A Didit **não** fornece uma cópia white label da Consola de Negócio; os ecrãs de verificação que os teus utilizadores finais veem podem levar a tua marca (consulta [white label](https://help.didit.me/pt-PT/workflows/white-label-and-custom-domain)), a consola não.
- **A tua margem é tua.** Defines o preço que os teus clientes pagam. A Didit fatura-te 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 preferires não gerir a revenda, usa antes a opção de **recomendação**: na Consola de Negócio, abre **Definições → Recomende e ganhe**, obtém o teu link e partilha-o. Ganhas **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. Podes construir e testar a tua integração no plano gratuito antes de te comprometeres com qualquer uma das opções.

## Eliminar uma aplicação

A eliminação definitiva de uma aplicação **ainda não está disponível**: **Definições da aplicação** tem uma Zona de perigo, mas indica que a eliminação está indisponível e não elimina nada. As tuas opções até lá:

- **Deixa de a usar.** Muda-lhe o nome (algo como `acme-old`) para que ninguém a escolha por engano, e revoga as suas chaves de API em **Programadores → Chaves de API**.
- **Apaga os dados dos clientes.** Os 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 - elimina os dados explicitamente. Consulta [eliminar sessões e dados pessoais](https://help.didit.me/pt-PT/data-privacy/delete-verification-data).
- **Começa de novo.** O suporte pode eliminar a **organização inteira** para poderes criar uma nova - um último recurso, já que leva consigo a equipa, o saldo e o histórico.

## Tudo é atribuível

Cada alteração regista a que aplicação pertencia, no registo de auditoria. É isso que torna uma estrutura com várias aplicações auditável e não apenas organizada. Consulta [usar os registos de auditoria](https://help.didit.me/pt-PT/account-organization/audit-logs).