Разная информация¶

Чек-лист интеграции для поставщиков услуг¶

Для интеграции с платёжным шлюзом R1.pay ваша система должна реализовать:

Обязательные endpoints (на вашей стороне)¶

[ ] POST /account/check — проверка существования лицевого счёта
[ ] POST /account/add — уведомление о новом прикреплении счёта
[ ] POST /account/del — уведомление об удалении счёта

Отправка счетов (с вашей стороны в шлюз)¶

[ ] Реализовать клиент, вызывающий POST https://paygw.robstor.ru/api/v1/invoices/push
[ ] Форматировать счета по спецификации (account, period, date, calculated, amount)
[ ] Обрабатывать коды ответов и детали отклонённых счетов (rejected_invoices)
[ ] Реализовать логику повторов при неудачных отправках
[ ] Реализовать POST /ВАШ_ВЕБХУК_АДРЕС/invoices/status для приёма информации о статусе рассылки счетов
[ ] Использовать POST /api/v1/invoices/status для отслеживания статуса рассылки

Валидация данных¶

[ ] Проверять номера счетов (макс. 64 символа)
[ ] Форматировать периоды как целые числа YYYYMM (только валидные месяцы 01–12, год 2000–2050)
[ ] Форматировать даты как YYYY-MM-DD
[ ] Предотвращать дублирующиеся записи account+period в одном пакете

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

[ ] Получить мерчант-токен у администратора платформы
[ ] Включать заголовок R1-Token во все запросы к шлюзу
[ ] Проверять входящие заголовки R1-Token на своих endpoints

Примеры запросов¶

cURL — Проверка счёта (Account Check)¶

curl -X POST https://ваш-server/account/check \
  -H "Content-Type: application/json" \
  -d '{
    "account": "3494987",
    "phone": "79134441212"
  }'

cURL — Отправка счетов¶

curl -X POST https://paygw.robstor.ru/api/v1/invoices/push \
  -H "Content-Type: application/json" \
  -H "R1-Token: ваш_секретный_токен" \
  -d '{
    "invoices": [
      {
        "account": "3494987",
        "period": 202607,
        "date": "2026-07-01",
        "calculated": 500,
        "amount": 1500
      }
    ]
  }'

cURL — Проверка статуса загрузки¶

curl -X POST https://paygw.robstor.ru/api/v1/invoices/status \
  -H "Content-Type: application/json" \
  -H "R1-Token: ваш_секретный_токен" \
  -d '{
    "push_id": 12345
  }'

Устранение неполадок¶

Распространённые проблемы¶

Проблема	Причина	Решение
`Account not found` при отправке счетов	Счёт не зарегистрирован в базе платёжной системы. Не был добавлен через `/account/add`	Убедитесь, что счёт сначала проверен через `/account/check`, затем добавлен через `/account/add`
Весь пакет отклонён	Один или несколько счетов имеют ошибки валидации	Просмотрите массив `rejected_invoices` в ответе для определения проблемных записей
`Invalid authorization token`	Отсутствует или неверный заголовок `R1-Token`	Проверьте, что ваш мерчант-токен верен и включён во все запросы
Сервер недоступен	Ваш сервер не работает или файервол блокирует	Проверьте сетевое подключение и убедитесь, что ваши endpoints общедоступны

Поддержка¶

По вопросам интеграции или технической поддержки можно обращаться по адресу: dev@robstor.ru