1. Introduction

The POS Wallee Payment Acquirer Plugin from PIT Solutions offers a seamless and efficient solution for Odoo POS merchants in Europe and Switzerland. By automating the payment process, this plugin eliminates the need for manual payment entry, reducing checkout times and minimizing human errors.

Traditionally, Odoo POS merchants faced the challenge of manually entering payment amounts into their payment terminals. This time-consuming and error-prone process often led to longer checkout times and difficulties in reconciling orders.

The Wallee POS Payment Terminal Plugin addresses these issues by:

  • Automating Payment Processing: Eliminating manual data entry and reducing the risk of human errors.
  • Streamlining the Checkout Process: Providing a faster and more efficient payment experience for both merchants and customers.
  • Enhancing Accuracy: Ensuring that payment amounts are accurately transferred from the Odoo POS to the Wallee payment terminal.
  • Increasing Efficiency: Optimizing the checkout process and reducing operational costs.
  • Enhancing Customer Satisfaction: Delivering a faster and more convenient payment experience.
  • Ensuring Compliance: Benefiting from Wallee's adherence to industry security standards.

2. Features

  • Reduced Checkout Time
    • Faster Payments: Streamline the payment process, reducing wait times for customers.
    • Improved Customer Satisfaction: Provide a more efficient and enjoyable shopping experience.
  • Easy Integration
    • Seamless Integration: Effortlessly integrate the plugin into your Odoo POS system.
    • Minimal Setup: Get up and running quickly with minimal configuration.
  • Enhanced Security
    • Secure Transactions: Benefit from Wallee's robust security measures to protect customer data.
    • Compliance: Adhere to industry standards for payment security.
  • Improved Accuracy
    • Eliminate Errors: Prevent manual data entry mistakes and ensure accurate payment processing.
    • Streamline Reconciliation: Simplify the reconciliation process with accurate transaction data.
  • Additional Enhancements
    • Implemented Wallee Payment Python Library.
    • Implemented refunds for all POS orders.
  • Supported Payment Connectors
    • American Express, Dankort, Diners Club, Mastercard, Visa.

3. Working 

The POS Wallee Payment Acquirer Plugin establishes a connection between Odoo POS users and the Wallee payment gateway via a payment terminal. This integration uses REST APIs to enable seamless communication and data exchange between the plugin and the Wallee payment platform.

Screenshot 1: Payment Providers Listed in Odoo Backend

You can access the payment providers through the following menu option:

Invoicing > Configuration > Payment Providers

These paths will direct you to the configuration settings for managing payment providers.

Screenshot 2: Odoo Backend Configuration of Wallee Credentials

After selecting the Wallee Payment Provider from the list, navigate to the Credentials tab. In this section, you can enter the credentials for your Wallee Payment Provider space.

To configure the Wallee Payment Provider in Odoo, you will need the following details from Wallee:

  1. REST API User ID: The Application User ID created on app-wallee.com.
  2. REST API Space ID: The Space ID obtained from app-wallee.com.
  3. Application Key: The Application Key generated on app-wallee.com.
  4. REST API Terminal ID: The identifier of the terminal to be used for processing transactions.

After entering these details, you can set the status to 'Enabled' for live transactions or 'Test Mode' for testing purposes.

Screenshot 3: Create POS Payment Method for Wallee

To create a POS payment method for Wallee, navigate to Point of Sale > Configuration > Payment Methods. From this screen, click on the 'New' button to create a new payment method.

Then create a new payment method, naming it "Wallee." Assign a suitable journal for tracking Wallee transactions. Under the "Payment Provider" field, select "Wallee Payment Providers." Finally, choose the “Terminal" option from Integration and select "Wallee" from Integrate with option.

Screenshot 4: POS Payment Method Configuration for Wallee

After creating the POS payment method, go to the Point-of-Sale settings, navigate to the Payment section, and add Wallee to the Payment methods available field.

Also, enable the 'Automatically validate order' option if you prefer to automatically validate orders when they are paid using a payment terminal

