Paymob Checkout for WooCommerce
Paymob is a leading payment service provider in Egypt, United Arab Emirates (UAE), Oman, Saudi Arabia (KSA), and Pakistan. Since its launch, Paymob has empowered enterprises and SMEs to accept online and in-store payments, revolutionizing payment infrastructure across the MENA-P region.
Sign up for a Paymob account
- 01Click here to register,upload your business documents, and choose the payment methods you want to integrate. The process is simple and can be resumed anytime from where you left off .
- 02Once all steps are completed, document verification will take up to 3 days. If there are any issues with your documents, you will receive an email notification, and our sales representative will assist you in completing the remaining steps.
- 03After your documents are verified, you will receive an email notification.
- 04Once the live payment integrations you requested are set up, you will be notified via email.
Install the Paymob extension
- 05In your WordPress Admin Dashboard, go to Plugins > Installed Plugins.
- 06If “Paymob for WooCommerce” is not listed, follow these steps to install the plugin
Steps to Install the Paymob Plugin
- 07Navigate to Plugins > Add New.
- 08Click on Add New Plugin.
- 09Search for “Paymob for WooCommerce.”
- 10Click on Install next to the plugin.
- 11Once installed, click Activate.
- 12After activation, the plugin will appear as “Paymob for WooCommerce.” Click on Paymob Settings.
Main Configuration
- 13Follow either Step 1.1 OR 1.2 to configure the Plugin for use
1.1 Click on “Connect your Paymob Account” to be redirected to the sign-in page. Select your country, enter your username or mobile number along with your password, and verify your account using an OTP. Once authenticated, you will be taken to the main configuration section. Your plugin is now ready to use & will be enabled by default on the Store. Note – If your onboarding is not yet complete, click on “Connect your Paymob Account” to proceed with the onboarding steps.
1.2 You can also click on “Manual Setup”, enter the API Key, Public Secret Key & Client Key and click on Confirm to connect your account. Once the Keys are validated, your plugin is now ready to use & will be enabled by default on the Store.
Keys are different for Test Mode and Live Mode.
Where to find API Keys?
Log in to the Paymob Dashboard and navigate to Settings -> Account Info. Click on “View” to access the details. Ensure the correct mode is selected, as highlighted on the top panel: choose LIVE to access Live Keys or TEST to access Test Keys.
Paymob Dashboard Link : Egypt – https://accept.paymob.com/portal2/en/login UAE – https://uae.paymob.com/portal2/en/login Oman – https://oman.paymob.com/portal2/en/login KSA – https://ksa.paymob.com/portal2/en/login
- 14Once your account is authenticated through Step 1.1 or 1.2, your LIVE & TEST payment method integrations will be displayed in the Payment Integrations tab. The store mode is indicated in the Main Configuration section, and you can toggle between modes as needed.
In LIVE Mode, your store will use live payment method integrations. In TEST Mode, your store will use test payment method integrations.
If you make any changes, such as switching the mode, enabling/disabling Show Product Details on Paymob’s Checkout, or adjusting the Debug Log, be sure to click “Save Changes” to apply them.
Payment Method Integration Settings
- 15This section displays both Live and Test Payment Method Integrations, with the ability to toggle between Test and Live modes.
- 16Paymob provides flexible checkouts options.
- 17Refer to Payment Method Header:
- 18Option 1. paymob-pixel (Card Embedded Settings) Enable seamless payments directly on your WooCommerce store for Cards, Apple Pay, and Google Pay without redirecting users to Paymob’s Hosted Checkout. By default, this option is enabled on your store with Card Payments only. To enable Apple Pay or Google Pay via Paymob Pixel, please contact your account manager or email us at support@paymob.com. Make sure to receive confirmation from Paymob before enabling Apple Pay or Google Pay via the Card Embedded Settings section.
- 19Option 2: Display payment methods as a list on your WooCommerce store. Users will select a payment method and be redirected to Paymob’s Hosted Checkout to enter their payment details and complete the transaction. Enabling a payment method in this section will make it visible on your WooCommerce store.
- 20Option 3: Using Paymob Main App Paymob’s main app is disabled by default. If enabled, users selecting this option will be redirected to Paymob’s Checkout, where they can choose from all available payment methods. This will appear as the last option in your payment method list.
- 21You can have all set-up’ enabled or a combination of any.
- 22The best recommendation is to use paymob-pixel for Cards, Apple Pay, and Google Pay while displaying other payment methods as a list.
Customization Options
- 23Rearrange payment methods by dragging and dropping them to your preferred order.
- 24Edit titles and descriptions or enable/disable payment methods as needed.
- 25It is recommended not to modify payment method logos. Payment methods will appear in the WooCommerce checkout in the same order as listed here.
Webhook Settings
- 26Webhooks will be automatically configured for all payment method integrations. Merchants can view the current Webhook URL by clicking on the “Webhook URL” option.
- 27The correct format for the Webhook URL is Store URL_ wc-api=paymob_callback
- 28Upon Clicking on “Webhook URL”, a dialog pop-up will display the current Webhook URL. If the displayed Webhook URL does not match the correct format, merchants can click “Confirm” to update it to the correct Webhook URL for their store.
Card Embedded Settings
- 29Feature enables consumers to complete their payments directly on your WooCommerce store. It is enabled by default on your store. To disable it, navigate to the Payment Integrations section and disable “paymob-pixel”. If you wish to hide a specific payment method, simply avoid selecting its integration ID.
- 30For card payments, select the required integration ID. By default, all integration IDs will be pre-selected.
- 31For Apple Pay and Google Pay, certain actions must be completed on Paymob side. Please reach out to your account manager or contact us at support@paymob.com. Make sure to receive confirmation from Paymob before enabling Apple Pay or Google Pay for the embedded experience.
- 32Payment Method – Title: Merchants can customize the title of the payment method displayed at checkout.
- 33Cards, Google Pay & Apple Pay: Select the Integration ID to be used for payments. If integration id is not selected, payment method will not be displayed
- 34Show Save Card: Allows users to save their card for future transactions if they provide consent.
- 35Force Save Card: When enabled, cards are automatically saved after a transaction without user consent. Users will be notified that their card will be saved on Checkout.
- 36Customization: Customize the component using CSS properties. Default settings are applied initially, and you can click the “Reset Default” button to restore them.
Subscription Payments (Recurring Billing)
- 37Supports subscription-based products and services using card-based payment methods that support tokenization.
- 38Requires the WooCommerce Subscriptions plugin to be installed and activated.
- 39Compatible with “Simple Subscription” and “Variable Subscription” product types in WooCommerce.
- 40for more details please visit this link https://developers.paymob.com/egypt/subscriptions-1
Remember to save your changes for them to reflect on the checkout.
Final Step – Enabling Paymob
- 41Go to WooCommerce > Settings > Payments.
- 42Ensure enabling Paymob.