Payments
Acquirers

Create an Acquirer

Creates an Acquirer to be used with 3DS sessions.

post/payments/acquirers

Request

Request body

namestring required

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. If none is defined, the first Acquirer created becomes the 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",
      "bin": "424242",
      "acquirerMerchantIdentifier": "38191048173",
      "country": "ie"
    }
  ],
  "externalCustomerReference": "00-4bf92f3577b34da6a3ce929d3e0e4736-00f067aa0ba902b7-01"
}

Response

Returns the created 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.