Roqqett Pay

Roqqett Pay


Roqqett Pay is the first product of the Roqqett range and enables you to create a seamless one-tap journey to checkout.

Built for every shopping experience, Roqqett Pay places your customer’s mobile phone at the heart of the checkout journey, allowing them to pay the way they want to.

For customers, this will be a button they press to complete their order. The best part? No fields to fill out, no card numbers to type in — just a tap with their banking app.

Payment flow

Roqqett Pay flow

The process of initiating and completing a Roqqett Pay payment consists of the following steps:

Steps 1-3

The customer reaches your checkout payment page and you present the Roqqett payment button. The customer then clicks the Roqqett button, which initiates the checkout session and takes them to a Roqqett-hosted page.


The Roqqett button opens a full screen overlay that encapsulates the payment journey and prevent the users from editing their basket on your site.

Steps 4-7

This is the core part of the payment flow, where the customer must select a bank (if the saved bank is incorrect), authenticate with it, and ultimately authorise the payment. This flow can take place either in the Roqqett app or in a supported browser.


If the payment starts on a desktop browser, then the customer is offered several options to complete the journey. They can either stay on desktop or preferably move onto a device with a banking app installed. For the latter, a QR code and link via SMS are offered to transfer them onto their mobile device for a faster journey that integrates seamlessly with their banking app(s).

Steps 8-10

If the customer authorises the payment, they are taken back to Roqqett, which then displays the receipt and informs your site of the successful payment via webhook.

If the customer cancels the payment, they are taken back to Roqqett and given the option to retry the payment with a different bank or return to your site. If they select the latter, Roqqett informs your site that the payment was cancelled via webhook.

See how this compares to the more comprehensive Roqqett Checkout flow.

Setup guide

Before you begin

Step 1: create a Roqqett Pay instance for your business

  1. In Roqqett portal , go to the Checkouts area.
  2. Click the Create checkout button.
  3. Provide the required fields:
    • Checkout name: this is free text that will be used in to identify payments in the Payments table.
    • Default return URL: the URL where we should send the customer after successful payment, typically the order confirmation page on an eCommerce store.
    • Webhook Url: the URL of the endpoint where Roqqett should send payment Webhooks . If using a plugin , this URL will be displayed on the settings screen.
  4. Tick and configure the features you want to use to enhance your post-sale customer experience.
  5. Click Save .

Step 2: integrate Roqqett Pay with your checkout page

Regardless of whether you integrate using a plugin or Javascript, the key thing is to use the correct checkout ID and API secret.

The checkout ID is the ID of the checkout that you created in the previous step.

The API secret is the secret that you created when setting up your API authentication.

Once you've confirmed these, follow the appropriate instructions for the type of integration that you're implementing: plugin integration or Javascript integration.

Step 3: decide whether to display the cart items

You can choose whether to display the contents of a customer's cart to them in Roqqett Pay. In doing so, the customer will continue to have visibility of their cart up until payment authorisation.

If making this information visible is important for you, then you can easily achieve this by passing over the cart's contents to Roqqett when creating the checkout session using the basket parameter on the /carts endpoint.

Step 4: confirm payments are working

Once you've integrated, the last thing to do before going completely live is to make some small denomination payments on your site. You should check that they flow through your portal and bank account to ensure everything is in order. The Roqqett crew will be there to help you through any testing and service assurance activities.

Production environment only

Currently there is no test environment, so please exercise care when testing. We are working hard to release a test environment soon, so watch out for comms on developments. Roqqett has extensively tested the bank integration and payment flows. We recommend testing your deployment with a small payment amount to check everything is working as expected.