Разовая оплата через платежную форму Softline Payments
Обзор возможностей
Сценарий предназначен для совершения разовой оплаты. Он позволяет покупателю вручную выполнить оплату полной суммы покупки.
Для оплаты используется платежная форма Softline Payments. Это готовое решение, которое вы можете:
- Встроить на страницу вашего сайта или в программное приложение с помощью iframe
- Открыть в новом окне браузера или в модальном окне
Платежная форма Softline Payments это возможность быстро и безопасно начать работу с сервисом. Вам не требуется разрабатывать форму самостоятельно.
Последовательность шагов
- Выполните запрос на авторизацию для работы с API (
/v1/login_check
) - Выполните запрос на создание платежа (
/v1/payment
) - В ответ вернется ссылка на платежную форму
- Перенаправьте покупателя на платежную форму Softline Payments, например, отобразив форму по ссылке в iframe:
- Покупатель должен совершить оплату через платежную форму
Особенности оплаты зависят от выбранного платежного метода. Проведение оплаты может потребовать от покупателя заполнения платежных данных, например, это могут быть данные банковской карты. Некоторые методы оплаты могут использовать открытие дополнительных окон, в этом случае открытие окна выполняется на стороне платежной формы. - Если при оплате происходит ошибка (например, покупатель неправильно заполняет данные банковской карты или на карте недостаточно денег для оплаты), то информация об ошибке отражается на стороне платежной формы. Покупатель видит сообщение об ошибке и может повторить попытку оплаты
- После успешной online оплаты покупатель перенаправляется на вашу сторону по ссылке, переданной в запросе при создании платежа.
Обратите внимание: нельзя считать платеж выполненным по факту перехода на URL успешной оплаты (return_success_url), так как: автоматический возврат используется только для online методов оплаты; покупатель может не дождаться перехода и закрыть страницу оплаты; покупатель может подобрать URL возврата и перейти на него самостоятельно. - В случае offline оплаты покупатель получает платежный документ, с помощью которого выполняет оплату без возврата по ссылке
- Покупатель должен совершить оплату через платежную форму
- Дождитесь успешного завершения оплаты. Для этого подождите пока придет webhook-уведомление или проверьте статус платежа с помощью запроса получения данных о платеже
- В случае успешной оплаты вы получите webhook-уведомление о событии order.payment.succeeded. Статус обработки платежа изменится на paid
- При ошибке оплаты вы получите webhook-уведомление о событии order.payment.failed. Статус платежа не изменится
- Если платеж не был оплачен, то его статус останется not paid. Срок жизни платежа в этом равен 90 дней. После этого происходит автоматическое изменение статуса на deleted