Машинный перевод

Эта страница использует машинный перевод. При любых несоответствиях обращайтесь к английской документации.

Коллбэки

Crypto2B предоставляет возможность генерировать уведомления для системы клиента с информацией об операциях (например, депозиты, выводы, сервисные операции). Для этого используются коллбэки.

Настройка

Если клиент хочет использовать механизм коллбэков для отслеживания статуса обработки операций, необходимо настроить URL коллбэка в личном кабинете.

Затем, во время обработки криптоплатежей, Crypto2B будет отправлять уведомления в формате JSON на этот URL со всей необходимой информацией о транзакции.

Содержимое коллбэка

Коллбэки Crypto2B содержат всю важную информацию о транзакции:

• тип операции
• статус обработки
• валюта
• адрес
• сумма
• хеш блокчейн-транзакции
• количество подтверждений
• комиссия

и так далее

Примеры коллбэков

Депозит

{
  "data": {
    "type": "Deposit",
    "id": 123456,
    "status": "Success",
    "date": "2024-01-15T10:30:00Z",
    "clientDepositId": "client-deposit-001",
    "error": null,
    "instrument": {
      "currencyShortName": "USDT",
      "transportProtocol": "trc20"
    },
    "address": {
      "address": "TExampleDepositAddress1234567890abc",
      "tag": null,
      "foreignId": "user-12345",
      "senderAddress": "TExampleSenderAddress0987654321xyz"
    },
    "transaction": {
      "approach": "FullProcessing",
      "hash": "abc123def456abc123def456abc123def456abc123def456abc123def456abcd",
      "amount": 1000.50,
      "confirmations": 21,
      "amlRiskGrade": "Low"
    },
    "fees": [
      {
        "type": "Commercial",
        "currencyShortName": "USDT",
        "transportProtocol": "trc20",
        "amount": 5.00
      }
    ]
  }
}

Вывод

{
  "data": {
    "type": "Withdrawal",
    "id": 789012,
    "status": "Success",
    "date": "2024-01-15T14:45:00Z",
    "paymentOrderId": "withdrawal-order-001",
    "foreignId": "user-withdrawal-789",
    "error": null,
    "instrument": {
      "currencyShortName": "BTC",
      "transportProtocol": "btc"
    },
    "address": {
      "address": "bc1qexamplewithdrawaladdress000000000000000",
      "tag": null
    },
    "transaction": {
      "approach": "FullProcessing",
      "hash": "00000000000000000000abcdef1234567890abcdef1234567890abcdef123456",
      "amount": 0.05,
      "confirmations": 6,
      "amlRiskGrade": null
    },
    "fees": [
      {
        "type": "Commercial",
        "currencyShortName": "BTC",
        "transportProtocol": "btc",
        "amount": 0.0001
      },
      {
        "type": "Technical",
        "currencyShortName": "BTC",
        "transportProtocol": "btc",
        "amount": 0.00005
      }
    ]
  }
}

Сервисная операция

{
  "data": {
    "type": "Service",
    "id": 345678,
    "soType": "Collection",
    "status": "Success",
    "date": "2024-01-15T16:00:00Z",
    "error": null,
    "instrument": {
      "currencyShortName": "ETH",
      "transportProtocol": "erc20"
    },
    "sender": "0x0000000000000000000000000000000000000001",
    "recipient": "0x0000000000000000000000000000000000000002",
    "transaction": {
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "amount": 2.5,
      "confirmations": 35
    },
    "technicalFee": {
      "currencyShortName": "ETH",
      "transportProtocol": "erc20",
      "amount": 0.002
    }
  }
}

Описание полей

Поле	Описание
type	Тип операции: Deposit, Withdrawal, Service
id	Уникальный идентификатор операции в системе
status	Статус обработки операции
date	Дата и время операции (ISO 8601)
instrument	Информация о валюте и протоколе
address	Адрес транзакции и дополнительные параметры
transaction	Детали блокчейн-транзакции
fees	Массив комиссий (коммерческие, технические)
error	Сообщение об ошибке (если есть)

Поля, специфичные для депозита

Поле	Описание
clientDepositId	ID депозита в системе клиента
address.foreignId	Внешний идентификатор пользователя
address.senderAddress	Адрес отправителя

Поля, специфичные для вывода

Поле	Описание
paymentOrderId	ID платежного поручения
foreignId	Внешний идентификатор операции

Поля, специфичные для сервисной операции

Поле	Описание
soType	Тип сервисной операции (например, Collection)
sender	Адрес отправителя
recipient	Адрес получателя
technicalFee	Техническая комиссия за операцию

Важное замечание

Дедупликация

Обратите внимание, что из-за особенностей реализации один и тот же коллбэк иногда может быть отправлен несколько раз. Всегда отслеживайте идентификаторы транзакций, чтобы избежать двойного списания и подобных проблем.