Перейти к содержанию

Оплата по ссылке или 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
email 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

Пример ссылок на оплату см. ниже.

https://oplata.qiwi.com/create?publicKey=5nAq6abtyCz4tcDj89e5w7Y5i524LAFmzrsN6bQTQ3ceEvMvCq55ToeErzhvK6rVkQLaCrYUQcYF5QkS8nCrjnPsLQgsLxqrpQgJ7hg2ZHmEHXFjaG8qjvgcep&extras[cf1]=Order_123&extras[cf3]=winnie@pooh.ru&readonly_extras=cf1&comment=some%20comment&amount=100.00
https://oplata.qiwi.com/create?publicKey=5nAq6abtyCz4tcDj89e5w7Y5i524LAFmzrsN6bQTQ3ceEvMvCq55ToeErzhvK6rVkQLaCrYUQcYF5QkS8nCrjnPsLQgsLxqrpQgJ7hg2ZHmEHXFjaG8qjvgcep&extras[cf1]=Order_123&extras[cf3]=winnie@pooh.ru&readonly_extras=cf1

Создание QR-кода на оплату

Инструкция по созданию QR-кода на оплату в личном кабинете размещена на сайте developer.qiwi.com/ru/payments-lk-guide в разделе «QR-код для оплаты».