Saltar para o conteúdo principal
POST
curl

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Corpo

application/json
beneficiary_wallet_address
string
obrigatório

O endereço de carteira de destino. O VASP de teste da Didit envia para este endereço, correspondendo-o com o seu livro de endereços de carteiras na blockchain do ativo. Uma carteira sem nenhuma entrada correspondente é aceite e a transação de entrada é registada como ON_HOLD.

scenario
enum<string>
padrão:accept

O que a Didit Test VASP declara que o beneficiário é. accept declara o próprio nome do titular; name_mismatch declara um nome com o qual nenhum titular concorda. A decisão em si é sempre sua.

Opções disponíveis:
accept,
name_mismatch
chain
string
padrão:ETH

Blockchain do ativo.

amount
string
padrão:1

Montante como uma string decimal.

currency
string
padrão:ETH

Código do ativo.

reference
string

Chave de idempotência opcional. Uma repetição com o mesmo valor devolve a transferência que a primeira chamada registou.

Resposta

A transferência de entrada foi registada e decidida. Uma repetição com a mesma reference devolve o mesmo corpo.

transaction_id
string<uuid>

UUID da transação Didit da transferência recebida.

txn_id
string

txn_id gerado pela Didit.

scenario
string

O cenário que foi executado.

travel_rule_status
string

O estado determinado pela decisão da sua própria aplicação.

detail
string

O motivo pelo qual a transferência foi resolvida para esse estado.

test_vasp
boolean

Sempre true: o remetente foi o Didit Test VASP.

travel_rule
object

Objeto completo de transferência devolvido pelos endpoints de confirmação de propriedade e de finalização/cancelamento. Enquanto a propriedade da carteira de uma transferência recebida não estiver confirmada, os campos originator_data e beneficiary_data da contraparte são devolvidos mascarados (a primeira letra de cada palavra é mantida; a carteira, a blockchain e o encaminhamento do VASP permanecem legíveis) e data_masked é true.

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