WooCommerce Fawry Payment Gateway – Simple & Recurring Payments Documentation

1.Introduction #

This integration allows users to pay for their orders and subscriptions of WooCommerce on your site using Fawry Payment Gateway. There are two types of payments, Fawry cash on delivery and Fawry credit card.

Was this helpful? Yes No

Suggest edit

2.Information & Requirement #

WooCommerce 3.5+
WordPress 5.0+
WooCommerce Subscription (In order to accept recurring payment)
PHP version 5.5+
Your site MUST have valid SSL or domain contain https://

Was this helpful? Yes No

Suggest edit

3.Settings #

After the plugin has been installed, Fawry payment methods will be introduced in payments tab.
Two payment methods will have their dedicated settings.
To edit Fawry payment methods settings, admin has to access payments tab from Woocommerce settings.

Admin can enable/disable the Fawry Payment Methods by clicking the toggle button.
Admin can edit Fawry settings by clicking the manage button.
To save the changes admin has to click save changes button.

Admin has been provided with two payment methods. Fawry cash on delivery and Fawry credit card.
Each payment method has its own dedicated settings
These settings can be accessed by clicking manage button.

Fawry (Cash On Delivery Method)

Admin can enable Fawry cash on delivery sandbox by clicking the checkmark.
After the sandbox has been enabled admin can test the Fawry cash on delivery payment method
Admin has to get test merchant code and test secure key from Fawry gateway authors, to enable the testing environment.
Admin has to click the save changes button to save the settings.

Fawry (Credit Card Method)

Admin can enable Fawry credit card sandbox by clicking the checkmark.
After the sandbox has been enabled admin can test the Fawry credit card payment method.
Admin has to get test merchant code and test secure key from Fawry Gateway authors, to enable the testing environment.
Admin has to click the Save changes button to save the settings.

Was this helpful? Yes No

Suggest edit

4.How it Works #

Testing Fawry Cash On Delivery Method

After an order or subscription has been placed Admin will be redirected to the checkout page.
On checkout page, Admin has to fill the details.
After filling details Admin can choose from Fawry (Cash on delivery) OR Fawry (credit card) payment method.
Then click Place order.

After placing the order or subscription, Admin will be redirected to order confirmation page.
An order reference number will be generated by the system and provided to the Admin.

Admin can view order and subscriptions log from orders in WooCommerce tab.

Admin can click any respective order or subscription to view the detailed information like status, billing address and reference number.

Testing Fawry Credit Card Method

After an order or subscription has been placed Admin will be redirected to the checkout page.
On checkout page, Admin has to fill the details
After filling details Admin can choose from Fawry cash on delivery and Fawry credit card payment method.
Admin can choose Fawry Credit Card method.

Enter credit card info.
Admin has an option to select from credit cards saved before.
Processing payment will be on the same site. Admin will need redirect to Fawry.
System will create reference number to Admin and redirect to Thank you page and Admin can view reference number. Also, Admin can receive reference number on his email.
Admin can choose to delete the already used credit cards from the systems record.

Send email after submit payment [Email instruction]

You can change email content sending to user after submit payment, Also this content appear in thank you page.
Go to woocommerce → settings → payments → fawry (cash on delivery).
Edit in (Reference Number Instruction), Also put {hours} in text area to represent value of expiration hours ,{ref_no} to represent client reference number.

Order status after submit order

Each order status after submit order will be pending payment.

Change payment icon

You can change payment icon
Go to woocommerce → settings → payments → select fawry payment type.
Click on payment icon and change the image.

Update payment expiry date

You can define the number of hours of expiry date of payment.
Go to woocommerce → settings → fawry [cash on delivery] → payments.
If you not define expiry date will use the expiry date of your fawry account.

Callback URL

Fawry will send response by link when payment status is changed.
Go to woocommerce → settings → fawry [cash on delivery] → payments.
Callback url should be: website URL/wc-api/wc_apiexpert_fawry_payment

Enable save cards

If enabled save cards. That means users have option to save payment token.
Go to woocommerce → settings → [fawry credit card payment] → payments.
Enable save cards was apply only on simple product. Also in case “subscription product” system will save payment token.