# Integrate osCommerce

## Overview

Integrate osCommerce to be able to process payments through the 2Checkout platform in over 200 countries and more than 100 currencies.

[osCommerce](https://www.2checkout.com/online-shopping-carts/oscommerce.html) is an eCommerce and online store management software that helps merchants to launch their businesses.

## Availability

{% hint style="info" %}
Before you are able to start accepting payments, you need to request and finalize the activation of your live account by completing a form, and provide information that will help us verify the business and identity of the individuals involved in your business.
{% endhint %}

osCommerce integration is available only for 2Checkout accounts that handle their own tax and invoice management (**2Sell** and **2Subscribe**).

## osCommerce Settings

Perform the below set of instructions in your osCommerce account to integrate it with 2Checkout.

1. Download the new 2Checkout module from [Github](https://github.com/2Checkout/oscommerce-2checkout).
2. Upload the files to your server under your store’s directory.
3. Log in to your osCommerce admin area.
4. Navigate to *Administration → Modules* and click on **Payment**.<br>

   <div data-with-frame="true"><figure><img src="/files/xXwEV9BFIPA8JUlfIwLc" alt=""><figcaption></figcaption></figure></div>
5. On the *Payment* page, click **Install** on **2Checkout.**<br>

   <div data-with-frame="true"><figure><img src="/files/gUyujW0S5O9dGTVIV3Rl" alt=""><figcaption></figcaption></figure></div>
6. Select **2Checkout API**, **2Checkout ConvertPlus** or **2Checkout InLine** and click on **Install** **Module.**<br>

   <div data-with-frame="true"><figure><img src="/files/VrOzDErFcLQvUpxtYhjK" alt=""><figcaption></figcaption></figure></div>
7. Enter your **2Checkout details**:
   * **2Checkout Account ID.** The 2Checkout ID is your 2Checkout Merchant Code, and you can find it in the 2Checkout Merchant Control Panel, under [*Integration → Webhooks and API*](https://secure.2checkout.com/cpanel/webhooks_api.php).
   * **Secret Key** (you can find it in the 2Checkout Merchant Control Panel, under *Integration → Webhooks and API*)
   * **Buy-Link Secret Word** (you can find it in the 2Checkout Merchant Control Panel, under *Integration → Webhooks and API*)<br>

     <div data-with-frame="true"><figure><img src="/files/xL0SXBWnJfogZXYIQIA9" alt=""><figcaption></figcaption></figure></div>
8. Under *Test Mode* select **No** for live sales or **Yes** for test sales.
9. Click **Save Changes.**

## 2Checkout Settings

1. Log in to your [2Checkout Merchant Control Panel](https://secure.2checkout.com/cpanel).
2. Navigate to the [Integrations → Webhooks & API](https://secure.2checkout.com/cpanel/webhooks_api.php) section.
3. Enable the **IPN webhook notification**.
   * Go to *Integrations → Webhooks & API*<br>

     <div data-with-frame="true"><figure><img src="/files/sVev0tSNL39FKLjXvOWq" alt=""><figcaption></figcaption></figure></div>
   * Scroll down to the ***Notifications*** section and enable the IPN webhook.
   * For the *Payment notification type* field, select **IPN or Email Text & IPN**, and then click on the **Configure IPN** button.
   * On the *IPN settings* page, click on the **Add IPN URL** button, input the IPN URL available on the configuration page in osCommerce and select the SHA 2 / SHA 3 hash.<br>

     <div data-with-frame="true"><figure><img src="/files/AW3lLWHSiSG8KxkU7d6T" alt=""><figcaption></figcaption></figure></div>
   * Enable all triggers and response tags.

## About osCommerce

[osCommerce](https://www.oscommerce.com/) (Open-Source Commerce) is an eCommerce and online store management software. ​It’s one of the oldest eCommerce solutions that help merchants to launch their businesses.​ It has support for both physical and digital products, as well as services.​

osCommerce provides a complete package of solutions to different aspects of online business(features like billing, product display, multi-language options, different currencies, etc.)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.2checkout.com/connectors/connectors/integrate-oscommerce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
