Аутентификация
Все запросы к API требуют аутентификации через подпись запроса. Каждый запрос должен содержать:Базовая структура запроса
- Метод: POST
- Формат данных: JSON
- Кодировка: UTF-8
- Подпись: base64( ed25519_sign( data, PRIVATE_KEY ) )
Типы подписей
ED25519 (Рекомендуемый)
- Создать объект payload:
id, delivered_at, event - JSON.stringify(payload)
- Закодировать JSON-строку в Base64
- Подписать с помощью ED25519 (ed25519.signAsync)
- Закодировать подпись в Base64
Legacy (Устаревший)
- Создать объект payload:
id, delivered_at, event - JSON.stringify(payload)
- Закодировать JSON-строку в Base64
- SHA256 хеш (privateKey + data)
- Закодировать хеш в Base64
Внешняя ссылка для получения курсов
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 (Отменен, но недоплачен - Заказ просрочен/отклонён, но получена недоплата)
Ошибки
При возникновении ошибок в ответ будет возвращен список из кодов ошибок. Пример ответа с ошибкой:Список ошибок:
- 1000 - Неверный запрос
- 2010 - Ошибка декодирования данных
- 2011 - Ошибка декодирования подписи
- 2020 - Неверная подпись
- 3000 - Компания не найдена
- 3001 - Заказ не найден
- 3002 - Транзакция не найдена
- 4003 - Аккаунт не активирован
Crypto API
Основые запросы