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.
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://
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.
- 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.
- 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.
Fawry (Cash On Delivery Method)
Fawry (Credit Card Method)
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.
- 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.
- 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.
- Each order status after submit order will be pending payment.
- You can change payment icon
- Go to woocommerce → settings → payments → select fawry payment type.
- Click on payment icon and change the image.
- 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.
- 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
- 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.
Testing Fawry Credit Card Method
Send email after submit payment [Email instruction]
Order status after submit order
Change payment icon
Update payment expiry date
Callback URL
Enable save cards
Help Guide Powered by Documentor