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

Аутентификация

Все запросы к API требуют аутентификации через подпись запроса. Каждый запрос должен содержать:
{
  {
  "data": "base64-encoded-json-string",
  "signature": "base64-encoded-signature"
  }
}

Базовая структура запроса

  • Метод: POST
  • Формат данных: JSON
  • Кодировка: UTF-8
  • Подпись: base64( ed25519_sign( data, PRIVATE_KEY ) )

Типы подписей

ED25519 (Рекомендуемый)

  1. Создать объект payload: id, delivered_at, event
  2. JSON.stringify(payload)
  3. Закодировать JSON-строку в Base64
  4. Подписать с помощью ED25519 (ed25519.signAsync)
  5. Закодировать подпись в Base64

Legacy (Устаревший)

  1. Создать объект payload: id, delivered_at, event
  2. JSON.stringify(payload)
  3. Закодировать JSON-строку в Base64
  4. SHA256 хеш (privateKey + data)
  5. Закодировать хеш в Base64
ВАЖНО: При интеграции через Box Exchanger, Premium Exchanger, Lara Script, iEX Exchanger используйте Legacy ключи

Внешняя ссылка для получения курсов

URL: https://rates.crypto-cash.world/api/v1/market/rates/export/xml URL: https://rates.crypto-cash.world/api/v1/market/rates/export/json

Статусы транзакций в ответах API

  • Queued (Очередь – В очереди на обработку)
  • New (Новая - Заказ создан, ожидается депозит)
  • Waiting (Ожидание - Подтверждение в блокчейне)
  • Paid (Оплачено - Депозит соответствует ожидаемой сумме)
  • Underpaid (Недоплата - Депозит меньше ожидаемой суммы)
  • Overpaid (Переплата - Депозит превышает ожидаемую сумму)
  • Canceled (Отменена - Транзакция отменена / ошибка)
  • CurrencyMismatch (Несоответствие валют - Внесена неверная криптовалюта)
  • CanceledButPaid (Отменен, но оплачен - Заказ просрочен/отклонён, но получен точный депозит)
  • CanceledButOverpaid (Отмененный, но переплаченный - Заказ просрочен/отклонён, но получена переплата)
  • CanceledButUnderpaid (Отменен, но недоплачен - Заказ просрочен/отклонён, но получена недоплата)

Ошибки

При возникновении ошибок в ответ будет возвращен список из кодов ошибок. Пример ответа с ошибкой:
{
  "errors": [1000]
}

Список ошибок:

  • 1000 - Неверный запрос
  • 2010 - Ошибка декодирования данных
  • 2011 - Ошибка декодирования подписи
  • 2020 - Неверная подпись
  • 3000 - Компания не найдена
  • 3001 - Заказ не найден
  • 3002 - Транзакция не найдена
  • 4003 - Аккаунт не активирован

Crypto API

Основые запросы