Skip to content

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 to submit the request.

How to Use Device Configuration Overrides

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

Prompt for Tip

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

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_DEBIT",
        "device_configuration": {
            "prompt_tip_on_screen": false
        }
    }'

Sample Response with Prompt for Tip Override

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.