TerminalConfigUpdateV2

  • batch_schedule
    Type: object | null · Batch Schedule

    Automated batch close/open schedule. Set to configure Netevia-managed batch scheduling. Set to null to remove and revert to manual management. Omit to leave unchanged. Only supported for TSYS, Elavon, and Worldpay terminals.

    • is_active
      Type: boolean

      Whether the schedule is active. Default true.

    • schedule
      Type: array object[]

      Days and times for batch close. Omit a day for no close.

    • timezone
      Type: string

      US timezone for schedule. DST-aware zones recommended (e.g., US/Eastern). Fixed-offset zones (EST, MST, HST) and UTC also supported.

  • description
    Type: string | null · Description
  • mid
    Type: string | null · Mid

    Merchant ID

  • name
    Type: string | null · Name
  • surcharge_basis
    Type: string | null · Surcharge Basisenum

    What the surcharge is calculated on. Resolved most-specific-first: terminal, then location, then account. A null at the terminal or location level inherits from the level above; a null at the account level leaves it unset.

    values
    • total
    • subtotal
    • subtotal_plus_tax
    • subtotal_plus_tip
    • null
  • surcharge_confirmation_required
    Type: boolean | null · Surcharge Confirmation Required

    Whether the cardholder must confirm the surcharge before the sale proceeds. When true, sale/preauth returns a surcharge-pending state that must be confirmed before the transaction completes. Resolved most-specific-first: terminal, then location, then account. A null at the terminal or location level inherits from the level above; a null at the account level defaults to no confirmation.

  • surcharge_rate
    Type: number | null · Surcharge Rate

    Surcharge percentage (e.g., 3.5 for 3.5%). Resolved most-specific-first: terminal, then location, then account. A null at the terminal or location level inherits the value from the level above; a null at the account (root) level disables automatic surcharge logic (no surcharge is applied). 0 means surcharges are never applied unless explicitly overridden.

  • tax_basis
    Type: string | null · Tax Basisenum

    What the tax is calculated on. Resolved most-specific-first: terminal, then location, then account. A null at the terminal or location level inherits from the level above; a null at the account level leaves it unset.

    values
    • total
    • subtotal
    • null
  • tax_rate
    Type: number | null · Tax Rate

    Tax percentage (e.g., 8.25 for 8.25%). Resolved most-specific-first: terminal, then location, then account. A null at the terminal or location level inherits from the level above; a null at the account level disables tax defaults.

  • tid
    Type: string | null · Tid

    Terminal ID

  • var_sheet
    Type: object | null · Var Sheet

    Processor-specific configuration (e.g., TSYS VAR sheet data)