Back to Top

User Guide for Odoo POS Square Terminal Pay

Updated 9 December 2025

INTRODUCTION

Odoo POS Square Terminal Pay connects Square Terminals with your Odoo POS system for fast and secure in-store payments.

The module integrates your POS interface with Square, enabling you to accept card payments seamlessly throughout the POS.

With this module, you can configure Square API keys, pair devices, monitor real-time terminal status, and review transaction history.

 It ensures a smooth checkout experience by sending payment requests directly to the Square Terminal.

FEATURES

  1. Configure Square Terminal using API keys and details.
  2. Generate secure device codes for terminal pairing.
  3. Monitor Square Terminal status in real time.
  4. Odoo POS Square Terminal Pay enables Square as a POS payment option.
  5. Map Square payments with the correct accounting journals.
  6. Track Square transactions with clear payment logs.
  7. Maintain a full history of completed Square payments.
  8. Support multiple terminals across store locations.
  9. Ensure fast and secure card payment processing.

INSTALLATION

  1. Once you purchase App from the Webkul store, you will receive a link to download module’s zip file.
  2. Extract the file on your system after download finishes. As a result, you will be able to see a folder named ‘pos_square_terminal_pay.
  3. Copy and paste this folder inside your Odoo Add-Ons path.
  4. Now, open Odoo App and click on the Settings menu. Here, click on Activate Developer Mode.
  5. Then, open Apps menu and click on ‘Update Modules List.’
  6. In search bar, remove all the filters and search ‘pos_square_terminal_pay.
  7. You will be able to see the module in the search results. Click on ‘Activate’ to install it.

WORKFLOW

1. Configure Terminal API Settings

Add Square API key, device details, and location ID to establish a secure connection. This configuration links Odoo POS with your Square Terminal for real-time communication.

Start your headless eCommerce
now.
Find out More
terminal-api-configuration

2. Start Terminal Pairing

Select the terminal you want to connect to and verify its details. Use “Create Device Code” button to begin the pairing process.

create-device-code

3. Generate the Device Code

A unique device code is generated instantly for terminal authentication. Enter this code on your Square Terminal within the validity time.

generated-device-code

4. Enable Square as a Payment Method

Activate Square inside POS payment settings to process card payments through terminal. Choose appropriate journal and assign the correct terminal device.

square-payment-setup

5. Process Payments Using Square Terminal

At checkout, select “Square” as the payment method and send the payment request. The terminal prompts the customer to complete the transaction securely.

processing-payment-on-square-terminal

6. View Square Transaction Details

Access a dedicated menu to review transaction information, including amount, status, and device ID. This section helps you track all payments processed through Square inside Odoo.

square-transaction-details

NEED HELP?

Hope you find guide helpful! Please feel free to share your feedback in the comments below.

If you still have any issues/queries, please create a ticket at the UV Desk.

I hope this helps. In case of any further queries, contact us at support@webkul.com.

Thanks for paying attention!!

Current Product Version - 1.0.0

Supported Framework Version - Odoo 19, 18, 17

. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

User Guide for Odoo POS Square Terminal Pay