Common issues with Payroc in Odoo Point of Sale and online payments.
Terminal never asks for the card
-
Confirm Use a Payment Terminal is Payroc (not Manual Entry).
-
Check Terminal Serial Number and Processing Terminal ID.
-
Confirm the provider API key matches Test vs Enabled.
-
Cancel the payment line in POS and tap Send again.
-
Confirm the device is online and on the same Payroc environment (sandbox vs live).
Manual Entry dialog fails or never loads
-
Provider must use a Payroc Cloud API key for the selected mode.
-
Processing Terminal ID must be set on the method and/or provider.
-
Allow the Hosted Fields script; ad blockers can block the dialog.
Refund: original payment reference not found
Payroc refunds need the original sale’s Payroc reference.
-
Start from Orders → open the original paid order → Refund.
-
Confirm that order was paid with Payroc (receipt shows a Payroc reference).
-
Do not create a brand-new return order with no link to the original lines.
Online checkout does not show Payroc / Card
-
Provider must be Published.
-
Card must be enabled under the provider’s payment methods.
-
Confirm the website/company payment provider settings include Payroc.
FAQ
Do we need two payment methods in POS?
Only if you use both a physical terminal and keyed Manual Entry. Many stores use just one.
Can we refund from Manual Entry if we sold on the terminal?
Yes, if both methods use Payroc and the refund is started from the original order. Odoo can resolve the original Payroc reference across Payroc methods.
Why did a “refund” show as a reversal?
If the original sale is still in an open batch, Payroc may reverse instead of posting a separate refund. The cardholder still gets the funds back.
Is card data stored in Odoo?
No raw PAN/CVV. Hosted Fields and tokens keep sensitive data with Payroc.
Still stuck?
Contact PBS support with:
-
Odoo version (17 or 18)
-
Test or Enabled
-
POS terminal vs Manual Entry vs online
-
Exact error message and approximate time of the attempt