Integrações

Uma integração é um canal do seu produto. Ela reúne as chaves, os domínios e os webhooks daquele canal.

Uma integração é um canal seu: um site de cadastro, um app, um ambiente de homologação. Ela reúne tudo que a verificação precisa para rodar nesse canal: as chaves de API, as origens autorizadas, os webhooks e a aparência.

Crie uma por canal. Assim uma credencial vazada não alcança os outros canais, e um ambiente de teste nunca dispara webhook em produção.

Criar uma integração

1. Abra Integrações

   No menu lateral, em Desenvolvedores, abra Integrações e clique em Criar integração.

2. Dê um nome que diga onde ela roda

   Checkout web, App iOS, Homologação. O nome pode ser alterado depois.

3. Escolha o ambiente

   Sandbox para testar, Produção para atender pessoas reais.

   O ambiente é definido na criação e não muda depois. Para ir para produção, você cria uma integração nova. Veja ir para produção.

4. Confirme

   A integração aparece na listagem com a coluna Ambiente preenchida.

As abas de uma integração

Aba	O que tem	Passo deste guia
Geral	nome e exclusão	esta página
Aparência	tema da jornada	esta página
Segurança → Chaves de API	as chaves que autenticam o seu servidor	4. Tokens
Segurança → Domínios Autorizados	onde a verificação pode abrir	5. Domínios
Segurança → Webhooks	os endpoints que recebem os eventos	6. Webhooks

Personalizar a aparência

Na aba Aparência, o tema ajusta a jornada para ela parecer parte do seu produto. O tema da integração vale para todos os fluxos dela; o tema de um fluxo sobrescreve esse padrão só naquele fluxo.

A verificação fixa o tema no momento em que é criada. Mudar o tema agora não altera a jornada de quem já está no meio dela.

Deletar uma integração

Na aba Geral, em Danger Zone.

Deletar revoga todas as chaves de API, remove os webhooks e apaga a personalização. As verificações já criadas continuam existindo, mas nada novo é criado por esta integração.

Próximo passo

4. Tokens

Crie a chave que autentica o seu servidor.