Setting up PayFort as your Checkfront payment provider

Accessing the features mentioned in this article

Where can I find this feature using the top menu?

Manage > Ecommerce Setup > Payment

What more do I need to use this feature?

• Admin permissions are required to manage Payment Providers.

 

---

Payfort makes online payments safe and secure for buyers and sellers in the Arab world, delivering a complete suite of payment solutions that cater to the region's needs and are tailored to Arab online buying habits and trends.

Since PayFort does not include a virtual terminal, staff members in your organization cannot process invoice payments through the Checkfront Booking Manager. Payments can only be processed without a virtual terminal through Customer-facing booking pages.

PayFort allows processing in-app refunds, meaning a refund in Checkfront will automatically update in PayFort and refund the customer. This is a great feature because, without this, you would need to process the refund in PayFort manually and then make a POS refund in Checkfront to balance the books.

 

---

To enable PayFort, log in to your Checkfront account and navigate to Manage > Ecommerce Setup, ensuring the Payment tab is selected.

Here you see a list of available payment modules. Locate the PayFort tile from the list.

 

You find it by clicking on the links in the left side menu labelled Available to [your country] or All. You can also search for the PayFort tile directly in the provided search box.

Hover over the tile, which turns grey, and click. 

 

This opens the PayFort activation window, as pictured above.

Before continuing, ensure you have an active PayFort account, which is required to properly activate the Payment Provider in Checkfront.

You can apply here if you don't yet have a PayFort account.

Assuming you have an account set up and ready to go, continue reading the document below.

 

 

---

To link Checkfront with PayFort via the API, you must obtain credentials that need inputting to the activation modal in Checkfront. 

To locate these credentials, navigate to Integration Settings > Security Settings in your PayFort account dashboard.

 

 

 

 

(1) Merchant Identifier (Required)

This is a username that uniquely identifies your business in the PayFort ecosystem. This username was created when you set up your account and cannot be changed.

 

(2) Access Code (Required)

Click on the green Generate button over on the right of the field to create a new access code or copy the code that might already be there.

 

(3) SHA Request Phase (Required)

Input a phrase in this field. A series of random letters is just fine (e.g. sVyhBHuT). To see what you're typing in, click the eye icon to the right of the field.

 

(4) SHA Response Phrase (Required)

Input a phrase in this field. A series of random letters is just fine(e.g. sVyhBHuT). To see what you're typing in, click on the eye icon to the right of the field

 

In addition to the credentials you must add to the Checkfront activation modal, you need to update some things in the PayFort dashboard. 

 

(5) Origin URL

This is the direct transaction feedback URL mentioned in the Checkfront activation modal. It follows the format https://[company].checkfront.com/notify/PayFort/ where [company] should be replaced by your Checkfront account username. For example: https://ecotours.checkfront.com/notify/PayFort/

 

SHA Type

Look for the SHA Type field (highlighted in yellow in the screenshot above). Make sure this is set to SHA-512 by using the dropdown selection menu. 

 

 

---

We highly recommend thoroughly testing your Payment Providers integration with Checkfront before processing live transactions. This way, you can ensure the system works as expected and the payments are synchronized between systems.

 

Check the Enable Sandbox Mode box in the activation module to enable the testing mode.

Don't forget to uncheck this again once you are satisfied with the integration and before you perform any live transactions!

 

---

Use the following dummy credit card credentials to test payments in your system:

 

Credit Card Number: 4005550000000001

Expiry: 05/21 (or any date in the future)

CVC: 123

 

Click here for a more extensive list to test credentials.