Для разработчиков
Ниже — как собирать ссылки на страницы магазина и какие query-параметры поддерживаются.
Ссылка на пополнение (`/wrubex`)
Параметры
- id — уникальный идентификатор заявки на вашей стороне. Строка до 128 символов; формат любой — hex, UUID, что угодно без управляющих символов. Передаётся при создании заказа и возвращается вам после оплаты тем же параметром id в return_url — по нему вы сопоставите наш заказ со своей записью.
- amount — сумма в рублях (целое или дробное число; допустима запятая как разделитель). На форме переводится в копейки. Учитываются только положительные значения.
- email — предзаполнение e-mail.
- phone — предзаполнение телефона (передавайте в закодированном виде, например %2B79001234567 для +7…).
- return_url — URL, куда пользователь может вернуться после успешной оплаты (кнопка в интерфейсе оплаты). Принимается относительный путь на этом сайте, начинающийся с / (не //…), либо внешний адрес по https:// на любом домене. Предварительно регистрировать домен не нужно. Всё остальное, включая http://, отбрасывается.
- code_param_name — имя GET-параметра, который будет добавлен к return_url вместе с кодом wRUBex после оплаты (значение кода приходит из заказа). Имя должно начинаться с латинской буквы и далее содержать только латиницу, цифры, _, -, .; длина до 128 символов. Если имя не проходит проверку или не задано, редирект идёт на return_url без добавления кода.
Возврат после оплаты
К return_url добавляются два параметра: код покупки под именем из code_param_name и ваш id, если он был передан. Каждый — независимо: если задан только id, он всё равно вернётся.
https://ваш-сайт/?id=8e479677b658297ea230ec75c6&code=XXXX-XXXX
Пример ссылки
/wrubex?id=8e479677b658297ea230ec75c6&amount=100.00&return_url=https%3A%2F%2Fexample.com%2F&code_param_name=code
Каталог (`/catalog`)
- search — строка поиска по каталогу.
- category — slug категории из API. Для раздела «Маркетплейсы и ритейл» в каталоге используется виртуальный slug wrubex (например /catalog?category=wrubex).
- wrubex — при значении 1 или true, если не заданы category и search, выполняется переход к каталогу с виртуальной категорией wRUBex.
Категория и товар
Страница категории: /category/{slug}
Карточка товара: /product/{slug}