1. Платежи
Solvr API для мерчанта
  • Как мерчанту подключить платежи
  • Вебхуки для мерчанта
  • API
    • Платежи
      • Создать платёж
        POST
      • Список платежей мерчанта
        GET
      • Один платёж
        GET
      • Отменить платёж
        POST
      • История статусов
        GET
    • Страница оплаты
      • Страница оплаты по id платежа
      • Страница оплаты по токену
    • Чеки
      • Список чеков и файлов по платежу
      • Приложить чек по ссылке
      • Загрузить файл подтверждения
    • Апелляции
      • Открыть спор по платежу
      • Список споров мерчанта
      • Один спор
    • Баланс
      • Баланс мерчанта
    • Schemas
      • PaymentMethod
      • PaymentType
      • PaymentStatus
      • CreatePayment
      • Payment
      • FormPage
      • StatusHistory
      • Receipt
      • Appeal
      • Balance
      • Error
  1. Платежи

Создать платёж

POST
/v1/payments
Создаёт приём денег от клиента (in) или выплату клиенту (out).
Номер заказа merchantTransactionId уникален внутри вашей платформы.
Если отправить тот же номер ещё раз, второй платёж не создаётся: вернётся уже существующий.
Если у первого ещё нет реквизита, повторная отправка попробует подобрать его снова.
Для приёма (in) в ответе обычно есть реквизиты, куда клиент должен заплатить,
и ссылка на страницу оплаты.
Для выплаты (out) платформа сначала удерживает сумму в USDT с баланса мерчанта.
По умолчанию, если денег не хватает, баланс уходит в минус.
Вебхук уйдёт, если вы передали webhookUrl в запросе или администратор задал его глобально при онбординге.
Переданный webhookUrl имеет приоритет над глобальным.

Request

Body Params application/jsonRequired

Examples

Responses

🟢201Created
application/json
Платёж создан или возвращён уже существующий с тем же номером заказа.
Bodyapplication/json

🟠401Unauthorized
🟠403Forbidden
🟠409
🟠422Parameter Error
🔴503Service Unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/payments' \
--header 'Content-Type: application/json' \
--data '{
    "type": "in",
    "amount": "1500",
    "currency": "RUB",
    "method": "sbp",
    "geo": "RU",
    "merchantTransactionId": "order-1001",
    "clientId": "user-42",
    "webhookUrl": "https://shop.example/hooks/solvr",
    "returnUrl": "https://shop.example/orders/1001",
    "payer": {
        "name": "Иван Иванов"
    }
}'
Response Response Example
201 - Success Example
{
    "id": "6f1c2a40-1b2e-4c3d-9a8b-0e7d6c5b4a39",
    "tenantId": "242953e7-de1b-497f-a7d4-a0402c0caf98",
    "merchantId": "8c1b0d2e-1111-4222-8333-444455556666",
    "type": "in",
    "status": "process",
    "amount": "1500",
    "currency": "RUB",
    "method": "sbp",
    "geo": "RU",
    "merchantTransactionId": "order-1001",
    "amountUsd": "16.04",
    "merchantRate": "93.5",
    "rail": "trader",
    "expiresAt": "2026-10-23T12:18:00Z",
    "webhookUrl": "https://shop.example/hooks/solvr",
    "returnUrl": "https://shop.example/orders/1001",
    "clientId": "user-42",
    "createdAt": "2026-10-23T11:48:00Z",
    "updatedAt": "2026-10-23T11:48:00Z",
    "requisiteDetails": {
        "phone_number": "79991234567",
        "owner_name": "Петр Петров",
        "bank_name": "Т-Банк",
        "country_name": "РФ"
    },
    "form": {
        "token": "frm_live_token",
        "url": "/v1/form/frm_live_token",
        "returnUrl": "https://shop.example/orders/1001",
        "expiresAt": "2026-10-23T12:18:00Z"
    }
}
Modified at 2026-10-23 12:01:18
Previous
Вебхуки для мерчанта
Next
Список платежей мерчанта
Built with