Оплата по ссылке или QR-коду¶
Партнёру доступны несколько способов приёма платежей без использования API QIWI:
- создание ссылки на оплату
- с помощью личного кабинета или бота QIWI Счёт в Telegram,
- вручную;
- создание QR-кода на оплату.
Сценарий¶
Созданную ссылку или QR-код необходимо передать клиенту. После перехода по ссылке QIWI формирует счёт на оплату, и клиент видит платёжную форму.
Обратите внимание
При переходе на форму в webview на смартфонах Android следует включить settings.setDomStorageEnabled(true).
После ввода реквизитов карты и подтверждения оплаты клиентом на форме QIWI проводит аутентификацию клиента с помощью 3D-Secure. После успешной аутентификации средства клиента резервируются, но не списываются в пользу партнёра — ожидают подтверждения. В случае успешного резервирования средств форма QIWI направляет клиента на «URL-адрес страницы для успешного платежа», если данный URL-адрес был передан в ссылке.
Партнёр должен подтвердить платёж в личном кабинете.
По умолчанию QIWI ожидает подтверждения платежа в течение 72 часов с момента успешной оплаты счёта (резервирования средств). По истечении этого срока платёж подтверждается автоматически. Для изменения длительности ожидания или настройки автоматической отмены платежа обратитесь в службу поддержки. Длительность ожидания не может превышать 5 суток.
Создание ссылки на оплату¶
Создание ссылки с помощью личного кабинета
Инструкция по созданию ссылки с помощью личного кабинета размещена на сайте developer.qiwi.com/ru/payments-lk-guide в разделе «Выставление счёта».
Создание ссылки с помощью Telegram-бота
Инструкция по созданию ссылки с помощью Telegram-бота QIWI Счёт размещена на сайте developer.qiwi.com/ru/payments-lk-guide в разделе «Выставление счёта в Telegram».
Формирование ссылки вручную
Укажите в ссылке вида https://oplata.qiwi.com/create?publicKey={key}&{parameter}={value} значения следующих параметров:
| Параметр | Описание | Тип |
|---|---|---|
| publicKey | Обязательный параметр. Публичный ключ для идентификации партнёра, уникальный для каждого siteId. Выпускается в личном кабинете в разделе «Настройки» |
String |
| billId | Уникальный идентификатор счёта в системе партнёра. Генерируется на стороне партнёра любым способом как уникальная последовательность букв, цифр и символов _, -. Если не указан, при каждом переходе по ссылке создается новый счёт |
URL-закодированная строка String(200) |
| amount | Сумма покупки в рублях, округленная в меньшую сторону до 2 десятичных знаков. Если не указан, клиент самостоятельно вводит сумму на форме | Number(6.2) |
| currency | Код валюты покупки. Возможные значения: RUB, EUR, USD. По умолчанию RUB |
String(3) |
| phone | Номер телефона клиента в международном формате | String |
| E-mail клиента | String | |
| comment | Комментарий к оплате | String(255) |
| successUrl | URL-адрес страницы для успешного платежа | URL-закодированная строка |
| paymentMethod | Способ оплаты. Возможные значения: CARD, SBP, QIWI_WALLET. Логика отображения способов оплаты на форме QIWI зависит от выполнения некоторых условий. Условия аналогичны тем, что описаны в таблице раздела «Интернет-эквайринг» → «Оплата с формы QIWI» → «Оплата с помощью API» → «Способы оплаты». Фразу «При выполнении одношагового или двухшагового сценария в запросе на создание счёта отсутствует/передан параметр billPaymentMethodsType» следует читать как «В ссылке отсутствует/передан параметр paymentMethod» |
String |
| extras[cf1] | Дополнительное поле с произвольной информацией, дополняющей данные счёта | URL-закодированная строка |
| extras[cf2] | Дополнительное поле с произвольной информацией, дополняющей данные счёта | URL-закодированная строка |
| extras[cf3] | Дополнительное поле с произвольной информацией, дополняющей данные счёта | URL-закодированная строка |
| extras[cf4] | Дополнительное поле с произвольной информацией, дополняющей данные счёта | URL-закодированная строка |
| extras[cf5] | Дополнительное поле с произвольной информацией, дополняющей данные счёта | URL-закодированная строка |
| extras[themeCode] | Дополнительное поле с кодом стиля платёжной формы | URL-закодированная строка |
| readonly_extras | Список дополнительных полей, которые должны быть недоступны для изменения на платёжной форме | Строка, разделитель имен полей ,. Пример: cf1, cf3 |
Пример ссылок на оплату см. ниже.
Создание QR-кода на оплату¶
Инструкция по созданию QR-кода на оплату в личном кабинете размещена на сайте developer.qiwi.com/ru/payments-lk-guide в разделе «QR-код для оплаты».