Обзор
Заявки на выплаты (direction: "out") позволяют отправлять USDT клиентам на их криптокошельки для возвратов, вывода средств или выплаты вознаграждений. При создании заявки система проверяет баланс мерчанта и создает задачу на выплату для трейдеров.
Время жизни: Заявка действительна 5 часов. После истечения средства возвращаются на баланс мерчанта.
Создание заявки
Endpoint для создания заявки на выплату:Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
internalId | string | Уникальный идентификатор заявки в вашей системе для защиты от дубликатов. Используется для идемпотентности - повторные запросы с тем же internalId вернут существующую заявку. Пример: "order-12345", "payment-uuid-123" |
direction | string | Направление платежа. Для выплат используйте "out". Допустимые значения: "in" (входящий), "out" (исходящий) |
amount | number | Сумма платежа в рублях (НЕ в копейках). Примеры: 1000 = 1000 RUB |
currency | string | Код валюты ISO 4217. Пока доступно: "RUB" |
paymentRequisites | object|string | Обязательно для выплат! Реквизиты получателя платежа (клиента). Можно передать как объект или JSON-строку. Обязательные поля: • fullName (string) - ФИО получателя• cardNumber (string) - номер карты ИЛИ phoneNumber (string) - телефон для СБППримеры: • Для карты: {"fullName": "Иван Иванов", "cardNumber": "1234567890123456"}• Для СБП: {"fullName": "Иван Иванов", "phoneNumber": "+79001234567"} |
paymentMethod | string | Обязательно для выплат! Метод платежа: "SBP" (Система быстрых платежей, рекомендуется), "TO_CARD" (перевод на карту) |
paymentOption | string | Обязательно для выплат! Банк для платежа (зависит от доступности реквизитов): "sberbank", "tinkoff", "alfa", "vtb", "raiffeisen" |
notificationUrl | string | URL для webhook уведомлений о смене статуса заявки. Требования: валидный HTTPS URL. Пример: "https://your-site.com/webhooks/meridian" |
notificationToken | string | Секретный токен для HMAC-SHA256 подписи webhook. Требования: 32-255 символов |
Пример запроса
Пример ответа
HTTP Status: 200 OKПоля ответа
| Поле | Тип | Описание |
|---|---|---|
id | string | Уникальный идентификатор заявки в системе Meridian. Используйте для проверки статуса через GET /api/v1/invoices/:id |
direction | string | Направление платежа: "out" (исходящий - выплата клиенту) |
status | string | Текущий статус заявки. Для direction="out": "new" (создана, ожидает трейдера), "processing" (трейдер взял в работу), "review" (ожидает проверки админом), "paid" (выплачена), "canceled" (отменена), "dispute" (открыт спор). Типичный путь: new → processing → review → paid |
amount | string | Сумма заявки в указанной валюте (строка для точности) |
currency | string | Код валюты: "RUB", "USD", "EUR", "USDT" |
paymentMethod | string | Метод платежа: "SBP" (Система быстрых платежей) или "TO_CARD" (перевод на карту) |
paymentOption | string | Выбранный банк для платежа (например, "sberbank", "tinkoff") |
dealRequisites | object | Объект с реквизитами получателя. Содержит fullName (ФИО) и либо cardNumber (номер карты) либо phoneNumber (телефон для СБП). Это реквизиты клиента, которому нужно выплатить средства |
dealRate | string | Курс обмена USDT/RUB на момент создания заявки |
newStatusExpiresAt | string | Время истечения заявки в статусе "new" (ISO 8601). Для OUT: истекает через 5 часов. После истечения средства возвращаются на баланс мерчанта |
transactionProofUrl | string (optional) | Presigned S3 URL для доступа к доказательству оплаты (скриншот/чек), загруженному трейдером. Присутствует только в статусах review и paid. URL действителен 14 дней |
rejectionReason | string (optional) | Причина отклонения выплаты администратором. Присутствует после отклонения - выплата возвращается в статус new для повторной обработки трейдером |
createdAt | string | Время создания заявки в формате ISO 8601 |
updatedAt | string | Время последнего обновления заявки в формате ISO 8601 |
internalId | string | Уникальный идентификатор заявки в вашей системе (тот же, что был передан при создании). Используйте для сопоставления с вашими внутренними записями |
merchantName | string | Отображаемое имя мерчанта (ваша организация) |