Партнёрам
Ссылка на покупку wRUBex
Отправьте покупателя на страницу кода с уже заполненной формой — после оплаты он вернётся к вам с кодом.
Новая покупка
https://lovihapai.com/rubex?amount=1000&id=A-1024&return_url=https%3A%2F%2Fpartner.example%2Fdone&code_param_name=couponПараметрЗначениеКак обрабатывается
amountСумма в рублях: 1000 или 1000.50Сумма в допустимом диапазоне фиксируется в форме. Иначе покупатель видит причину и выбирает сумму сам: мы никогда не подставляем свою.idВаш номер заказаХранится в самом заказе и возвращается вам вместе с кодом.return_urlАдрес возврата: HTTPS или путь на этом сайтеНебезопасный адрес отбрасывается, а не исправляется: тогда кнопки возврата просто нет. Кнопка называет сайт, на который уйдёт код.code_param_nameИмя параметра для кодаРаботает только вместе с return_url.emailПочта покупателяПодставляется в форму, покупатель может её изменить.phoneТелефон покупателяЗаписи вида 8 (999) 123-45-67 и +7 999 123 45 67 приводятся к одному виду.Все параметры необязательны, и каждый разбирается отдельно: ошибка в одном не отменяет остальные.
Возврат с кодом
Когда код выдан, кнопка «Вернуться на ваш-сайт с кодом» ведёт на return_url. К адресу добавляются ваш id и код под именем из code_param_name; если оба называются id, побеждает код. Данные партнёра хранятся в самом заказе, поэтому возврат работает и после перехода в приложение банка на другом устройстве. Страница никогда не перенаправляет сама.
https://partner.example/done?id=A-1024&coupon=XXXXX-XXXXX-XXXXX-XXXXX-XXXXXОткрыть существующий заказ
https://lovihapai.com/rubex?payment=<номер заказа>Страница покажет состояние заказа и код, если он уже выдан.