Last Updated: 09 May 2024 | Change Log

Redirect your customer

Worldpay for Business merchants only

Use the Hosted Payment Pages session URL you have received to redirect your customer to complete a one-time payment.

Redirect

You can redirect the customer's browser to the Hosted Payment Pages session URL as a GET request, by e.g. sending a HTTP 302 response or embedding JavaScript in the response to their browser.

Iframe/Lightbox

You can use our JavaScript library to either:

  • embed Hosted Payment Pages inside an iframe
  • overlay Hosted Payment Pages in a lightbox

This is useful if you want to display content around the payment pages, or to retain your customer on your website.

Refer to the iframe/lightbox documentation.

Mobile Apps

You can open the Hosted Payment Pages session URL in the customer's default mobile browser.

We strongly recommend not using a WebView because (in some cases) third-party apps (such as bank apps) may open, and return to the Hosted Payment Pages in the customer's default browser. This breaks the flow due to missing session data in the browser.

There are two recommendations on how to use Hosted Payment Pages when coming from a mobile app:

  1. You can open the Hosted Payment Pages session URL in the customer's default mobile browser.
  2. In the customer's default mobile browser, redirect to your own webpage and open Hosted Payment Pages in an iframe/lightbox.
info

Depending on the web technology/framework you are integrating with, use one of the inject options documented in the iframe-only parameters section.

You can redirect back to your mobile app, at the end of the payment journey on Hosted Payment Pages, using the redirect URL parameters (for example: successURL). Use a custom URL scheme to launch your app. Custom URLs must be white-listed in the payment page designer.

Refer to the following custom URL scheme documents for more information:

Payment status

To manage your payments we recommend using our webhooks to receive the latest status of your payment to your server in real-time.

Managing your payments

Log into your Dashboard to manage your payments. You can:

  • view
  • refund

your payments.


Next steps


Customization
Add Webhooks
Testing you designs