PayperCloud Servipay - Point of Sale (Odoo 19)

This module connects Odoo POS payment terminals to Servipay through PayperCloud API. It extends POS configuration and payment methods so cashier payments can be sent to the physical terminal and tracked until final status.

Main Features

• POS payment terminal provider: Servipay (PayperCloud)
• POS-level configuration for POS ID, Terminal ID and API Key
• Terminal payment flow from POS screen
• Uses base client from module paypercloud_servipay

Terminal Payment Flow

• Send purchase request
• Poll operation status
• Fetch operation result
• Cancel operation

Requirements

• Odoo 19
• Installed module paypercloud_servipay
• Installed app point_of_sale
• At least one working Servipay terminal

Installation

1. Ensure module paypercloud_servipay is already installed and configured.
2. Install module PayperCloud Servipay - Point of Sale.

Configuration

1. Open Point of Sale > Configuration > Point of Sale.
2. Open your POS and fill section Servipay (PayperCloud).
3. Open Point of Sale > Configuration > Payment Methods.
4. Create or edit a payment method used for terminal payments.
5. Set Use a Payment Terminal = Servipay (PayperCloud).
6. Attach this payment method to the target POS.

Servipay POS configuration fields:

• Servipay POS ID
• Servipay Terminal ID
• Servipay API Key

If POS API key is set, it is used first. If empty, the system falls back to the global key from paypercloud_servipay settings.

Usage

1. Start a POS session.
2. Add products to an order.
3. Select the payment method configured with Servipay (PayperCloud).
4. Confirm payment request.
5. Complete or cancel transaction on physical terminal.
6. POS waits for terminal status and updates the payment line accordingly.

Recommended Rollout

1. Configure and test in demo/sandbox environment first.
2. Validate end-to-end payment/cancel scenarios on one POS.
3. Deploy configuration POS by POS in production.

Closing Register - Z-Terminal button

At POS closing, a button Z-Terminal is displayed next to Close Register when Servipay is configured on the POS.

When clicked, it calls Servipay endpoint Create reconciliation for the terminal configured on the current POS.

• Uses Servipay POS ID and Servipay Terminal ID from the POS configuration.
• Uses Servipay API Key from the POS if set, otherwise falls back to global API key.
• Shows a success notification when the request is accepted.
• Shows an error dialog if configuration is missing or Servipay returns an error.

Troubleshooting

• Missing configuration on POS: ensure POS ID and Terminal ID are set on the POS configuration.
• Authorization failures: check POS API key first, then global key fallback.
• No response from terminal: verify terminal connectivity and PayperCloud endpoint access.
• Operation status unclear: check technical logs in PayperCloud / Servipay > API Logs.

Documentation (FR)

Ce module connecte les terminaux de paiement Odoo POS a Servipay via l'API PayperCloud. Il etend la configuration du POS et les methodes de paiement afin d'envoyer les paiements au terminal physique puis de suivre leur statut jusqu'au resultat final.

Support

Company: DPHI SRL

Contact: cdu@dphi.be