# Device Configuration Overrides

Device configuration overrides are a feature of Finix devices that allow you to modify the configuration of a device for a single transaction.

## Overview

Sometimes, a single transaction needs different rules. Device configuration overrides let you temporarily adjust how a Finix terminal behaves—without changing its default settings. Using the override capability below gives you precise control.

Device configuration overrides are only supported in POS API Integrations.

## Prerequisites

- You must have a POS API Integration.
- You must have a terminal that supports device configuration overrides.
  - Pax A800
  - Pax A920Pro
- Payment App Version 4.5.0 or higher.


## Supported Overrides

Device configuration overrides is supported for the following features:

- Prompt for Tip


If there is a configuration override that is not listed above, please reach out to [Finix Support](mailto:support@finix.com) to submit the request.

## How to Use Device Configuration Overrides

Prompt for Tip
Overriding the Prompt for Tip Configration will determine if the devcie will prompt the customer for a tip in that specific transaction.

img
The example below shows how to override the `prompt_tip_on_screen` to `false` to prevent the device from prompting the customer for a tip regardless of the device configuration.

### Sample Request with Prompt for Tip Override


```shell Sale Request
curl -i -X POST \
    -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
    https://finix.sandbox-payments-api.com/transfers \
    -H 'Accept: application/hal+json' \
    -H 'Content-Type: application/json' \
    -H 'Finix-Version: 2022-02-01' \
    -d '{
        "amount": 150,
        "currency": "USD",
        "device": "DVcCqBNZQiarkAwjoYsExyNJ",
        "operation_key": "CARD_PRESENT_SALE",
        "device_configuration": {
            "prompt_tip_on_screen": false
        }
    }'
```

### Sample Response with Prompt for Tip Override


```json Prompt for Tip Response
{
    "id": "TRkaudFBuGvv4ArjateKKMfw",
    "created_at": "2025-05-08T18:59:45.16Z",
    "updated_at": "2025-05-08T18:59:45.16Z",
    "additional_buyer_charges": null,
    "additional_healthcare_data": null,
    "additional_purchase_data": null,
    "address_verification": null,
    "amount": 4,
    "amount_requested": 4,
    "application": "AP9xuCgCd3bi2eLGzbPis5yW",
    "card_present_details": {
        "emv_data": {
            "application_identifier": "A0000000031010",
            "application_label": "VISA CREDIT",
            "application_preferred_name": null,
            "application_transaction_counter": "01B4",
            "cryptogram": "ARQC 62ACBDCEDDF58F03",
            "issuer_code_table_index": null,
            "network_emv_response": null,
            "pin_verified": false,
            "tags": null
        },
        "masked_account_number": "411398******1014",
        "name": null,
        "brand": "VISA",
        "entry_mode": "CONTACTLESS",
        "payment_type": "CREDIT",
        "approval_code": "03725D",
        "digital_signature_file_id": null
    },
    "currency": "USD",
    "destination": null,
    "device": "DVcCqBNZQiarkAwjoYsExyNJ",
    "externally_funded": "FALSE",
    "failure_code": null,
    "failure_message": null,
    "fee": 0,
    "fee_profile": "FPn8SyC3wkWbGmkaQKprdjSW",
    "idempotency_id": null,
    "merchant": "MUi6m4mp2Cd4U7mWDS9u5Tms",
    "merchant_identity": "IDmboPwEiLn6KcKsmuBKL5Ln",
    "messages": [],
    "operation_key": "CARD_PRESENT_SALE",
    "parent_transfer": null,
    "parent_transfer_trace_id": null,
    "raw": null,
    "ready_to_settle_at": "2025-05-09T18:59:51.15Z",
    "receipt_last_printed_at": null,
    "security_code_verification": null,
    "source": "PItb7zqATwkt3P6ggN9LsNWp",
    "split_transfers": [],
    "state": "SUCCEEDED",
    "statement_descriptor": "Oscar Consulting",
    "subtype": "API",
    "supplemental_fee": null,
    "tags": {},
    "tip_amount": null,
    "trace_id": "FNXeATKUpcs5VeFJdNXXT9Pt7",
    "type": "DEBIT",
    "_links": {
        "application": {
            "href": "https://finix.live-payments-api.com/applications/AP9xuCgCd3bi2eLGzbPis5yW"
        },
        "self": {
            "href": "https://finix.live-payments-api.com/transfers/TRkaudFBuGvv4ArjateKKMfw"
        },
        "merchant_identity": {
            "href": "https://finix.live-payments-api.com/identities/IDmboPwEiLn6KcKsmuBKL5Ln"
        },
        "device": {
            "href": "https://finix.live-payments-api.com/devices/DVcCqBNZQiarkAwjoYsExyNJ"
        },
        "payment_instruments": {
            "href": "https://finix.live-payments-api.com/transfers/TRkaudFBuGvv4ArjateKKMfw/payment_instruments"
        },
        "reversals": {
            "href": "https://finix.live-payments-api.com/transfers/TRkaudFBuGvv4ArjateKKMfw/reversals"
        },
        "fees": {
            "href": "https://finix.live-payments-api.com/transfers/TRkaudFBuGvv4ArjateKKMfw/fees"
        },
        "disputes": {
            "href": "https://finix.live-payments-api.com/transfers/TRkaudFBuGvv4ArjateKKMfw/disputes"
        },
        "fee_profile": {
            "href": "https://finix.live-payments-api.com/fee_profiles/FPn8SyC3wkWbGmkaQKprdjSW"
        }
    }
}
```

If you have any questions or need assistance, please reach out to [Finix Support](mailto:support@finix.com).