Organizações, aplicações e ambientes

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.

#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
• 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.

#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.

#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), 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.
• 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.