# Prosegur Cash
Integrates Golfmanager POS with Prosegur cash machines (recyclers/dispensers) for automated cash handling.
## What does this module do?
- **Accept cash payments**: The machine receives bills and coins, calculates change automatically
- **Dispense refunds**: When refunding a sale, the machine dispenses the exact amount
- **Manual dispense**: Withdraw cash directly from the machine (e.g., petty cash)
- **Track all operations**: Every transaction is logged with full details
## Configuration
### POS Setup
Each POS that uses a Prosegur machine must be configured individually.
1. Go to **Settings > POS** and select the terminal
2. Find the **Prosegur** section and fill in:
| Field | Description | Example |
| --------- | --------------------------------------- | ----------------------------- |
| Host | Prosegur middleware URL (with port) | `https://192.168.1.100:15601` |
| Device ID | Cash machine identifier (12 characters) | `CashRecycler` |
| POS ID | Identifier for this terminal | `POS_RECEPTION` |
| Username | Middleware login username | `admin` |
| Password | Middleware login password | `****` |
3. Click **Test Prosegur Connection** to verify the configuration
4. Save
### Payment Method
The module creates a payment method called **Cash (Prosegur)**. This method:
- Supports both payments and refunds
- Is linked to the configured cash machine
## Usage
### Accepting Payments
1. Add items to the cart as usual
2. Click **Pay**
3. Select **Cash (Prosegur)** as payment method
4. A modal appears showing "Waiting for payment..."
5. Customer inserts cash into the machine
6. Machine calculates and dispenses change automatically
7. Modal closes when complete
8. Payment is registered in the system
**Note**: You can cancel at any time by clicking the Cancel button. Any deposited cash will be returned to the customer.
### Refunding with Cash
When refunding a sale that was paid differently (e.g., card), you can choose to refund in cash:
1. Select the sale(s) to refund
2. Click **Void**
3. Choose the refund option:
- **Void and refund**: Cancels the sale and refunds
- **Refund and leave pending payment**: Refunds but keeps sale as unpaid
4. Select **Cash (Prosegur)** as refund method
5. Machine dispenses the refund amount
### Manual Dispense
To withdraw cash directly (without a sale/refund):
1. In the POS, click the **Prosegur** folder
2. Click **Dispense**
3. Enter the amount
4. Click **Dispense**
5. Machine dispenses the requested amount
This is useful for petty cash or other operational needs. These transactions are marked as "Direct Dispense" in the transaction log.
### Viewing Transactions
To see all Prosegur operations:
1. In the POS, click **Prosegur > Transactions**
2. Or go to the Prosegur Transactions menu
Each transaction shows:
- **Type**: Sale (payment), Dispense (refund/withdrawal), or Cancel
- **Status**: Pending, Completed, Cancelled, Error, or Warning
- **Amounts**: Requested, deposited, dispensed, and any amount not dispensed
- **Related sales**: Which sales are linked to this transaction (if any)
## Transaction Statuses
| Status | Color | Meaning |
| --------- | ------ | ----------------------------------------- |
| Pending | Orange | Operation in progress |
| Completed | Green | Operation successful |
| Cancelled | Gray | Operation was cancelled |
| Error | Red | Operation failed |
| Warning | Orange | Partial success (e.g., not enough change) |
## Troubleshooting
### "Connection failed"
- Verify the Prosegur middleware is running on the local PC
- Check the Host URL is correct
- Ensure the PC and middleware are on the same network as the browser
### "CASH_SHORTAGE" warning
- The machine doesn't have enough coins/bills to give change
- The sale may still complete, but customer receives less change
### "CLAIMED" error
- Another POS is using the machine
- Wait for the other operation to complete
- Or cancel from the other terminal
### "BUSY" error
- Machine is processing another operation
- Wait a moment and try again
### Machine not responding
- Check the middleware PC is on and connected
- Restart the Prosegur middleware service if needed
- Use **Test Prosegur Connection** in POS settings to diagnose