Процесс настройки проекта можно выделить в следующие 2 шага:

Отредактировать проект и указать webhook

Настроить токены для проекта (приема платежей)

Шаг №1: Редактирование проекта

Получение информации о проектах пользователя

При помощи данного запроса вы можете узнать информацию о ваших проектах Crypto Processing в виде массива с набором данных и их текущем состоянии.

Get Projects

Редактирование проекта и настройка Webhook

С помощью этого метода вы можете отредактировать основную информацию о проекте, также указать URL Webhook для получения уведомления об оплатах

💡

После каждого редактирования webhook, система отправляет в ответе метода новый secretKey, необходимый для подписи вебхука.

Edit Project

О webhook в проекте

Указываемый webhook позволяет получать информацию об оплате инвойсов. Webhook нужен, чтобы не опрашивать API слишком часто и быстрее узнавать об изменениях инвойса. Webhook отправляется при следующих событиях:

создание инвойса;

переход в состояние ожидания подтверждений;

успешная оплата;

REJECT - поступление грязного депозита;

возврат средств.

Подробно о WebHook

Webhook нужно считать уведомлением, а не единственным источником истины.

Рекомендуемый порядок:

получить webhook;

проверить подпись;

извлечь invoiceId;

запросить текущее состояние инвойса через API;

обновить свою систему.

Формат webhook payload

Webhook содержит три верхнеуровневых поля:

invoice

project

signature

Пример payload

{
  "invoice": {
    "invoiceId": "841ffcc4-a2b9-4c2d-b609-92d9d84706d3",
    "projectName": "MyProject",
    "projectUuid": "607a2147-5374-468f-93ce-88911e79afa1",
    "requestAmount": 20.00,
    "requestCoin": "AED",
    "paymentQuotes": [],
    "selectedAmount": null,
    "selectedPaymentQuote": "UNPAID",
    "cryptoProcessingDeposits": [],
    "timeToPayMinutes": 60,
    "createTime": "2026-03-18 16:02:56+03:00",
    "endTime": null,
    "autoConvertOrderId": null
  },
  "project": {
    "uuid": "607a2147-5374-468f-93ce-88911e79afa1",
    "projectOwnerId": 300000,
    "title": "MyProject",
    "link": "https://example.com"
  },
  "signature": "<calculated-signature>"
}

Проверка подписи webhook

Для проверки подлинности webhook используется алгоритм HMACSHA512

Подпись считается по строке:

projectUuid:{projectUuid};invoiceUuid:{invoiceId};address:{address};status:{status}

projectUuid — UUID проекта;

invoiceId — UUID инвойса;

address — адрес из selectedAmount.address, либо пустая строка, если selectedAmount ещё нет;

status — текущий статус инвойса

Ключ подписи

Используется secretKey проекта, получаемый при редактировании webhook в запросе POST /open/crypto-processing/projects/edit (см. выше)

secretKey — это hex-строка. Перед использованием её нужно декодировать из hex в бинарный ключ.

Примеры проверки подписи

Ниже представлен готовый код для проверки подписи на разных языках:

Python

Java

JavaScript (Node.js)

Практические рекомендации по работе с webhook:

Сразу после создания проекта настройте webhook.

Сразу сохраните secretKey после изменения webhook.

Не считайте оплату успешной, пока invoice.status не стал SUCCESS.

Используйте webhook для уведомлений, но подтверждайте статус через API.

Шаг №2. Настройка токенов для проекта

Получение информации о доступных токенах

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

Ответ содержит информацию о токенах, сетях, комиссиях и параметрах обработки.

Get Available Token Settings

Изменение настроек токенов

После создания проекта, к нему не подключен ни один из доступных на платформе токенов. С помощью методов ниже, вы можете подключить токен или отредактировать его параметры в проекте Crypto Processing:

Создание или изменение одного токена:
Update Project Token Settings

Создание или изменение нескольких токенов:
Batch Update Project Token Settings

Получение текущих настроек токенов проекта

Позволяет определить, какие способы оплаты уже доступны в проекте и какие параметры применяются при обработке платежей.

Get Project Token Settings

Когда проект только что создан, этот метод может вернуть пустой массив. Это означает, что для проекта ещё не были выполнены настройки токенов.

Описания полей для настройки токенов

Для лучшего понимания части настроек, ниже вы увидите описание и объяснение части из них:

autoConvertMode

Данная настройка позволяет автоматически конвертировать принятые токены в любую из доступных валют в случае успешной оплаты инвойса

Пример:

у проекта для LTC_LTC стоит autoConvertMode = USDT;

покупатель оплатил инвойс в LTC;

после успешного завершения инвойса LTC автоматически продаются и конвертируются в USDT.

Если стоит NONE, автоконвертация не выполняется и оплата придет на баланс токена

discountPercent

Настройка позволяет корректировать сумму после пересчёта суммы инвойса в платёжный токен.

Пример:

инвойс: 1000 RUB;

после конвертации это 12 USDT;

если discountPercent = 10, итоговая сумма уменьшится на 10%, то есть до 10.8 USDT.

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

projectPayFee

Настройка позволяет определить, кто оплачивает комиссию Rapira за проведение операции.

Пояснение:

если false, комиссия добавляется сверху к сумме оплаты;

если true, комиссия вычитается из суммы, которую получает проект.

Это полезно, если вы хотите выставить инвойс на фиксированную сумму для пользователя и взять комиссию на себя.

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

Работа с инвойсами

Настройка проекта

Шаг №1: Редактирование проекта#

Получение информации о проектах пользователя#

Редактирование проекта и настройка Webhook#

О webhook в проекте#

Шаг №2. Настройка токенов для проекта#

Получение информации о доступных токенах#

Изменение настроек токенов#

Получение текущих настроек токенов проекта#

Описания полей для настройки токенов#