How does the IWD Checkout work?

The IWD Checkout is a cloud-based checkout-page that replaces your existing Magento platform's Checkout-Page with an iframe that displays your already configured IWD Checkout. By placing the IWD Checkout on an iframe, it will allow us to maintain your same-store URL address, so the users avoid being redirected to another page, causing confusion and cart abandonment.

IWD Checkout solution depends on three key platforms to work:

  1. A Magento Store with an IWD Checkout Connector. The Connector will help us to display the checkout-page on your store and communicate with the IWD Checkout Platform to send and receive information related to the checkout process. i.e., Cart, Customers, Payments, Refunds, etc.
  2. IWD Checkout Platform (Checkout-Page): This is the brain of your checkout-page. The IWD Checkout Platform will display your configured checkout-page on the Connector iframe, and it will communicate and synchronize data between your Magento Store and the Payment Gateways.
  3. PayPal Commerce Platform (Most advanced payment gateway in the market): PCP will process your payments, refunds, and any other activity related to your processed and unprocessed orders. The IWD Checkout will communicate with the PayPal Commerce Platform to extract and execute tasks made on your Magento store.

Magento Store (IWD Connector) < - > IWD Checkout Platform < - > PayPal Commerce Platform



What kind of information does the IWD Checkout - Magento Connector exchanges with IWD?

The IWD Checkout Connector exchanges the following information with the IWD Checkout platform:

  • Cart Information
    • Cart ID
    • Products
    • Coupons & Promotions
    • Tax Info.
    • Subtotals & Grand Totals
  • Customer Information (If customers are logged-in into your platform)
    • Contact Details (Email, Name, Last Name)
    • Billing & Shipping Addresses
  • Shipping Methods
    • Available Shipping methods for the current cart
    • Shipping Method Name and rates


Task List before enabling the IWD Checkout

Before proceeding on enabling your IWD Checkout, please make sure you have done the steps noted in the following task list:

  1. You have created an Integration for your Store on your IWD Checkout account.
  2. Downloaded and Installed on your Magento Store the IWD Checkout Magento Connector
  3. You have Configured the API Key on your Magento Store and received a Connection Succesful message.
  4. You have Configured a PayPal Commerce Platform account.
  5. You have Customized your IWD Checkout-page design.
  6. You have Tested on Sandbox mode transactions made with the IWD Checkout Platform.

How to Configure a PayPal Commerce platform account?

IWD Checkout integrates the newest payment platform from PayPal named PayPal Commerce Platform that comes with an On-boarding process that will facilitate the migration of your existing PayPal account. If you have not yet a PayPal account, you will be able to create it using the same steps noted below:


  1. Access your IWD Checkout account here: https://www.iwdagency.com
  2. Go to IWD Checkout -> Configurations -> Payment Methods -> PayPal
  3. Click on the "Sign-in" button, and a pop-up window will display with the On-boarding process.
  4. Follow the steps shown on the PayPal On-boarding process.
  5. Once you have completed the On-boarding process, we will gather your Merchant ID automatically and configure your account to use the selected PayPal Account.
  6. Click the "Save" button.
  7. IWD Checkout will enable the PayPal payment section where you will be able to switch between Sandbox and Live environment anytime. It will also display the "Payment Action" button that will allow you to select between three different Authorization and Capture methods.
    1. Only Authorize
    2. Authorize and Capture
    3. Immediate Capture

How to enable the Sandbox environment?

Once you have configured your PayPal Commerce Platform account:

  1. Access your IWD Checkout account here: https://www.iwdagency.com
  2. Go to IWD Checkout -> Configurations -> Payment Methods -> PayPal
  3. Click on the "Sandbox" option.
  4. Click the "Save" button.

How to Customize my Checkout-Page?

IWD Checkout allows you to have a default configuration for all your store's checkout-pages or to configure each Checkout-page individually.

To configure the checkout-page design:


  1. Access your IWD Checkout account here: https://www.iwdagency.com
  2. If you want to change the default checkout-page configuration:
    • Go to IWD Checkout -> Configurations -> Design / Look & Feel
  3. If you want to customize each integration/store checkout-page individually:
    1. Go to IWD Checkout -> Integrations 
    2. Click Edit Store icon and click on the Design / Look & Feel section
    3. Uncheck the "Use General Default Settings" option.
  4. Customize:
    1. Select the Checkout-Page Layout you want to use:
      1. Multi-step layout
      2. One Page Checkout
    2. Select your store's Font that will be used on your Checkout-Page. IWD Checkout uses Google fonts.
    3. Select your preferred colors for the following sections/buttons:
      1. Page BackgroundThis color will be applied to the Checkout Page Background.
      2. Sidebar BackgroundThis color will be used to the Checkout Right Sidebar Background.
      3. Heading Text ColorThis color will be applied to Headings and Titles.
      4. Body Text ColorThis color will be applied to any Body or Informational Text
      5. Link ColorThis color will be applied to all Links on the Checkout Page.
      6. Highlight ColorThis color will be used to Highlight Chosen Options and Focus Input Fields
      7. Primary Button BackgroundThis color will be used to Primary Action Buttons Background. Ex: Continue To Delivery Method, Continue To Payment, Place Order.
      8. Primary Button Text ColorThis color will be applied to Primary Action Buttons Background. Ex: Continue To Delivery Method, Continue To Payment, Place Order.
      9. Secondary Button Background: This color will be applied to the Secondary Action Buttons Text. Ex: login, Reset, Apply a Promo Code.
      10. Secondary Button Text Color: This color will be applied to the Secondary Action Button Text. Ex: login, Reset, Apply a Promo Code.
    4. Click the "Save" button.

Switching PayPal Commerce Platform to use Live credentials

Warning: Changing your PayPal Commerce Platform settings to use live credentials will reflect on all your integrations.

Once you have tested your IWD Checkout and you're ready to go live:

  1. Access your IWD Checkout account here: https://www.iwdagency.com
  2. Go to IWD Checkout -> Configurations -> Payment Methods -> PayPal
  3. Click on the "Live" option.
  4. Click the "Save" button.

How do refunds work?

Refunds, as well as other payment actions, are performed within your Magento platform. IWD Checkout Connector includes webhooks that connect and synchronize with the IWD Checkout platform to exchange this type of information.

If a refund is made from your Magento store, it will send an API call to our IWD Checkout platform, and we will perform the refund on your behalf on your PayPal Commerce Platform account and vice-versa.