Open API

Когда выбирать

• Собственная платформа или нестандартный стек.
• Нужен полный контроль над UX до редиректа на брокера.
• Планируете генерацию SDK из OpenAPI-спецификации.

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

Серверные запросы выполняются с ключом партнёра (api_key) в заголовке:

Authorization: Bearer <ваш_api_key>
Content-Type: application/json

Базовый URL: https://ruswallet.ru/api/v1. Секретный ключ (api_secret) используется только для проверки подписи вебхуков — не передавайте его в браузер.

Быстрый старт

1. Получите api_key в личном кабинете партнёра.
2. Создайте заявку: POST /api/v1/applications.
3. Перенаправьте покупателя на customer_form_url или data.gateway_url из ответа.
4. Настройте вебхук для получения статусов заявки.

Пример запроса

curl -X POST 'https://ruswallet.ru/api/v1/applications' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "order_id": "SHOP-12345",
    "items": [
      {
        "title": "iPhone 15 Pro 256GB",
        "price": 119990,
        "quantity": 1,
        "type": "product"
      }
    ],
    "credit_type": "installment",
    "form_success_url": "https://shop.example.ru/order/12345/thanks",
    "form_cancel_url": "https://shop.example.ru/order/12345/cancel",
    "customer": {
      "phone": "9991234567",
      "first_name": "Иван",
      "last_name": "Иванов"
    }
  }'

Минимальный набор полей: order_id, items[], form_success_url. Поле credit_type — строка "credit" или "installment" (необязательно, по умолчанию "installment"). Блок customer можно опустить — тогда вернётся customer_form_url для двухфазного сценария.

Документация API

Интерактивная спецификация генерируется автоматически из кода (Scramble) и всегда синхронизирована с актуальными правилами валидации: