tipping.md

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.

Configure Tip Settings Directly on the Standalone Terminal

Prerequisites

Before customizing tip settings, make sure:

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.

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.

Sample request

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

{
    "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"
        }
    }
}

Configure Tips on the Dashboard

Prerequisites

Before updating the tip settings, ensure the following:

Steps to Configure Tip Settings

  1. Log in to the Finix Dashboard.
  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.

Fixed Amounts vs. Percentage-Based Tips

Best Practices