# 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 Configuration will determine if the device 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).