> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compago.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Point of Sale (POS)

> Process card-present payments with Compago terminals directly from your Odoo POS.

The Compago Point of Sale plugin integrates physical payment terminals with your Odoo POS system, enabling seamless card-present transactions. When a customer is ready to pay, the Compago terminal automatically opens with the transaction amount, processes the payment, and updates the order in Odoo, all without leaving your POS workflow.

## What You Can Do

With the Point of Sale plugin, you can:

* **Process Card-Present Payments**: Accept chip, swipe, and contactless card payments through Compago terminals
* **Seamless POS Integration**: Compago appears as a native payment method in your Odoo POS
* **Automatic Terminal Communication**: Transaction amounts are sent directly to the terminal
* **Multi-Device Support**: Trigger payments from the POS device or external devices
* **Payment Totem Integration**: Support unattended payment kiosks and self-service terminals
* **Real-Time Synchronization**: Payment results are immediately reflected in Odoo

## Use Cases

This plugin is ideal for:

* Retail stores processing in-person card payments
* Restaurants and cafes with table-side or counter payments
* Service businesses accepting payments at the point of service
* Events and pop-up shops using mobile terminals
* Self-service kiosks with integrated payment totems

## How It Works

Here's the complete payment flow:

1. **Create Order**: Cashier adds products to the cart in Odoo POS
2. **Initiate Payment**: Cashier clicks **Pay** and selects **Compago** as the payment method
3. **Terminal Activation**: The Compago terminal automatically opens with the transaction amount
4. **Customer Pays**: Customer presents their card (chip, swipe, or contactless)
5. **Payment Processing**: Compago terminal processes the card-present transaction
6. **Result Confirmation**: Payment result is displayed on the terminal
7. **POS Update**: Odoo POS is automatically updated with the payment status
8. **Receipt & Completion**: Order is finalized and receipt can be printed

<Tip>
  The terminal can be triggered from the POS device itself, an external device (like a tablet or phone), or integrated with a payment totem for self-service scenarios.
</Tip>

## Installation

### Step 1: Download the Plugin

Visit the Odoo App Store and download the Compago Point of Sale Integration:

