Pular para o conteúdo principal
PUT
curl

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json

Todos os campos são opcionais; o PUT aplica uma atualização parcial.

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

CONTAINS aceita um nome cujas palavras aparecem todas no outro.

Opções disponíveis:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
Intervalo obrigatório: x >= 1
timeout_outcome
enum<string>
Opções disponíveis:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

E-mail de contato de conformidade do seu perfil de VASP. A rede Didit só lista seu perfil depois que esse endereço é confirmado por meio de um link enviado por e-mail (POST /v3/travel-rule/settings/compliance-email/confirmation/); alterá-lo exige uma nova confirmação.

is_discoverable
boolean

Se o seu perfil de VASP pode ser listado na rede Didit: encontrado em GET /v3/travel-rule/vasps/ por outros clientes da Didit e acessado pelo rail INTERNAL. A listagem também exige uma aplicação de produção, a Travel Rule ativada, uma razão social e um e-mail de conformidade confirmado; didit_network indica quais deles estão faltando. Padrão: true.

threshold_amount
string

String decimal, zero ou maior, na moeda padrão da sua aplicação. Valor mínimo de transferência que aciona uma troca gerenciada.

ownership_validation_mode
enum<string>

Veja o campo da resposta com o mesmo nome.

Opções disponíveis:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

String decimal, 0 ou mais.

data_sharing_fields
object

Mesclado por tipo de entidade: um tipo de entidade que você omitir mantém a escolha atual. Uma escolha que não atenda às obrigações relativas ao remetente do regime da sua jurisdiction (EU TFR ou Recomendação 16 do FATF), incluindo uma lista vazia, é recusada com 400.

matching_rules
object

Mesclado por tipo de entidade e, dentro dele, por campo. Um campo que esse tipo de entidade não compara (por exemplo, date_of_birth para company) é recusado com 400.

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

Quando verdadeiro, o widget de propriedade de carteira oferece o envio de captura de tela como método de evidência de propriedade. Padrão: verdadeiro.

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

Análise opcional de sanções e mídia adversa de VASPs contraparte, cobrada por análise ao preço da Análise AML de empresas. Quando ativada, a Didit analisa a contraparte alcançada por uma troca de saída (reutilizando uma análise com menos de 30 dias) e você pode analisar uma com POST /v3/travel-rule/vasps/{vasp_id}/screening/. Padrão false: nada é analisado nem cobrado.

sunrise_policy
enum<string>

HOLD, REJECT, PROCEED ou vazio para seguir timeout_outcome. Consulte o campo de resposta de mesmo nome.

Opções disponíveis:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD, REJECT, PROCEED ou vazio para seguir timeout_outcome. Consulte o campo de resposta de mesmo nome.

Opções disponíveis:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

Redes em que a associação da plataforma foi desativada (opt-out). Não desativa as suas próprias associações conectadas nem provisiona redes indisponíveis.

Opções disponíveis:
GTR,
TRUST,
VERIFYVASP,
SYGNA

Resposta

Configurações e perfil atualizados, no mesmo formato do GET.

is_enabled
boolean

Se o fluxo gerenciado de negociação da Travel Rule está ativo para transações travelRule de saída nesta aplicação.

jurisdiction
string

Código da jurisdição em que sua VASP opera. Padrão "EU". A Didit o associa ao regime que registra nas suas transações de Travel Rule como travel_rule_regime (por exemplo, EU ou o código de um Estado-membro da UE se torna eu), que as regras de transação podem usar como critério. Outros clientes da Didit o veem como sua jurisdição no diretório de VASPs assim que a rede Didit listar seu perfil.

Maximum string length: 8
name_matching_strictness
enum<string>

Com que rigor os nomes dos beneficiários devem corresponder antes que uma transferência possa chegar a COMPLETED. CONTAINS aceita um nome cujas palavras aparecem todas no outro.

Opções disponíveis:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

Horas que uma transferência AWAITING_COUNTERPARTY pode permanecer sem confirmação antes que o processo periódico de varredura a expire. Padrão: 48.

Intervalo obrigatório: x >= 1
timeout_outcome
enum<string>

O que acontece com a transação subjacente quando uma transferência expira. Padrão: HOLD. sunrise_policy e non_responsive_policy têm precedência quando se aplicam e estão definidas.

Opções disponíveis:
HOLD,
REJECT,
PROCEED
threshold_amount
string

String decimal, na moeda padrão da sua aplicação. Valor mínimo de transferência que aciona uma troca gerenciada; transferências abaixo dele são resolvidas diretamente como NOT_APPLICABLE. A Didit compara o valor da transação convertido para a sua moeda padrão, ou o amount_in_default_currency que você envia; quando nenhum valor convertido está disponível, o limiar não se aplica. O padrão é "0.00" (o EU TFR não aplica valor mínimo).

ownership_validation_mode
enum<string>

Quanta comprovação a propriedade de uma carteira exige. FULL sempre exige uma comprovação (mensagem assinada, depósito de teste ou captura de tela revisada), nunca a palavra do usuário final. SIMPLIFIED aceita uma autodeclaração abaixo de simplified_validation_threshold e uma comprovação acima dele. AUTOMATED permite que o catálogo de endereços e as comprovações anteriores respondam por conta própria, incluindo autodeclarações enquanto allow_self_declaration for true. Padrão AUTOMATED.

Opções disponíveis:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

String decimal, padrão "0.00". No modo SIMPLIFIED, uma transferência abaixo desse valor (na moeda do limiar) aceita uma autodeclaração. Uma transferência sem valor nessa moeda conta como acima dele.

data_sharing_fields
object

