Point of Sale (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

​

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

​

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

​

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

​

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

​

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

​

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 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 [email protected]
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

​

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

​

Video Tutorial

Watch the complete setup and configuration process:

​

Troubleshooting

​

Terminal doesn’t activate when payment is initiated

• Verify your API key is correct and active in the Compago Dashboard
• 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
• 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 [email protected] for assistance with terminal or payment processing issues