Pular para o conteúdo principal
POST
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
chain
string
obrigatório

Blockchain em que o depósito foi liquidado, por exemplo, ETH. É armazenado em minúsculas e comparado sem distinção entre maiúsculas e minúsculas com as entradas do seu catálogo de endereços de carteiras, portanto use o mesmo token de blockchain lá.

Maximum string length: 32
txid
string
obrigatório

Hash da transação on-chain. Desduplicado em conjunto com wallet_address.

Maximum string length: 128
wallet_address
string
obrigatório

A carteira de destino em que você recebeu o depósito. Um X-address XRP é dividido em seu endereço clássico e sua tag.

Maximum string length: 128
amount
string
obrigatório

Valor do depósito como string decimal, zero ou maior, com até 18 casas decimais.

currency
string
obrigatório

Ativo do depósito, por exemplo, "USDC".

Maximum string length: 16
originator_data
object

Dados do remetente fornecidos pelo VASP de envio, se conhecidos, como um objeto plano, por exemplo {"name": "..."}. A Didit lê dele name (ou full_name), first_name, last_name e vendor_data.

beneficiary_data
object

Dados do beneficiário (seu cliente), como um objeto simples, por exemplo {"name": "..."}. A Didit compara o nome com o holder_name da entrada correspondente do catálogo de endereços e define wallet_address e chain a partir da requisição.

originating_vasp
object

Descrição opcional da VASP remetente. Ela fica apenas nesta transferência (metadata.originating_vasp e a VASP remetente da transferência em GET /v3/travel-rule/transfers/); nunca cria, edita nem vincula uma entrada compartilhada do diretório de VASPs.

memo
string

Opcional. A destination tag ou memo do depósito em uma rede com memo: em um endereço de depósito compartilhado, é o que diferencia seus clientes, e a entrada do catálogo de endereços correspondente a esse memo é usada na correspondência. XRP: uma destination tag, um número inteiro de 0 a 4294967295 (um número JSON é aceito). XLM: um memo de texto de até 28 bytes, um ID de 64 bits ou um hash de 32 bytes em hexadecimal. EOS: até 256 bytes. ATOM: até 256 caracteres. HBAR: até 100 bytes. Carteiras Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin e Lightning não aceitam memo: informar um nelas retorna 400. Alias: destinationTag ou destination_tag.

Maximum string length: 256
utxo
object

Opcional, apenas para blockchains UTXO. As entradas e saídas da transação de depósito: a carteira do remetente é o originator_data.wallet_address declarado ou, na ausência dele, a maior entrada.

Resposta

Uma transferência para este txid e wallet_address já foi registrada; a existente é retornada sem alterações (created é false).

transaction_id
string<uuid>

UUID da transação na Didit para o depósito recebido.

txn_id
string

txn_id da transação de entrada: gerado pela Didit quando a Didit criou a transação, ou o seu próprio quando um depósito não reivindicado foi reutilizado.

created
boolean

true quando esta chamada registrou a transferência (HTTP 201); false quando já existia uma transferência para o mesmo txid e wallet_address (HTTP 200).

travel_rule
object

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

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