FawryPay Shopify Plugin

Before you start

FawryPay payment integration with Shopify plugin is an easy process where there are no advanced development skills are needed. However, you will need to make sure you meet the following criteria before you start:

1. You have an active FawryPay account, or create account
2. Apply for a live account with FawryPay. Once we have reviewed and approved your application, we will send you a contract with confirmation of the pricing and commercial terms. After the contract is signed, you will receive an email with login credentials to your live account.

Installation

This document illustrates how our gateway can be integrated with Shopify plugin in simple and easy steps. Please follow the steps in order to integrate the FawryPay plug-in with your Shopify store.

1. First, Our team Will provide you with an INSTALLATION LINK that you should open in your browser to start the installation process.


2. Once the redirection happens from the INSTALLATION LINK, You should see the following screen:

3. Enter your Shopify store name without https://, App-Key, and App-Secret you have received from FawryPay team upon your account setup, then, click on Install button and follow all the steps for Shopify app authentication.

4. Click on “Install unlisted app”, which will install the app on your Shopify store.

5. Under your Shopify admin panel got to Apps, you should see an application with name Fawrypay.
6. Well done, you have managed to install Shopify FawryPay plugin!

Setup and Configuration

1. Under your Shopify admin panel got to Apps and click on Fawrypay app. This will open the configuration page which shall look like:

2. Within the FawryPay Payment Setting page, please fill the fields as described in the following table:

field	Environment	description	example
Account Number	Production	Your production environment merchant ID (encrypted code) you should have received it after creating an accent.	1tSa6uxs2nRlhbmxKHde8A==
Secure Hash Key	Production	Your production environment Security key (encrypted code) you should have received it after creating an accent.	8e675er5aa864b49w6a30fe2eea7124b
Account Number	Sandbox	Your Sandbox (testing) environment merchant ID (encrypted code) you should have received it after creating an accent.	1tSa6uxs2nRlhbmxKHde8A==
Secure Hash Key	Sandbox	Your Sandbox (testing) environment Security key (encrypted code) you should have received it after creating an accent.	8e675er5aa864b49w6a30fe2eea7124b

3. Click on Submit button.
4. Once you are done with adding all configuration settings, click on the Settings (at bottom left section).
5. Click on the Payment providers from settings page:

6. In Payment providers page scroll down to the Manual payment methods section and click on Manual payment methods drop-down and select Create custom payment method options:

7. Setup Fawrypay payment method by adding the name of the method FawryPay (pay by Card or at any Fawry location) and add any additional details description. Then click on the Activate button.

8. After completing the above steps, you should have successfully configured and activated FawryPay Shopify plugin. You should see the plugin status screen as follows:

Order Processing Scripts

1. Click on the Checkout settings again from Settings page (highlighted in screenshot below).

2. Under Checkout settings, you will see the Order processing which contains a section for adding Additional scripts.

3. Now, you will need to add FawryPay Shopify plugin JavaScript code under additional scripts text area. This code will be sent to you via Email upon signing the contract with FawryPay.

Troubleshooting

During your initial installation step, you may face a problem with installation of our plugin into your Shopify store. You get the following error from your store:

This error usually happens in case you have yet to close your contract with FawryPay. You may try to reach out our call center at 19016 or just leave us a support ticket and our support team will contact you accordingly.