Skip to content

Latest commit

 

History

History
63 lines (46 loc) · 3.53 KB

_checkout_en.html.md

File metadata and controls

63 lines (46 loc) · 3.53 KB

Checkout {#checkout_en}

Edit on GitHub

Merchant may offer the user to pay the invoice immediately by redirecting to the QIWI Wallet Checkout page via the HTTP GET-request.

GET /form?shop=2042&transaction=1234567&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

Request → REDIRECT

In response, server opens issued invoice checkout page on QIWI Wallet side. Page contains a number of ways to pay the invoice.

If the merchant uses invoicing web form, this redirect is performed by default.

  • Parameters

Parameter Type Description Required
shop string Merchant's ID in QIWI Wallet system, corresponds to prv_id parameter used to create the bill. Y
transaction string Invoice ID generated by the merchant, corresponds to bill_id parameter used to create the bill. Y
embedded boolean The checkout page appears more compact and can be embedded conveniently within the merchant’s site. Default value is false N
successUrl URL-encoded string The URL to which the payer will be redirected in case of successful creation of QIWI Wallet transaction. URL must be within merchant's site. Redirection is performed when user pays by QIWI Wallet account's balance only N
failUrl URL-encoded string The URL to which the payer will be redirected when creation of QIWI Wallet transaction is unsuccessful. URL must be within merchant's site. Redirection is performed when user pays by QIWI Wallet account's balance only N
pay_source string Default payment method to show first on the page for the user. Allowed values:
qw – QIWI Wallet account;
mobile – client’s cell phone account;
card – a credit/debit card;
wm – linked WebMoney wallet;
ssk – payment by cash in a QIWI Terminal.
When specified method is inaccessible for the user, the page shows a notice about it and the client can choose another method.		 N

Redirection to Merchant Site {#back_url}

Redirect when transaction is successfully created

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

Redirect when creation of transaction is unsuccessful

GET /fail?a=1&b=2&order=1234567 HTTP/1.1
Host: example.com
If the checkout page URL contains successUrl or failUrl parameter, QIWI Wallet site redirects the user back to the corresponding URL after completing the payment process. Redirection occurs when the user pays by QIWI Wallet account balance only. When redirection to successUrl or failUrl is not completed by some reason, you should wait for the QIWI Wallet’s notification with final invoice status to the merchant’s server before complete the user order. When notifications are not used, you should request the invoice status.

The URL for redirection supplements order parameter with its value as the original merchant's invoice ID. Using this parameter, the merchant can render the final page depending on the order details.