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

• 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.

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 '{\n        "amount": 150,\n        "currency": "USD",\n        "device": "DVcCqBNZQiarkAwjoYsExyNJ",\n        "operation_key": "CARD_PRESENT_SALE",\n        "device_configuration": {\n            "prompt_tip_on_screen": false\n        }\n    }'\n```

### Sample Response with Prompt for Tip Override

Prompt for Tip Response

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