Os campos que a Didit envia à VASP contraparte sobre seus próprios usuários, por tipo de entidade. O name e o wallet_address são sempre enviados, independentemente do que a lista diga. Um tipo de entidade que você nunca escolheu compartilha todos os campos. Uma lista vazia também é uma escolha: ela compartilha apenas o nome e a carteira.

matching_rules
object

Com que rigor cada campo dos dados da contraparte é comparado com o que você possui, por tipo de entidade. Um campo que você omitir mantém o padrão. NONE ignora a comparação, STRICT exige exatamente as mesmas palavras, CONTAINS aceita um valor cujas palavras aparecem todas no outro, DEFAULT é a correspondência padrão por subconjunto e FUZZY aceita grafias próximas (e, para datas de nascimento, dia e mês invertidos).

Razão social do seu VASP. Obrigatório (não pode ficar em branco) para definir is_enabled como true.

lei
string

Seu Legal Entity Identifier, exibido no diretório de VASPs.

compliance_email
string<email>

E-mail de contato de conformidade do seu perfil de VASP. A rede Didit só lista seu perfil depois que esse endereço é confirmado por meio de um link enviado por e-mail (POST /v3/travel-rule/settings/compliance-email/confirmation/); alterá-lo exige uma nova confirmação.

is_discoverable
boolean

Se o seu perfil de VASP pode ser listado na rede Didit: encontrado em GET /v3/travel-rule/vasps/ por outros clientes da Didit e acessado pelo rail INTERNAL. A listagem também exige uma aplicação de produção, a Travel Rule ativada, uma razão social e um e-mail de conformidade confirmado; didit_network indica quais deles estão faltando. Padrão: true.

inbound_auto_accept
boolean

Quando verdadeiro, uma consulta TRP de entrada cuja carteira do beneficiário é uma entrada verificada do catálogo de endereços com nome correspondente é aprovada automaticamente. Quando falso, essa consulta fica em ON_HOLD até que você a aprove ou recuse com o endpoint de propriedade. Transferências pela via INTERNAL e após depósito não são afetadas. Padrão: verdadeiro.

allow_self_declaration
boolean

Quando verdadeiro, o widget de propriedade de carteira oferece a autodeclaração como método de prova alternativo. Padrão: verdadeiro.

allow_screenshot_proof
boolean

Quando verdadeiro, o widget de propriedade de carteira oferece o envio de captura de tela como método de evidência de propriedade. Padrão: verdadeiro.

auto_wallet_verification
boolean

Quando verdadeiro, o envio de uma transferência de saída da Travel Rule que exige prova de controle da carteira pelo usuário final cria automaticamente uma sessão do widget de propriedade de carteira vinculada à transação e a expõe no bloco action_required da transação. Padrão: verdadeiro.

vasp_attribution_enabled
boolean

Quando verdadeiro, uma transferência de saída da Travel Rule que nenhuma via consegue rotear é atribuída por meio de análise de blockchain: a carteira de destino é associada ao VASP que a controla, a entidade é registrada na transferência e no diretório de VASPs, e as vias são executadas novamente uma vez com o nome atribuído. Padrão: verdadeiro.

counterparty_screening_enabled
boolean

Análise opcional de sanções e mídia adversa de VASPs contraparte, cobrada por análise ao preço da Análise AML de empresas. Quando ativada, a Didit analisa a contraparte alcançada por uma troca de saída (reutilizando uma análise com menos de 30 dias) e você pode analisar uma com POST /v3/travel-rule/vasps/{vasp_id}/screening/. Padrão false: nada é analisado nem cobrado.

sunrise_policy
enum<string>

O efeito de uma transferência expirada sobre a sua transação quando a contraparte é uma entrada do diretório em uma jurisdição listada em sunrise_jurisdictions, que ainda não aplica a Travel Rule: HOLD a envia para revisão, REJECT a recusa, PROCEED mantém o status dela inalterado. Vazio (o padrão) segue timeout_outcome. Aplica-se antes de non_responsive_policy.

Opções disponíveis:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

Somente leitura. Os países (ISO 3166 alpha-2) que a Didit considera em período de sunrise da Travel Rule, nos quais sunrise_policy se aplica. Atualmente CO, KH e VN. Qualquer outra jurisdição, assim como uma vazia ou desconhecida, segue timeout_outcome.

non_responsive_policy
enum<string>

O efeito de uma transferência expirada sobre a sua transação quando a contraparte é uma entrada do diretório cuja responsividade é UNRESPONSIVE: HOLD, REJECT ou PROCEED, como em timeout_outcome. Vazio (o padrão) segue timeout_outcome. sunrise_policy se aplica primeiro quando ambas se encaixam.

Opções disponíveis:
,
HOLD,
REJECT,
PROCEED
travel_address
string

Somente leitura. O travel address do seu próprio VASP - o endpoint codificado de consultas TRP de entrada que outros VASPs usam para chegar até você. Vazio enquanto is_enabled for false.

disabled_networks
enum<string>[]

Redes em que a associação da plataforma foi desativada (opt-out). Não desativa as suas próprias associações conectadas nem provisiona redes indisponíveis.

Opções disponíveis:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

Por rede, como esta aplicação faria o envio e por que não consegue. Nenhuma rede, incluindo a GTR, é incluída por padrão: uma rede fica acessível por meio da sua própria associação conectada, ou por meio da associação da Didit assim que a associação da Didit a essa rede estiver ativa e o seu próprio participante nela estiver ativo. Não é uma verificação em tempo real de funcionamento ou de entrega.

didit_network
object
read-only

Se a rede Didit lista o seu perfil de VASP, para que outros clientes da Didit o encontrem no diretório e o alcancem pelo trilho INTERNAL, e cada condição que ainda não é atendida.

Última modificação em 1 de novembro de 2026