WooCommerce Fawry Payment Gateway – Simple & Recurring Payments Documentation

• 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://

• 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.

 

 

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.

 

 

• User have option to save his credit card details.