Skip to main content

Hosted checkout

Dibsy provides a hosted checkout environment that allows your customer to select their payment method of choice and to complete the payment. You can select the payment methods on your Dashboard under Settings > Payments.

We recommend using a Hosted Checkout since it is battle-tested and optimized for performance and conversion. If, however, you would like to provide a custom checkout experience, please refer to our guide on accepting credit cards and Qatari-issued cards. If you would like to build your own checkout on the web, check out Dibsy.JS

How it works

In its simplest form, setting up a payment requires only three steps: set up the payment with our Payments API, send the customer to our hosted checkout, and trail the outcome of the payment.

A basic payment flow

A customer on your website decides to checkout.

  1. Create a payment using the Payments API with the amount, description, and a redirectUrl where we will redirect the customer after the payment is completed.
  2. If you would like to only provide specific payment methods, pass an array of the methods in the method parameter. For example, "method": [”applepay”, “creditcard”].
  3. The API responds with a unique id to identify the payment, and a unique checkout URL present in _links.checkout.
  4. The customer reaches the checkout, chooses a payment method and makes the payment. This process is entirely taken care of by Dibsy. You do not have to do anything here.
  5. Once the payment is completed, you receive a webhook notification and the customer is redirected back to your website.

Benefits of Hosted Checkout

  • Dibsy’s hosted payment pages have been optimized for devices of all common brands and sizes, including phones and tablets.
  • All payment methods you have enabled are – when relevant – are shown to your customers. A newly activated payment method is available immediately for all of your customers.
  • If the customer’s first payment attempt is unsuccessful, for example, because the customer has an insufficient balance on their card, they are redirected back to the same page to make another payment attempt with the same or even a different payment method. Therefore, no need to implement any extra APIs.

Personalize your checkout

It is possible to customize the checkout by adding your own brand images and colors.

  1. On your Dashboard, click on Settings button on your sidebar and choose Checkout.
  2. Upload your brand image within the specified restrictions.
  3. Choose your brand color as the checkout button color.