**Download link**: [https://apps.odoo.com/apps/modules/18.0/pos\_compago](https://apps.odoo.com/apps/modules/18.0/pos_compago)

<Note>
  You must have an **Odoo.sh instance** to install custom apps. Self-hosted or community editions may not support third-party POS integrations.
</Note>

### Step 2: Install the Plugin in Odoo.sh

1. Log in to your **Odoo.sh** dashboard
2. Navigate to your instance
3. Upload and install the `pos_compago` module
4. Restart your instance if required

### Step 3: Activate the Plugin

Once the module is uploaded to your Odoo.sh instance:

1. Open your Odoo instance
2. Go to **Apps** (you may need to enable Developer Mode)
3. Remove the "Apps" filter to show all modules
4. Search for **"Compago"** or **"POS Compago"**
5. Click **Activate** on the Compago POS Integration module

<Tip>
  If you don't see the module, click **Update Apps List** to refresh the module catalog.
</Tip>

## Configuration

### Step 1: Ensure Prerequisites

Before configuring the plugin, verify:

* The **Point of Sale** app is installed
* Your company is configured in **MXN currency**
* You have at least one bank journal configured in **MXN**
* You have a Compago physical terminal or terminal access

<Warning>
  The plugin will not work correctly if your company or journal is not configured in MXN. All POS sessions and payment methods must use MXN currency.
</Warning>

### Step 2: Create or Configure a Point of Sale

If you don't already have a POS configured:

1. Navigate to **Point of Sale** → **Configuration** → **Settings**
2. Create a new POS or select an existing one
3. Ensure the POS is configured to use **MXN currency**

<Note>
  Each POS can have different payment methods configured. You'll add Compago as a payment method in the following steps.
</Note>

### Step 3: Create a Compago Payment Method

1. Navigate to **Point of Sale** → **Configuration** → **Payment Methods**
2. Click **New** to create a new payment method
3. Configure the following fields:

   **Basic Information:**

   * **Name**: Enter a descriptive name (e.g., `Compago`, `Compago Terminal`, `Card Payment`)

   **Journal:**

   * **Journal**: Select a **Bank** journal from the dropdown
   * Verify the journal is configured in **MXN currency**

   **Integration Type:**

   * **Use a Payment Terminal**: Enable this option (or select **Terminal** from integration options)
   * **Integrate with**: Select **Compago** from the dropdown

<Tip>
  Once you select "Compago" as the integration, additional Compago-specific fields will appear in the form.
</Tip>

### Step 4: Configure Compago Credentials

After selecting Compago as the integration, two new fields will appear:

1. **API Key**:
   * Paste your Compago API key
   * Generate your API key from the [Compago Dashboard](https://app.compago.com) if you haven't already

2. **Environment**:
   * Select **Production** for live transactions (recommended)
   * Select **Demo** for testing without processing real payments
   * Select **Local** only if instructed by Compago support at **[help@compago.com](mailto:help@compago.com)**

3. **Save** the payment method

### Step 5: Add the Payment Method to Your POS

1. Navigate to **Point of Sale** → **Configuration** → **Settings**
2. Select the POS you want to enable Compago for (if you have multiple)
3. Scroll to the **Payments** section
4. In the **Payment Methods** field, add the Compago payment method you just created
5. **Save** the settings

<Note>
  You can configure multiple payment methods for a single POS. Compago will appear alongside your other payment options.
</Note>

## Using Compago in Your POS

Once configured, using Compago for card-present payments is simple:

### Making a Payment

1. Open your Odoo POS session
2. Add products to the cart as usual
3. When ready to accept payment, click **Payment**
4. Select the **Compago** payment method
5. The payment amount is automatically sent to the Compago terminal
6. The terminal will activate and display the transaction amount
7. Have the customer present their card to the terminal
8. The terminal processes the payment
9. Once complete, the POS is automatically updated with the result
10. Print the receipt or complete the order

### Payment Modes

The Compago terminal supports multiple payment flows:

* **Terminal-Initiated**: Payments triggered directly from the terminal device running Odoo POS
* **Remote-Initiated**: Payments triggered from an external device (tablet, phone, or workstation) that controls the terminal
* **Totem-Integrated**: Unattended payment kiosks where customers initiate and complete payments themselves

All modes work seamlessly with the same Odoo POS configuration.

## Testing the Integration

To verify the integration is working:

1. Open a new POS session
2. Add a test product to the cart
3. Click **Payment** and select **Compago**
4. Verify the terminal activates with the correct amount
5. Use a test card (if in demo environment) or a real card (if in production)
6. Complete the payment on the terminal
7. Confirm the POS updates with the payment status
8. Close the order and verify it appears in your sales records

<Warning>
  If testing in production, use a small amount and a real payment method. The transaction will be processed and charged.
</Warning>

## Video Tutorial

Watch the complete setup and configuration process:

<Note>
  **Video coming soon**: A step-by-step walkthrough showing the installation, configuration, terminal activation, and first test payment.
</Note>

## Troubleshooting

### Terminal doesn't activate when payment is initiated

* Verify your API key is correct and active in the [Compago Dashboard](https://app.compago.com)
* Ensure the environment setting matches your API key (production vs. demo)
* Check that the terminal is powered on and connected to the network
* Verify the terminal is linked to your Compago account

### Payment fails with currency error

* Ensure your company is configured in MXN
* Verify the selected journal is in MXN currency
* Check that the POS is configured to use MXN
* Ensure all products are priced in MXN

### Payment method doesn't appear in POS

* Verify the plugin is activated in **Apps**
* Ensure the payment method is added to your POS in **Settings** → **Payment Methods**
* Restart your POS session
* Clear your browser cache if using a web-based POS

### Terminal shows wrong amount

* Verify the product prices are correct and in MXN
* Check for any taxes or discounts that may affect the total
* Ensure the POS currency matches the terminal currency (MXN)

## Terminal Hardware

The Compago POS integration works with Compago-provided physical payment terminals. These terminals support:

* **Chip & PIN** (EMV)
* **Contactless** (NFC)
* **Magnetic Stripe** (swipe)
* **Mobile Wallets** (Apple Pay, Google Pay)

Contact Compago to order terminals or inquire about compatible hardware models.

## Support

If you encounter issues with the Compago POS plugin:

* Check your API key is valid in the [Compago Dashboard](https://app.compago.com)
* Verify the terminal is online and connected
* Review Odoo logs for detailed error messages
* Ensure your network allows communication between Odoo and Compago's API
* Contact Compago support at **[help@compago.com](mailto:help@compago.com)** for assistance with terminal or payment processing issues