Для разработчиков
Ссылка на покупку wRUBex
Пришлите покупателя на страницу кода с уже заполненной формой — после оплаты он вернётся к вам с кодом.
Новая покупка
https://keyomat.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 (912) 345-67-89 или +7 912 345 67 89 — приводится к одному виду.Каждый параметр необязателен и разбирается отдельно: ошибка в одном не ломает остальные.
Возврат с кодом
Когда код выпущен, кнопка «Вернуться на ваш-сайт с кодом» ведёт на return_url и добавляет к нему ваш id и код под именем из code_param_name; если оба называются id, остаётся код. Ваши данные хранятся в самом заказе, поэтому возврат работает, даже если покупатель платил с другого устройства. Сама страница никуда не перенаправляет.
https://partner.example/done?id=A-1024&coupon=XXXXX-XXXXX-XXXXX-XXXXX-XXXXXОткрыть существующий заказ
https://keyomat.com/rubex?payment=<номер заказа>Откроется состояние заказа и код, если он уже выпущен.
