New PayPal Module (Latest API 2.0) Configuration in Advanced Variant for osCommerce 2-based systems

From osCommerce Wiki
Jump to navigation Jump to search

Although we have released the new osCommerce 4 version, many shop owners continue to use systems based on osCommerce 2.

To support these users, the PayPal module has been updated to ensure compatibility with osCommerce 2-based systems, including support for PayPal Express and APM (Alternative Payment Method) options.

This manual describes how to configure the new PayPal module (based on the latest API 2.0) in the advanced variant for osCommerce 2-based systems.

Begin with the video to get an introduction.

The manual below explains everything step by step.


1) Module Preparation

  1. Ensure the PayPal module is installed in your system.
  2. To configure the module, click:
    • The installed module.
    • The Edit button.
    • The Click here to configure link.

2) Setting Up Webhooks and Custom Card Fields

  1. Go to Account Details and advanced settings.
  2. Click the Subscribe button next to Required Webhooks.
Image 1066.png
Image 1067.png


3. To display credit card fields directly on the checkout page:

  • Check the box next to Status (by default the required settings have already been chosen).
  • In the pop-up window, click Save.
  • Scroll down the page and click Save again.
Image 1068.png


3) Module Capabilities

With this module, you can:

  • Accept PayPal Rest payments
  • Disable PayPal for guests if only virtual products are in shopping cart (since PayPal does not provide any billing address, the guest (express) orders will not have any address)
  • Show PayPal button(s) on Shopping Cart page (if horizontal is chosen and depending on design only one PayPal button may show)
  • Show PayPal button(s) on Checkout Login page (if horizontal is chosen and depending on design only one PayPal button may show, also further settings will be shown below)
  • Show PayPal button(s) on Checkout page (if horizontal is chosen and depending on design only one PayPal button may show, Fields option allows to show fields for filling in the credit card information on the check out page)
  • Show PayPal Pay later info (it is available almost all over the world, also further settings will be shown below)
  • Save orders before payment (recommended if you have quite a lot of orders and alternative payment methods)
  • Configure:
    • Transaction Method (either (pre) authorize or automatic payment withdrawal (sale))
    • Pending Order Status
    • Paid Order Status
Image 1069.png
  • Payment Zone
  • Transaction Server (live or sandbox)
  • Dynamic Button settings (color, shape, size, label).
  • Payment methods (either selected manually or chosen by system based on availability for a certain country and PayPal account settings).
Image 1070.png


Note: The other configuration options that will be shown further are available for osCommerce 2.3 version only.


4) Adding the PayPal Button to the Login Page

1. Navigate to Modules > Content.

2. Click Install Module.

Image 1071.png


3. Select PayPal Checkout and click Install Module again.

Image 1072.png


4. Set Content Width to Full (to display the button on the right).

5. Specify the Sort Order number (it must be higher than the Login Form and Create Account Link numbers).

Image 1073.png


5) Adding the PayPal Pay Later Button and Information to the Shopping Cart

1. Navigate to Modules > Boxes.

2. Click Install Module.

Image 1074.png


3. Select PayPal and click Install Module again.

Image 1075.png


4. Click PayPal and then Edit.

Image 1076.png


5. Set the Sort Order number (it must be higher than the Shopping Cart sort order).

Image 1077.png
Retrieved from "https://www.oscommerce.com/wiki/index.php?title=New_PayPal_Module_(Latest_API_2.0)_Configuration_in_Advanced_Variant_for_osCommerce_2-based_systems&oldid=139824"