Для разработчиков

01

Ссылка на пополнение — /rubex

id

Идентификатор вашей заявки: до 128 символов, любой формат без управляющих символов. Возвращается после оплаты тем же параметром id.

amount

Сумма в рублях, точка или запятая, не более двух знаков после разделителя. Более мелкая дробь отклоняется целиком, а не округляется: покупатель должен платить ровно ту сумму, которую увидел. Заданная сумма фиксируется, выбор номинала на форме отключается.

email

Предзаполнение почты, на которую придёт код.

phone

Телефон в международном формате, закодированным: %2B79001234567.

return_url

Адрес возврата: https:// на любом домене либо путь на этой витрине с / (не //). Предварительная регистрация домена не нужна. Прочее, включая http://, отбрасывается — кнопки возврата просто не будет.

code_param_name

Имя параметра, под которым к return_url добавится код: латинская буква, далее латиница, цифры, _, -, ., до 128 символов. Без return_url не принимается — коду некуда идти.

Параметры проверяются независимо: один негодный не отменяет остальные.

02

Пример

/rubex?id=8e479677b658297ea230ec75c6&amount=500.00&return_url=https%3A%2F%2Fexample.com%2Fback&code_param_name=coupon

03

Возврат после оплаты

К return_url независимо добавляются ваш id и код под именем из code_param_name. Передан только id — вернётся он один.

https://example.com/back?id=8e479677b658297ea230ec75c6&coupon=XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Кнопка возврата появляется только у завершённого заказа: пока код выпускается, вы получили бы заявку без кода, неотличимую от неудачной.

04

Суммы и состояние заказа

Биржа принимает от 100 ₽ до 100 000 ₽; магазин может сузить диапазон. Действующий показан на странице пополнения и проверяется при оформлении.

Состояние заказа: /rubex?payment={номер заказа}. Номер выдаётся при оформлении и приходит письмом вместе с кодом; ссылка показывает код, не передавайте её посторонним.

05

Каталог

Поиск: /?q={запрос}#catalog. Раздел: /?category={раздел}#catalog. Позиция: /games/{id}.

Пополнение стоит в реестре наравне с остальными позициями и находится поиском по словам «пополнение», «баланс», «врубекс».