Return URL
Bring the buyer back to your site after payment, like success_url at payment providers: allowed sites, the attribute, the parameter and what the result page does.
After payment the buyer stays on our result page. To bring them back to your site — like success_url at payment providers — enable the return. Banks and payment providers review the payment domain, so the buyer can be returned only to a site on the list the platform keeps for your account.
How to enable it
First the platform adds your site to the allowed list: the partner asks support from the cabinet's Messages section (the list is shown in the cabinet's developer documentation and in the widget settings). Then the partner switches on the "return the buyer to the site after payment" option in the widget settings. With it, payment opens in the same tab instead of a new one; otherwise the return would open your site in a second tab. The option concerns only the widget's button and card: a direct payment link with the return_url parameter returns the buyer to any site on the list without it.
In the widget
The widget takes the return address from the attribute on the same element as the widget attribute. Without it, the address of the page the button was clicked on, with the query string and the fragment removed: they may carry your own tokens. Read at the moment of the click. The address from the attribute must lead to the same site the button stands on; otherwise, as with a malformed address, the button opens payment in a new tab without a return, as if the option were off. The widget receives the return flag from our server only when the page is open on an allowed site: on any other site the same code behaves as before — payment in a new tab, no return. The attribute is data-return-url:
<div data-lis-widget="wgt_1a2b3c" data-return-url="https://pawclaw.com/thank-you"></div>In a direct payment link
In a direct payment link, pass it as a query parameter. The parameter is return_url:
https://pay.lis-system.eu/pay/prod_1a2b3c?return_url=https%3A%2F%2Fpawclaw.com%2Fthank-youWhich addresses are accepted
Only an https:// address without credentials, up to 2000 characters, whose host exactly matches one of the allowed sites (or its www. form) is accepted. Subdomains, look-alike names, IP addresses, ports and a trailing dot do not pass. A rejected address does not stop the purchase: the order is created, and the buyer stays on the result page as without a return. The check is repeated when the link is shown, so a site removed from the list after the payment no longer gets the return.
What the buyer comes back with
On a confirmed payment one query parameter is appended to your address: norelio_payment with the order id, the same paymentId as in the notification. If there is nothing to show the buyer on our side (the product has no delivery, or you deliver it yourself on the notification), the buyer is returned automatically five seconds after the payment is confirmed, with a "Return now" button. If the page has something to deliver — a code, text, a link, a file, or "the seller is preparing your order" for a manual service — there is no automatic return: the buyer collects the purchase and leaves with a "Back to …" button. Until the confirmation arrives the page waits for it for up to two minutes; if it does not arrive, the page shows a return button without the order id and says the confirmation will come by email. On a cancelled, failed or refunded payment: a return button to your address without the order id.
https://pawclaw.com/thank-you?norelio_payment=ord_9z8y7x