# Tip Customization

Enable tip prompts on your Finix terminals to collect gratuities during the checkout experience. Whether you’re building a custom integration or using a plug-and-play terminal, Finix makes it easy to configure tip behavior that fits your business.

Tip customization is supported on all Finix-compatible terminals and can be managed through the Finix API or directly on the terminal or Dashboard.

Standalone
### Configure Tip Settings Directly on the Standalone Terminal

#### Prerequisites

Before customizing tip settings, make sure:

- Your terminal is powered on.
- It’s connected to the internet.
- The Finix Payment App is open.


## Configure Tips on the Terminal

You can configure tips directly from the terminal:

1. Navigate to the **Settings** menu on your terminal.
2. Click on **Checkout**.
3. Find the **Tipping** section.
4. Choose your preferred setup:
  - **No Tip** - Uncheck the two Tip related boxes
  - **Percentages** (e.g., 10%, 15%, 20%)
  - **Fixed Amounts** (e.g., $1, $2, $5)
5. Click **Save** to apply your changes.


#### Screenshots below show the configuration and tip settings screens

div
div
img
div
img
div
img
API
### Configure Tip Settings with the Finix API

Below is an example of how to configure tip settings via the Finix API. [View full API Reference](https://finix.com/docs/api/tag/Devices/#tag/Devices/operation/updateDevice).

#### Sample request


```shell Configure Tip Settings
curl https://finix.sandbox-payments-api.com/devices/DVc9sV7fddxiJQqjqNEKrETg \
    -H "Content-Type: application/json" \
    -H 'Finix-Version: 2022-02-01' \
    -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda \
    -X PUT \
    -d '{   "configuration": {
        "tipping_details": {
            "percent_tipping_threshold": 0,
            "percent_options": [
                20,
                30,
                35
            ],
        "fixed_options": [
                100,
                150,
                200
            ]
        }
    }
}'
```

#### Sample response


```json Configure Tip Settings Response
{
    "id": "DVc9sV7fddxiJQqjqNEKrETg",
    "created_at": "2025-04-20T23:33:55.600925Z",
    "updated_at": "2025-04-20T23:33:55.600925Z",
    "configuration_details": {
        "allow_debit": true,
        "check_for_duplicate_transactions": true,
        "prompt_amount_confirmation": true,
        "prompt_manual_entry": false,
        "signature_threshold_amount": 10000,
        "bypass_device_on_capture": true,
        "prompt_receipt_confirmation": true,
        "display_tip_on_receipt": false,
        "prompt_tip_on_screen": false,
        "allow_standalone_authorizations": false,
        "allow_standalone_sales": false,
        "allow_standalone_refunds": false,
        "tipping_details": {
            "percent_tipping_threshold": 0,
            "percent_options": [20, 30, 35],
            "fixed_options": [100, 150, 200]
        },
        "idle_message": null,
        "idle_image_file_id": null,
        "automatic_receipt_delivery_methods": ["PRINT", "EMAIL", "SMS"],
        "available_receipt_methods": ["PRINT", "EMAIL", "SMS"],
        "prompt_for_signature": "NEVER",
        "surcharge_basis_points": null
    },
    "description": "Cashier One",
    "enabled": false,
    "idle_message": null,
    "merchant": "MU7noQ1wdgdAeAfymw2rfBMq",
    "model": "PAX_A800",
    "name": "My PAX_A800 Finix Device",
    "serial_number": "19046260945",
    "tags": {},
    "_links": {
        "self": {
            "href": "https://finix.sandbox-payments-api.com/devices/DVc9sV7fddxiJQqjqNEKrETg"
        },
        "merchant": {
            "href": "https://finix.sandbox-payments-api.com/merchants/MU7noQ1wdgdAeAfymw2rfBMq"
        },
        "transfers": {
            "href": "https://finix.sandbox-payments-api.com/transfers"
        },
        "authorizations": {
            "href": "https://finix.sandbox-payments-api.com/authorizations"
        }
    }
}
```

Dashboard
### Configure Tips on the Dashboard

#### Prerequisites

Before updating the tip settings, ensure the following:

- The terminal is powered on.
- The terminal is connected to the internet.
- The Finix Payment App is open on the terminal.


#### Steps to Configure Tip Settings

1. Log in to the [Finix Dashboard](https://finix.payments-dashboard.com/).
2. Navigate to **Device Management**.
3. Select the device you want to configure.
4. Go to the **Configuration** section.
5. Choose your preferred **Tip Settings**.
6. Click **Save** to apply your changes.


#### Screenshots below show the configuration and tip settings screens

img
img
### Fixed Amounts vs. Percentage-Based Tips

- **Fixed Tip Amounts** allow you to offer set dollar amounts (e.g., $1, $2, $5) based on an amount you set.
- **Percentage-Based Tips** calculate the tip based on the transaction amount (e.g., 10%, 15%, 20%).


## Best Practices

- Choose tip options that match your business model and customer expectations.
- Test tip flows in the **Sandbox** environment before deploying to production.
- Use the API for dynamic tip control—disable for wholesale transactions or enable for service-based transactions.