# 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 per-transaction tip control: disable for wholesale transactions or enable for service-based transactions.