Payments
Acquirers

Update an Acquirer

Updates an Acquirer by its unique identifier.

patch/payments/acquirers/{acquirer_id}

Request

Path parameters

acquirer_idstring required

The id of the Acquirer to be updated.

Request body

namestring

The name of the Acquirer.

descriptionstring

The description of the Acquirer.

defaultboolean

Specifies whether this Acquirer is the default. Only one default Acquirer configuration can exist at a time; setting a new one clears the previous default. See the Acquirers API for details.

externalCustomerReferencestring

An optional reference of your choice, such as a correlation ID, that is attached to the request. The reference will be visible in your logs. Must be between 1 and 255 characters.

Example request

{
  "configurations": [
    {
      "network": "mastercard",
      "country": "ie"
    }
  ],
  "externalCustomerReference": "00-4bf92f3577b34da6a3ce929d3e0e4736-00f067aa0ba902b7-01"
}

Response

Returns the updated Acquirer object.

idstring required

The unique identifier of the acquirer configuration.

namestring required

The name of the acquirer configuration.

descriptionstring

The description of the acquirer configuration.

defaultboolean required

Example response

{
  "id": "acquirer_eead1d640d7c",
  "name": "Ollivanders Wand Shop Production Configuration",
  "description": "Ollivanders Wand Shop Production Configuration",
  "default": true,
  "configurations": [
    {
      "network": "mastercard",
      "bin": "424242",
      "acquirerMerchantIdentifier": "38191048173",
      "state": "active",
      "country": "ie"
    },
    {
      "network": "visa",
      "bin": "424242",
      "acquirerMerchantIdentifier": "38191048173",
      "state": "active",
      "country": "ie"
    }
  ]
}

Changes

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