Отправьте покупателя на страницу купона со своими параметрами: форма откроется уже заполненной, а после оплаты покупатель вернётся к вам с кодом.
https://topuptrigger.com/rubex?amount=1500&id=A-1024&return_url=https%3A%2F%2Fpartner.example%2Fdone&code_param_name=couponПараметры
| Параметр | Что передаёт |
|---|---|
amount | Сумма в рублях: 1500 или 1500.50. Сумма из ссылки фиксируется в форме, если её можно купить; иначе покупатель увидит, почему, и выберет сам. |
id | Номер заказа на вашей стороне. Вернётся к вам в параметре id. |
return_url | Куда вернуть покупателя после выдачи кода: адрес HTTPS или путь на этом сайте. Небезопасный адрес отбрасывается. |
code_param_name | Имя параметра, в котором вернётся код. Работает только вместе с return_url. |
email | Почта покупателя — подставится в форму. |
phone | Телефон покупателя — подставится в форму, в любом привычном виде. |
Возврат с кодом
Когда код выдан, рядом с ним появляется кнопка «Вернуться на ваш сайт с кодом» — покупатель видит адрес до нажатия. Страница никуда не переходит сама. Пример адреса возврата:
https://partner.example/done?id=A-1024&coupon=XXXX-XXXX-XXXXОткрыть существующий заказ
/rubex?payment=<номер заказа> открывает уже созданную оплату — так работают ссылки из писем.
Каждое поле проверяется отдельно: неверный параметр отбрасывается, остальные продолжают работать. Ссылка для другого заказа или другой суммы не откроет прежнюю неоплаченную покупку.