How does the IWD Checkout work?

The IWD Checkout is a cloud-based checkout-page that replaces your existing eCommerce platform's Checkout-Page with an iframe that displays your already configured IWD Checkout. By placing the IWD Checkout-Page 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.


Image Placeholder


IWD Checkout solution depends on three key platforms to work:

  1. An eCommerce 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 eCommerce 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 eCommerce store.


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

For the IWD Checkout-page to work, 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 performed 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 the IWD Checkout eCommerce Connector on your eCommerce Store.
  3. You have Configured the API Key and received a Connection Succesful message on your eCommerce Store.
  4. You have Configured a PayPal Commerce Platform account.
  5. You have marked the customer's phone field as mandatory on your PayPal account: https://www.paypal.com/us/smarthelp/article/how-do-i-make-the-phone-field-mandatory-with-checkout-faq3691
  6. You have Customized your IWD Checkout-page & PayPal buttons design.
  7. You have Tested on Sandbox mode transactions made with the IWD Checkout Platform & PayPal.
  8. You have HTTPS configured and enabled for your website.

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/account
  2. Go to IWD Checkout -> Configurations -> Payment Methods -> PayPal

    Image Placeholder
  3. Click the Enable Sandbox PayPal button, and a pop-up window will display with the On-boarding process.

    Image Placeholder
  4. Follow the steps shown on the PayPal On-boarding process page.
  5. Follow the steps shown below to make it mandatory for your customers to provide their phone number with checkout (Only for PayPal Business Accounts).
    1. Access to your PayPal account.
    2. Click the Settings icon next to "Log out."
    3. Click Website payments under "Products & Services" on the left of the page.
    4. Click Update next to "Website preferences."
    5. Select On  (required field) under "Contact telephone" in the "Contact telephone number" section.
  6. 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.


    Image Placeholder
  7. Click the Save button.
  8. Once you've configured your PayPal account. IWD Checkout will enable the PayPal payment section where you will be able to switch between Sandbox and Live environment and change the look & feel of the PayPal Smart-buttons at any time. The Payment Action controls 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/account
  2. Go to IWD Checkout -> Configurations -> Payment Methods -> PayPal
  3. Click on the Sandbox option.
  4. Click the Save button.
Image Placeholder




How to Customize my Checkout-Page?

IWD Checkout allows you to have a Default Configuration Design 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/account
  2. If you want to change the default checkout-page configuration:
    • Go to IWD Checkout -> Configurations -> Design / Look & Feel

      Image Placeholder
  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

      Image Placeholder

    3. Set to No the Use General Default Settings option.

      Image Placeholder
  4. Customize:
    1. Select the Checkout-Page Layout you want to use:
      1. Multi-step layout
      2. One Page Checkout (Coming soon)Image Placeholder
    2. Select your store's Font that will be used on your Checkout-Page. IWD Checkout uses Google fonts.

      Image Placeholder
    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.Image Placeholder
    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, please follow these steps to switch to the live environment:

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

    Image Placeholder
  4. Click the Enable PayPal button and follow the steps shown on PayPal's Onboarding process window.

    Image Placeholder
  5. Click the Save button.

How do refunds work?

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

If a refund is made at your eCommerce 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.


Product Support
If you need assistance configuring your IWD Checkout account or IWD Checkout Connector, please send us an email to extensions@iwdagency.com