Как работает redirectUrl в крипто-чекауте

Что такое redirectUrl

Вы создаёте платёж одним POST на https://api.qvard.com/api/v1/payment (заголовок x-api-key, номер заказа в id, сумма в price в долларах США). Ответ 201 с двумя полями: id, идентификатор платежа в Qvard, и redirectUrl вида https://my.qvard.com/pay/<id>.

Адрес ведёт на страницу оплаты, размещённую у Qvard, а не на вашем сервере. Вы не строите её, не хостите и не поддерживаете. Ваша задача привести клиента на этот адрес и потом узнать результат из webhook.

Что видит клиент

На странице клиент:

1. выбирает актив и сеть (или видит тот, что вы заранее выбрали через paymentSystemId);
2. видит адрес и точную сумму для отправки, с сетью рядом с адресом;
3. отправляет перевод со своего кошелька или биржи.

Курс на странице зафиксирован на один час, поэтому сумма не меняется, пока клиент платит. Страница одинакова, как бы ни выглядел ваш магазин, в этом и смысл: рабочий крипто-чекаут вы получаете, не строя его. Увидеть её до интеграции можно на демо-счёте.

Использование ссылки на чекауте

Стандартный вариант это серверное перенаправление или кнопка, в три шага:

1. Клиент выбирает «Оплатить криптой». Ваш сервер создаёт ваш заказ и платёж Qvard.
2. Ваш сервер отвечает redirectUrl, как HTTP-редиректом или значением, по которому фронтенд делает переход.
3. Браузер идёт на страницу; клиент платит там.

Создавайте платёж после нажатия кнопки, а не при сборке корзины. Никогда не отправляйте секретный API-ключ в браузер: браузер получает только redirectUrl. Полный пример кнопки в материале кнопка оплаты криптой для сайта.

Использование ссылки вне чекаута

Поскольку страница размещена по обычному адресу, ссылка работает и вне веб-чекаута:

• В письме или PDF со счётом, рядом с банковскими реквизитами, чтобы бизнес-клиент мог выбрать оплату криптой (см. оплата B2B-счетов в стейблкоинах).
• В чате или сообщении поддержки, для разового платежа, созданного вручную вашими инструментами.
• За QR-кодом, если ваша система рисует его по адресу.

Считайте ссылку входом в один конкретный платёж. Отправляйте её клиенту, которому она принадлежит, и не публикуйте. Платёжные ссылки как отдельный продукт без кода в разработке; сегодня вы создаёте платёж через API и передаёте возвращённый адрес.

Повторы, ретраи и что после оплаты

• Тот же заказ дважды. Отправка того же id для того же способа оплаты возвращает уже созданный платёж, поэтому двойной клик или повторный запрос дают тот же платёж, а не второй.
• Возврата по ссылке пока нет. После оплаты клиента автоматически не возвращают на ваш сайт; возвратные адреса пока недоступны. Дайте ему страницу заказа с реальным статусом, которая обновляется, пока идёт ожидание.
• Результат это webhook. Qvard вызывает ваш callback URL, когда платёж завершён, с вашим id и статусом. Точка должна отвечать ровно HTTP 200 и быть безопасной при двойном запуске. Клиент, вернувшийся на сайт, не доказательство оплаты. См. как защитить webhook криптоплатежей.

Чего ссылка не делает

Чтобы вы этого не искали:

• Она не сообщает статус платежа; маршрута для чтения платежа по id нет, поэтому используйте webhook и свои записи.
• Она не возвращает клиента на ваш сайт; возвратные адреса пока недоступны.
• Она не заменяет вашу страницу заказа: вам по-прежнему нужна та, что показывает «ожидает», «частично» или «оплачено».

Форматы запросов и ответов в материале API для криптоплатежей, а весь процесс в как принимать криптоплатежи на сайте.

FAQ