Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõesINTERNAL, entre dois clientes da Didit, o Travel Rule Protocol aberto (TRP) e EMAIL. Os quatro canais de rede (GTR, TRUST, VERIFYVASP, SYGNA) exigem que o lado remetente seja membro da respectiva rede.
Esta página explica o que cada trilho faz hoje, para que você saiba onde suas contrapartes podem ser alcançadas antes de depender de uma rota.
Status em resumo
“Funciona” significa que a Didit envia a troca e lê a resposta. “Implementado, ainda não comprovado em produção” significa que a Didit envia a troca e lê a resposta da rede, mas nenhuma troca por essa rede foi concluída ainda em uma rede em produção. Nenhum dos dois significa que uma determinada contraparte pode ser alcançada: isso depende da contraparte, e as
routes de cada VASP no diretório indicam quais trilhos sua aplicação pode usar com ela hoje.
EMAIL transporta apenas suas requisições de saída: a página de resposta é onde a contraparte responde a uma delas, e nenhuma VASP pode enviar uma transferência para você por e-mail.
Antes de contar com GTR, VerifyVASP, Sygna Bridge ou TRUST, vincule sua filiação e faça uma primeira troca com uma contraparte que você conhece.
Canais que não exigem associação
INTERNAL
As duas VASPs operam na Didit, então a transferência é liquidada dentro da plataforma, sem nenhuma chamada externa. O destinatário precisa ser um cliente ativo da Didit, com Travel Rule ativado, que comprovou o controle da carteira de destino com uma mensagem assinada ou um depósito de teste. Uma carteira autodeclarada, comprovada apenas por captura de tela ou não verificada não recebe nada. Veja Envio de uma transferência.TRP
A Didit fala o Travel Rule Protocol nativamente. Uma transferência segue porTRP quando inclui o travel address da contraparte, quando a entrada da carteira de destino no agenda de endereços armazena um, ou quando a contraparte é encontrada no diretório com um endpoint TRP verificado pelo diretório.
Toda troca TRP que não termina em uma única chamada precisa do host TRP público da Didit, aquele para o qual os travel addresses apontam:
- Envio. Uma contraparte que responde à sua consulta imediatamente, na própria resposta, conclui ou recusa a transferência. Uma contraparte que responde depois envia a resposta ao host TRP da Didit, então essa troca não pode ser concluída até que o host esteja ativo; a transferência fica aguardando e expira ao fim do prazo. A Didit envia a consulta uma única vez e não tenta novamente: quando o host TRP da contraparte não pode ser alcançado ou recusa a consulta, a transferência passa imediatamente para
COUNTERPARTY_VASP_NOT_REACHABLE, e você pode tentar novamente comaction: "resend". - Recebimento. Outras VASPs alcançam você pelo seu travel address nesse host, então nenhuma contraparte pode enviar uma consulta TRP para você até que ele esteja ativo.
Redes
Com a sua própria associação
Conecte a sua própria associação no Marketplace do console (categoria de redes da Travel Rule). Suas transferências passam a usar a sua própria identidade de rede, e uma associação conectada sempre tem precedência sobre a da Didit.
GTR, TRUST e VerifyVASP também aceitam, de forma opcional, um certificado de cliente para TLS mútuo, uma chave de cliente e um pacote de CA (PEM), para uma associação que use TLS mútuo ou uma CA privada.
- A Didit envia em segundo plano e tenta enviar novamente para uma rede que não responde ou que responde com uma falha temporária (sem resposta a tempo, falha de conexão, HTTP
408,429ou5xx): após 30 segundos e, em seguida, após 2, 10, 30 e 60 minutos. Após a sexta tentativa malsucedida, a transferência passa aCOUNTERPARTY_VASP_NOT_REACHABLE. Uma recusa, como outra resposta4xxou um redirecionamento, não é tentada novamente: a transferência passa aCOUNTERPARTY_VASP_NOT_REACHABLEimediatamente. - Uma transferência cuja resposta nunca chega aguarda em
AWAITING_COUNTERPARTYaté queconfirmation_timeout_hoursse esgote; em seguida, ela expira e aplica o seutimeout_outcome. - O recebimento de uma transferência que outro VASP envia a você pela GTR, pela VerifyVASP ou pelo Sygna Bridge ainda não está ativado: a Didit o ativa rede por rede e, até lá, essas redes não conseguem entregar uma transferência a você.
- Salvar uma associação retorna
400quando o código de participante é o próprio código da Didit nessa rede ou um código que outra aplicação já possui. - As requisições de rede levam as suas credenciais somente ao host da própria rede e nunca seguem um redirecionamento. O pacote de dados da TRUST vai para o beneficiário sem a sua chave de API, o seu ID de membro ou o seu certificado de cliente.
Pela associação da Didit
Quando a Didit tiver uma associação a uma rede, um cliente sem associação poderá acessar a rede como participante próprio na associação da Didit, com o código de participante que a rede lhe atribuir: as mensagens de saída indicam o seu código, nunca o da Didit. Isso é oferecido somente para GTR e Sygna Bridge. A TRUST admite apenas um VASP por vez e um VerifyVASP Enclave atende a um único VASP, então ambas só podem ser acessadas com a sua própria associação. A adesão tem três etapas: responder ao questionário de due diligence de rede da Didit, obter a aprovação da Didit e, em seguida, solicitar acesso à rede. A Didit registra você na rede, e o seu participante fica ativo assim que a rede lhe atribui um código. Esse fluxo ainda não está disponível. Até que esteja, salvar ou enviar o questionário e solicitar acesso a uma rede retornam403 com code: travel_rule_platform_networks_disabled, e GET /v3/travel-rule/networks/ informa platform_networks_enabled: false.
Como ler o status da sua aplicação
GET /v3/travel-rule/settings/ e GET /v3/travel-rule/networks/ retornam networks, com as chaves gtr, trust, verifyvasp e sygna. Cada entrada informa o que a rede pode fazer pela sua aplicação hoje:
mode resume o estado como own, didit, off ou unavailable. Sua própria associação é verificada primeiro, depois disabled_networks e, por fim, a associação da Didit. Hoje, uma rede mostra own_membership assim que você conecta sua própria associação. Caso contrário, GTR e Sygna Bridge mostram didit_onboarding (unavailable com sandbox_application em uma aplicação de sandbox), e TRUST e VerifyVASP mostram unavailable com own_membership_only, inclusive no sandbox.
Uma aplicação de sandbox nunca envia por uma rede, mesmo com sua própria associação conectada e mostrando own_membership: as transferências dela vão para o Didit Test VASP.
connected significa que a associação salva passou na validação local, não que tenha havido uma troca bem-sucedida. A primeira troca em produção comprova isso junto à rede.
O que muda quando uma rede entra em produção
Esta página, o status denetworks e todas as rotas do diretório mudam juntos. Nada muda na sua integração: uma transferência passa a ser roteada pela rede assim que sua aplicação tiver uma associação nela, na ordem de trilhos descrita em Como a Didit roteia uma troca.
Para solicitar acesso a uma rede que a Didit ainda não atende, use o cartão Solicitar acesso da rede no Marketplace. Cada solicitação mostra seu status (Aberto, Contatado, Em andamento, Produção ou Recusado) com a nota mais recente da Didit. Quando a Didit altera o status ou a nota, ela envia um e-mail ao colega de equipe que fez a solicitação, desde que ele ainda esteja na sua organização. Uma solicitação feita com uma chave de API não recebe e-mail, então acompanhe-a no Marketplace.
Próximos passos
Travel Rule
O ciclo de vida da troca, as configurações, as redes e a API /v3/.
Testar no sandbox
Teste cada resultado com o Didit Test VASP antes de entrar em produção.
Interoperabilidade
Os endpoints que VASPs de contraparte usam para se conectar a você.
Diretório
Encontre um VASP e as rotas que sua aplicação pode usar para esse VASP.