Переадресация после оплаты

Параметр successUrl — автоматический redirect клиента после успешной оплаты счёта

При создании счёта можно передать параметр successUrl — URL, на который клиент будет мгновенно перенаправлен после успешной оплаты.

Если successUrl не указан — клиент остаётся на странице оплаты Love&Pay (https://loveandpay.io/pay/INV-xxx) со статусом «Оплачено», где видит чек и QR-код.

Параметр successUrl поддерживается в API v1 и API v2 одинаково. На этой странице приведены примеры для v2, но в v1 работает аналогично.

Параметр

successUrl · string

URL для перенаправления клиента после успешной оплаты.

Требования:

• Полный URL включая протокол (https://...)
• URL должен быть публично доступен для клиента
• Можно передавать query-параметры (?order=123&status=paid)

Пример запроса

cURL

curl -X POST "https://loveandpay.io/api/v2/invoices" \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_xxx" \
  -H "x-timestamp: 1706012345678" \
  -H "x-signature: a1b2c3d4e5f6..." \
  -d '{
    "amount": 50000,
    "description": "Заказ #12345",
    "customerName": "Иван Иванов",
    "customerEmail": "[e-mail]",
    "customerPhone": "[phone]",
    "successUrl": "https://yoursite.com/payment/success?order=12345",
    "expiresInHours": 1
  }'

Как это работает

Оплата через СБП (QR)

1. Открытие страницы

   Клиент открывает страницу оплаты https://loveandpay.io/pay/INV-xxx

2. Оплата

   Сканирует QR-код и оплачивает в банковском приложении

3. Определение оплаты

   Страница автоматически определяет оплату (polling каждые 3 секунды)

4. Переадресация

   Мгновенный redirect на successUrl

Оплата картой

1. Открытие страницы

   Клиент открывает страницу оплаты Love&Pay

2. Редирект на форму оплаты

   Перенаправляется на защищённую форму ввода данных карты

3. Ввод данных

   Вводит данные карты, проходит 3DS

4. Возврат

   Клиент возвращается на https://loveandpay.io/pay/INV-xxx

5. Определение оплаты

   Страница определяет, что счёт оплачен

6. Переадресация

   Мгновенный redirect на successUrl

Динамический URL

Можно передавать любые query-параметры — например, ID заказа или пользователя для последующей обработки:

{
  "amount": 100000,
  "description": "Подписка Premium",
  "successUrl": "https://myapp.com/api/payment-callback?invoice_id=INV-xxx&user_id=456"
}

Без successUrl

{
  "amount": 100000,
  "description": "Разовый платёж"
}

Клиент остаётся на loveandpay.io/pay/INV-xxx — видит статус «Оплачено», чек и QR-код.

---

Важно

successUrl — это клиентский redirect (в браузере), а не серверный callback.

• Для серверных уведомлений используйте Вебхуки (событие invoice.paid) — создаются в дашборде
• Redirect происходит мгновенно — клиент не успевает увидеть страницу «Оплачено»
• Если URL недоступен — браузер покажет ошибку (это на стороне партнёра)

Рекомендуется использовать successUrl вместе с вебхуками: redirect — для UX клиента, вебхук — для надёжной серверной обработки платежа.