Roqqett Pay

Overview

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

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.

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.

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

• Ensure you have registered and have your API keys .
• Ensure you have one of your organisations bank details that you will need to register.
• Ensure you decided which integration method you will be using out of plugin integration or Javascript integration .
• Ensure your organisation settings are configured correctly in the Roqqett portal .
• Ensure you understand the payment flow .

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.