Screenshot 5: Odoo POS Product Screen

After the POS payment method configuration, go to the POS interface and select the desired products for the customer, choose an existing customer or create a new one, and then proceed to the payment screen.

Screenshot 6: Odoo POS Payment Screen

From this screen select the Wallee payment method.

After selecting the Wallee payment method, initiate the payment request and send it to the Wallee payment gateway for processing

Screenshot 7: Wallee POS Payment Terminal

In the Wallee POS payment terminal, the payment amount will be displayed. Choose the card from the terminal and enter your PIN to complete the transaction.

Screenshot 8: Wallee POS Payment Terminal PIN Entering Screen

You can enter your PIN to complete the transaction after selecting the card.

Screenshot 9: Wallee POS Payment Terminal Payment Success

If the transaction is success, then you can see the payment success message in the POS terminal.

Screenshot 10: Odoo POS Payment Success Status

Upon successful payment, you can see the "Payment Successful" status displayed on the Odoo POS payment screen. If you haven't enabled the 'Automatically validate order' setting, the 'Validate' button will become active, allowing you to manually validate the order.

Screenshot 11: Odoo POS Order Validated Screen 

Once the order is validated, you can see this screen in Odoo. From here you can send and print the order receipt by clicking the paper plane icon button and the ‘Print Receipt’ button respectively. 

Screenshot 12: Wallee Payment Successful Email to Customer

If a customer is selected during the payment process, an email will be sent to the customer mentioning the confirmation of payment along with the amount paid.

Screenshot 13: Wallee Payment Cancelled Screen

If the transaction is failed, then you can see the below error messages in Wallee and Odoo respectively. 

Screenshot 14: Odoo POS Payment Cancelled Screen

If the transaction fails in Odoo and is not cancelled from the Wallee terminal, you need to manually cancel it from the Wallee terminal.

Screenshot 15: Wallee Payment Cancelled/Failed Email to Customer

If the transaction is cancelled from the Wallee terminal during the payment process, an email will be sent to the customer mentioning the cancellation/failure of payment.

Screenshot 16: Odoo POS Order Screen

After a successful payment, order/transaction details will be recorded in Odoo under the Orders menu and in Wallee under the Transactions menu.

Screenshot 17: Payment Transaction in Wallee Back Office

Screenshot 18: Refund option from the pos order

For refund, click on the “Return Product Button” in the order

Then, a refund POS order will be created. We can set the quantity for the refund and click on the Payment button. A pop-up will appear, allowing us to change the payment method to Wallee and proceed with the payment.

Screenshot 19: Payment Method Popup for Refund option from the pos order

Screenshot 20: Refund in Wallee Back Office

Screenshot 21: Wallee Payment Refund Email to Customer

If a customer is selected during the payment process, an email will be sent to the customer mentioning the refund of payment along with the refund amount.

Screenshot 22: Refund option through POS Store

The refund through POS store can be done clicking on Actions button followed by clicking Refund button.

Screenshot 23: Refund option through POS Store

Select the order that should be refunded and click on the Refund button.

Screenshot 24: POS Store Refund Payment

Select the Wallee payment and the refund transaction will be completed automatically.

Screenshot 25: Validation for selecting non Wallee payment method

If Wallee refund transaction is tried on a non-Wallee order, a validation error will be displayed as “No Wallee transactions found for the original order.” 

Screenshot 26: Validation for selecting Wallee payment method in another Space ID

If Wallee Payment was completed through payment method say “wallee” and for refund if selected payment method “wallee 2” in another space ID, a validation error will be displayed as “The refunded order line has a different space ID than the selected wallee payment method.”

4. Technical Requirements / Compatible With: 

  • Technical Requirements: Odoo Point of Sale, Payment, and Invoice modules.
  • Compatibility: Odoo Community Edition v18.0. 

5. Changes Log / Release Notes

  • Version 1.0.0: February 2025
    • Initial release.

6. Support

If you have questions, use our contact form at webshopextension.com or email at support@webshopextension.com