New PayPal module (Latest API 2.0) configuration in the advanced variant for osCommerce 4-based systems

From osCommerce Wiki
Jump to navigation Jump to search

This manual describes how to configure the PayPal module (Latest API 2.0) in the advanced variant for osCommerce 4-based systems. This configuration is used if you want to enable alternative payment methods or accept credit card payments directly on your website without redirecting customers to PayPal.

Watch the video first—it gives you the basics.

The manual below explains everything step by step.


1) Accessing Advanced Settings

  1. In the admin area, click on the installed PayPal module.
  2. Click Account details and advanced settings.
  3. Click the Subscribe button next to Required Webhooks.
  4. Confirm the action in the pop-up window.
Image 1112.png


2) Enabling Custom Card Fields

  1. On the same page, check the box next to Status under Custom Card Fields.
    • By default, the required settings are already selected.
  2. Click the Update button to save the changes.
Image 1113.png


3) Available Configuration Options

With the advanced variant, you can configure the following options:

  • Enable PayPal Checkout to accept PayPal Checkout payments.
  • Disable PayPal for guests if only virtual products are in cart (since PayPal does not provide a billing address, guest (express) orders would not have one).
  • Show PayPal button(s) (if horizontal is chosen and depending on design only one PayPal button may show) on:
    • Product page
    • Shopping Cart page
    • Checkout Login page
    • Checkout page (with option to display credit card fields directly)
  • Show PayPal Pay Later info (available in most countries).
  • Save order before payment (it slows down the checkout process and allows to transfer the exact invoice ID to PayPal. Recommended if you have high order volume and/or alternative payment methods).
  • Transaction Method — choose between (pre) authorization or automatic payment withdrawal (sale).
Image 1114.png


  • Order Statuses — set pending, paid, and canceled order statuses.
  • Payment Zone — restrict PayPal to a specific geographical zone.
  • Transaction Server — choose between live and sandbox environments.
  • Dynamic Button Settings — color, shape, size, and label.
Image 1115.png


  • Enable Payment Methods — if no methods are chosen, the system selects them based on availability for the customer’s country and your PayPal account.
  • Debug Email Address — specify an email to receive details of invalid transactions.
  • Sort Order of Display — define the display order of this payment option (lower numbers appear first).
Image 1116.png


4) Restrictions

You can apply restrictions to the PayPal payment method:

  • Restrict availability to specific customer groups.
  • Restrict availability to selected countries.
  • Limit use to certain website sections (e.g., checkout, quotations, samples).

5) Translations

The module also supports translations. You can use the built-in translation tool to adapt the configuration titles into different languages.

Image 1117.png
Retrieved from "https://www.oscommerce.com/wiki/index.php?title=New_PayPal_module_(Latest_API_2.0)_configuration_in_the_advanced_variant_for_osCommerce_4-based_systems&oldid=139995"