Index
What is this integration?
The Prosegur Cash integration connects the Golfmanager POS with Prosegur cash machines (note and coin recyclers and dispensers). It lets you take cash payments automatically: the machine receives the money, calculates and gives the change, and also handles refunds and cash withdrawals.
A cash machine (recycler) is a device that counts, stores and returns notes and coins. This integration makes the POS "talk" to the machine to take payment, give change and record everything automatically.
What problem does it solve?
Automates cash collection and change calculation, with no manual handling of money.
Reduces errors and till discrepancies.
Improves security: the cash stays in the machine, not in a drawer.
Keeps a record of every payment, refund or withdrawal.
What does it let you do?
Function | What it does |
Cash payment | The machine receives the money and gives the change automatically |
Refund | The machine dispenses the amount to be refunded |
Manual withdrawal | Take cash out of the machine (for example, for petty cash) |
Operation log | Every movement is recorded with its detail |
Which systems does it connect and in which direction does the data travel?
It connects the Golfmanager POS with the Prosegur machine through an intermediate program (middleware) installed on a PC in the club's local network:
Golfmanager asks the machine to take payment, give change, refund or dispense.
The machine carries out the operation and returns the result (paid, dispensed, change, etc.).
Golfmanager records the operation and marks the sale.
The communication is real time and within the club's local network (it does not go over the internet).
Prerequisites (before enabling the integration)
Have a Prosegur cash machine installed at the club.
Have the Prosegur middleware running on a PC in the local network (the same network as the POS browser).
Have the Prosegur Cash module installed, together with the POS and invoicing modules.
The connection data for the machine and the middleware (Host, Device ID, POS ID, username and password).
Administration permissions to configure it.
How to set it up (step by step)
The machine is configured on each POS that uses it. Each terminal with a Prosegur machine is configured separately.
Go to Settings > POS.
Select the terminal that uses the Prosegur machine.
Find the Prosegur Cash section.
Enter the Host (middleware URL with its port, for example
https://192.168.1.100:15601).Enter the Device ID (machine identifier, for example
CashRecycler).Enter the POS ID (identifier of this terminal, for example
POS_RECEPTION).Enter the Username and Password of the middleware.
Click "Test Prosegur Connection" to verify that the configuration is correct.
Save the changes.
⚠️ Always use "Test Prosegur Connection" after configuring. The password is stored encrypted. Remember that each terminal with a Prosegur machine is configured individually.
The configuration fields in detail
These are the fields in the Prosegur Cash section within each POS's settings.
1) Host
• Field name: Prosegur Host
• Description: The address (URL) of the Prosegur middleware, including the port. It is the PC on the local network that talks to the machine.
• Impact on the system: It tells Golfmanager where to find the machine. If it is incorrect or the middleware is not running, there will be no connection.
• Usage example: you enter https://192.168.1.100:15601.
What happens when it is used: the POS sends the orders (take payment, dispense…) to that address.
System behavior: a wrong address causes a "Connection failed" error.
2) Device ID
• Field name: Prosegur Device ID
• Description: The identifier of the cash machine (usually 12 characters).
• Impact on the system: It identifies which machine the orders are directed to.
• Usage example: you enter CashRecycler.
What happens when it is used: operations are directed to that specific machine.
System behavior: a wrong ID prevents operating with the machine.
3) POS ID
• Field name: Prosegur POS ID
• Description: The identifier of this terminal to the Prosegur middleware.
• Impact on the system: It lets the machine know which POS requests each operation (useful when several terminals share the machine).
• Usage example: you enter POS_RECEPTION.
What happens when it is used: that POS's operations are identified with that ID.
System behavior: it helps manage the machine being used in turns between terminals.
4) Username
• Field name: Prosegur Username
• Description: The username to authenticate to the Prosegur middleware.
• Impact on the system: Required for the middleware to accept the requests.
• Usage example: you enter admin.
What happens when it is used: together with the password, it authenticates the POS to the middleware.
System behavior: wrong credentials prevent the connection.
5) Password
• Field name: Prosegur Password
• Description: The middleware user's password. It is stored encrypted.
• Impact on the system: It completes the authentication with the middleware.
• Usage example: it is provided by the technician who installs the middleware.
What happens when it is used: it allows the connection with the machine to be established.
System behavior: if it is incorrect, the connection fails.
ℹ️ Next to these fields there is a "Test Prosegur Connection" button: it is not a field, but a check that validates the entered data before saving. Always use it after changing the configuration.
The "Cash (Prosegur)" payment method
The module automatically creates a payment method called "Cash (Prosegur)". This method:
Supports payments and refunds against the machine.
Is linked to the machine configured on that POS.
Is the one you must select when taking payment or refunding when you want to use the cash machine.
How it is used day to day
Taking a cash payment
Add the products to the cart as usual.
Click Pay.
Select "Cash (Prosegur)" as the payment method.
The "Waiting for payment…" window appears.
The customer inserts the cash into the machine.
The machine calculates and gives the change automatically.
The window closes and the payment is recorded.
You can cancel at any time by clicking Cancel; the cash already inserted is returned to the customer.
Refunding in cash
When voiding a sale (even if it was paid by another method, such as card) you can refund in cash:
Select the sale(s) to refund.
Click Void.
Choose the option: Void and refund, or Refund and leave the payment pending.
Select "Cash (Prosegur)" as the refund method.
The machine dispenses the refund amount.
Manual withdrawal (direct dispense)
To take cash out without a sale or a refund (for example, petty cash):
In the POS, open the Prosegur folder.
Click Dispense.
Enter the amount.
Click Dispense again to confirm.
The machine dispenses the requested amount.
These operations are marked as "direct dispense" in the transaction log.
Viewing the operations
In Prosegur > Transactions (from the POS or the Prosegur Transactions menu) you will see each operation with its type (payment, dispense or cancellation), its status, the amounts (requested, deposited, dispensed and not dispensed) and the related sales.
Operation statuses
Status | Color | Meaning |
Pending | Orange | Operation in progress |
Completed | Green | Operation carried out successfully |
Cancelled | Gray | Operation cancelled |
Error | Red | Operation failed |
Warning | Orange | Partial success (for example, insufficient change) |
Limitations to keep in mind
It needs the Prosegur middleware running on the local network; otherwise there is no connection with the machine.
Each POS is configured separately with its machine.
A machine is used by one POS at a time: if another is using it, you have to wait.
If the machine is short of change, the payment may complete but the customer receives less change (warning).
It works on the local network: the middleware PC must be on and on the same network as the POS.
Frequently asked questions
What is the Prosegur "middleware" and why do I need it?
It is a small program installed on a club PC that acts as a bridge between Golfmanager and the cash machine. Without it running, the POS cannot communicate with the machine.
I get "Connection failed". What should I check?
Check that the middleware is running, that the Host URL is correct and that the middleware PC is on the same network as the POS browser. Then use "Test Prosegur Connection".
The "CASH_SHORTAGE" warning appears. What does it mean?
The machine does not have enough coins or notes to give the change. The sale can still complete, but the customer will receive less change. It is advisable to refill cash in the machine.
The "CLAIMED" error appears. What do I do?
Another POS is using the machine at that moment. Wait for the other operation to finish or cancel it from the other terminal.
The "BUSY" error appears. What do I do?
The machine is processing another operation. Wait a moment and try again.
The machine does not respond.
Check that the middleware PC is on and connected. If needed, restart the middleware service and use "Test Prosegur Connection" to diagnose.
Can I cancel a payment halfway through?
Yes. While it is "Waiting for payment…" you can click Cancel: any cash the customer has already inserted is returned to them.
Can I refund in cash a sale that was paid by card?
Yes. When voiding, you can choose to refund with "Cash (Prosegur)" and the machine dispenses the amount, even if the original payment was by another method.
What is a "direct dispense"?
It is a cash withdrawal from the machine with no associated sale or refund (for example, for petty cash). It is recorded with that label.
Can the same machine serve several POS terminals?
Yes, but one at a time. Each POS is configured separately and, if the machine is busy, the others must wait (you will see "CLAIMED" or "BUSY").
Where do I check whether an operation completed?
In Prosegur > Transactions. Each operation shows its status (Pending, Completed, Cancelled, Error or Warning) and the amounts.
Is the middleware password stored securely?
Yes, the password is stored encrypted in the POS settings.
Does this integration go over the internet?
No. The communication is local, within the club's network, between the POS, the middleware and the machine.
Recommended best practices
Check the connection ("Test Prosegur Connection") after configuring or whenever there is a problem.
Keep the middleware and the PC on and on the same network as the POS.
Watch the machine's cash level so it never runs short of change.
Review the transactions whenever there is any doubt about the till balance.
Configure each POS with its correct Device ID and POS ID.
Need help?
If you have questions about the configuration, the connection with the machine or an operation that does not complete, our support team is available to help you. Write to us through the blue bubble in your management software. For installing the middleware and maintaining the machine (refilling cash, breakdowns…), also contact Prosegur, who supplies and maintains the equipment.