FawryPay Shopify Plugin

Use FawryPay's plugin to start accepting payments in your Shopify store with a variety of payment methods.

Before you start

FawryPay payment integration with Shopify plugin is an easy process where there are no advanced development skills 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. Go to the following https://shopify.fawrypay.online/login. You should see the follwing screen:
  2. Shopify go to fawrypay link
  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. Insert your Shopify url
  5. Click on “Install unlisted app”, which will install the app on your Shopify store.
  6. Shopify install
  7. Under your Shopify admin panel got to Apps, you should see an application with name Fawrypay.
  8. 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. Shopify configuration
  3. Within the FawryPay Payment Setting page, please fill the fields as described in the following table:
  4. 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
  5. Click on Submit button.
  6. Once you are done with adding all configuration settings, click on the Settings (at bottom left section).
  7. Click on the Payment providers from settings page:
  8. Shopify configuration
  9. 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:
  10. Shopify Create Payment Method
  11. 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.
  12. Shopify Create Payment Method
  13. After completing the above steps, you should have successfully configured and activated FawryPay Shopify plugin. You should see the plugin status screen as follows:
  14. Shopify Create Payment Method

Order Processing Scripts

  1. Click on the Checkout settings again from Settings page (highlighted in screenshot below).
  2. Shopify Create Payment Method
  3. Under Checkout settings, you will see the Order processing which contains a section for adding Additional scripts.
  4. Shopify Additional Scripts
  5. 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:

Shopify Installation Error

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.

Was this page helpful?

Thank you for helping improve FawryPay's documentation. If you need help or have any questions, please consider contacting support.