Acquirer connections

Update an acquirer connection

Patches the mutable fields only: priority, currencies, card_types. Changing currencies / card_types re-evaluates which underlying processors stay active. card_types is narrowed to each processor's routable set, so a PATCH can't enable a scheme the acquirer can't settle. The acquirer and the MID/TID (merchant_id / terminal_id) are immutable once the connection exists.

patch/merchants/{username}/acquirers/{conn_id}

Request

Base URL
https://gateway.pmnts.io/v2/partners
URL
https://gateway.pmnts.io/v2/partners/merchants/{username}/acquirers/{conn_id}
Auth
HTTP basic

Request body

priorityinteger

currenciesstring[]

card_typesstring[]

Narrowed to the acquirer's routable set; schemes the acquirer can't settle are dropped rather than applied.

Example request

{
  "priority": 10,
  "currencies": [
    "AUD",
    "NZD"
  ],
  "card_types": [
    "visa",
    "mastercard"
  ]
}

Response

The updated connection.

acquirer_namestring nullable required

The acquirer's display name (e.g. NAB).

merchant_idstring nullable

The acquirer-assigned MID (e.g. ent_a1b2c3d4).

terminal_idstring nullable

The acquirer-assigned TID (e.g. T0001), or a Fat Zebra-generated 8-character placeholder (e.g. ACMEC001) if none was supplied at board time. Immutable once set.

currenciesstring[]

Currencies the connection can transact.

schemesstring[]

Networks the merchant can transact for this acquirer.

modesstring[]

Transaction modes the connection supports.

walletsstring[]

Wallets the connection accepts.

three_ds_enabledboolean

Whether a boarded processor for this acquirer supports 3DS.

status'enabled' | 'disabled' required

Routing toggle across the underlying links — disable to turn the connection off without deleting it.

Changes

No recorded changes to this operation across all 1 revision of this API.