Skip to content

_checkout_ru.html.md

Latest commit

 

History

History
76 lines (56 loc) · 6.23 KB

_checkout_ru.html.md

File metadata and controls

76 lines (56 loc) · 6.23 KB

Форма оплаты {#checkout_ru}

Редактировать на GitHub

Провайдер может предложить пользователю немедленно оплатить счет с помощью переадресации на платежную форму.

GET /form?shop=2042&transaction=893794793973&successUrl=http%3A%2F%example.com%2Fsuccess%3Fa%3D1%26b%3D2&failUrl=http%3A%2F%example.com%2Ffail%3Fa%3D1%26b%3D2&pay_source=qw HTTP/1.1
Host: oplata.qiwi.com
const bill_id = '893794793973';

const options = {
    transaction: billId,
    successUrl: 'http://example.com/success',
    failUrl: 'http://example.com/fail',
    pay_source: 'qw'
};

const link = qiwiRestApi.createPaymentForm(options);

Запрос → REDIRECT

В ответ на запрос сервер формирует на сайте QIWI Wallet страницу с выставленным счетом и выбором способа оплаты счета.

Если провайдер использует выставление счета через веб-форму, данное действие выполняется автоматически.

  • Параметры

Параметр Тип Описание Обяз.
shop Строка Идентификатор провайдера. Соответствует параметру prv_id из запроса на выставление счета. +
transaction Строка Идентификатор счета в информационной системе провайдера. Соответствует параметру bill_id из запроса на выставление счета. +
embedded Логический, true/false более компактный вид, удобный для встраивания ее в сайт провайдера. По умолчанию false -
successUrl URL-закодированная строка URL для переадресации в случае успешного создания транзакции в QIWI Wallet. Ссылка должна вести на сайт провайдера. Если пользователь выбрал на платежной форме способ оплаты, отличный от оплаты с баланса QIWI Кошелька, то переадресация на сайт провайдера не выполняется. -
failUrl URL-закодированная строка URL для переадресации в случае неуспеха при создании транзакции в QIWI Wallet. Ссылка должна вести на сайт провайдера. Если пользователь выбрал на платежной форме способ оплаты, отличный от оплаты с баланса QIWI Кошелька, то переадресация на сайт провайдера не выполняется. -
pay_source Строка Способ оплаты по умолчанию, который необходимо отобразить пользователю при открытии платежной формы. Возможные значения:
qw – оплата с баланса QIWI Кошелька;
mobile – оплата с баланса мобильного телефона;
card – оплата банковской картой;
wm – оплата с привязанного кошелька WebMoney;
ssk – оплата наличными в терминале QIWI.
Если способ оплаты не доступен, пользователю отображается предупреждение, при этом на странице можно выбрать другие способы оплаты.		 -

Возврат на сайт провайдера {#back_url}

Возврат клиента после успешного создания транзакции

GET /success?a=1&b=2&order=1234567 HTTP/1.1
Host: example.com

Возврат клиента в случае неуспеха при создании транзакции

GET /fail?a=1&b=2&order=1234567 HTTP/1.1
Host: example.com
Если в ссылке на платежную форму указан параметр successUrl или failUrl, то сайт QIWI Wallet переадресует пользователя на соответствующий URL после завершения процесса оплаты. Переадресация выполняется только при оплате с баланса QIWI Кошелька. Если перенаправление на адрес, указанный в параметре successUrl / failUrl, по какой-либо причине не произошло, для принятия окончательного решения о предоставлении клиенту услуги или товара провайдеру необходимо дождаться уведомления от сервера QIWI Wallet с финальным статусом счета. Если провайдер не использует уведомления, необходимо запрашивать статус счета отдельным запросом API.

При переадресации в ссылку добавляется параметр order, в котором будет передан исходный идентификатор счета у провайдера. Используя этот параметр, провайдер может отобразить необходимую информацию на своей стороне.