Перейти к основному содержанию
POST
curl

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Тело

application/json
chain
string
обязательно

Блокчейн, в котором был обработан депозит, например ETH. Сохраняется в нижнем регистре и сравнивается без учёта регистра с записями в адресной книге ваших кошельков, поэтому используйте там тот же token блокчейна.

Maximum string length: 32
txid
string
обязательно

Ончейн-хеш транзакции. Дедуплицируется вместе с wallet_address.

Maximum string length: 128
wallet_address
string
обязательно

Кошелёк назначения, на который вы получили депозит. XRP X-address разделяется на классический адрес и тег.

Maximum string length: 128
amount
string
обязательно

Сумма депозита в виде десятичной строки, ноль или больше, до 18 знаков после запятой.

currency
string
обязательно

Актив депозита, например, "USDC".

Maximum string length: 16
originator_data
object

Данные об отправителе от отправляющего VASP, если они известны, в виде плоского объекта, такого как {"name": "..."}. Didit считывает из него name (или full_name), first_name, last_name и vendor_data.

beneficiary_data
object

Данные получателя (вашего клиента) в виде плоского объекта, например {"name": "..."}. Didit сопоставляет имя с holder_name соответствующей записи адресной книги и устанавливает wallet_address и chain из запроса.

originating_vasp
object

Необязательное описание отправляющего VASP. Оно остаётся только в этом переводе (metadata.originating_vasp и VASP отправителя перевода в GET /v3/travel-rule/transfers/); оно никогда не создаёт, не редактирует и не связывает общую запись в справочнике VASP.

memo
string

Необязательно. Тег назначения (destination tag) или memo депозита в сети с поддержкой memo: на общем адресе депозита он позволяет различать ваших клиентов, и запись в адресной книге для этого memo сопоставляется. XRP: destination tag, целое число от 0 до 4294967295 (принимается число JSON). XLM: текстовое memo длиной до 28 байт, 64-битный идентификатор или 32-байтный хэш в шестнадцатеричном формате. EOS: до 256 байт. ATOM: до 256 символов. HBAR: до 100 байт. Кошельки Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin и Lightning не принимают memo: его наличие возвращает 400. Псевдоним: destinationTag или destination_tag.

Maximum string length: 256
utxo
object

Необязательно, только для сетей UTXO. Входы и выходы транзакции депозита: кошельком отправителя является объявленный originator_data.wallet_address, иначе наибольший вход.

Ответ

Перевод для этого txid и wallet_address уже был зарегистрирован; существующий перевод возвращён без изменений (created равно false).

transaction_id
string<uuid>

UUID транзакции Didit для входящего депозита.

txn_id
string

txn_id входящей транзакции: сгенерированный Didit, если транзакцию создала Didit, или ваш собственный, если был повторно использован невостребованный депозит.

created
boolean

true, если этот вызов зарегистрировал перевод (HTTP 201); false, если перевод с теми же txid и wallet_address уже существовал (HTTP 200).

travel_rule
object

Полный объект перевода, возвращаемый endpoint’ами подтверждения владения и завершения/отмены. Пока владение кошельком для входящего перевода не подтверждено, данные контрагента originator_data и beneficiary_data возвращаются маскированными (сохраняется первая буква каждого слова; кошелёк, сеть и маршрутизация VASP остаются читаемыми), а флаг data_masked равен true.

Последнее изменение 7 ноября 2026 г.