# Get connector account

Retrieves details for the specified connector account registered under your account. This endpoint requires an account-level API key.

Endpoint: POST /connector-accounts/get
Version: 2.0.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer SECRET

## Request fields (application/json):

  - `id` (string, required)
    Unique connector account identifier.
    Example: ca_01KRXP28JE4M5P6R7S8T9V0W1X

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique connector account identifier. Matches `connector_account_id` in routing configuration steps.
    Example: ca_01KRXP28JE4M5P6R7S8T9V0W1X

  - `name` (string, required)
    Connector account name.
    Example: Adyen EU cards

  - `status` (string, required)
    Connector account status.
The list of enum values may be extended without notice.
    Enum: "ACTIVE", "INACTIVE", "PENDING", "ARCHIVED"

  - `connector_id` (string, required)
    Identifier of the PSP or acquirer connector used for processing. Matches `connector_id` in routing configuration steps.
    Example: adyen

  - `legal_entity_id` (string)
    Identifier of the legal entity the connector account is registered for.
    Example: le_01JZ9F3H8KQWE5T6Y7R2M4N0BX

  - `website` (object)
    Merchant website the connector account is registered for.

  - `website.domain` (string, required)
    Website domain.
    Example: example.com

  - `acquiring_bank` (object)
    Acquiring bank that issued the connector account.

  - `acquiring_bank.name` (string, required)
    Acquiring bank name.
    Example: Adyen N.V.

  - `mcc` (string, required)
    Merchant category code assigned to the connector account.
    Example: 5815

  - `card_brands` (array)
    Card brands enabled for processing.
    Example: ["VISA","MASTERCARD"]

  - `processing_currencies` (object)
    Currency rules of the connector account.

  - `processing_currencies.enabled_currencies` (array)
    Currencies processed without conversion, in ISO 4217 alphabetic code.
    Example: ["EUR","USD"]

  - `processing_currencies.default_currency` (string)
    Currency in ISO 4217 alphabetic code to which payments in currencies not listed in `enabled_currencies` are converted.
    Example: EUR

  - `card_brand_processing_currencies` (array)
    Card brand currency rules. A rule fully replaces `processing_currencies` for payments with its card brand.
    Example: [{"card_brand":"MASTERCARD","enabled_currencies":["EUR"],"default_currency":"EUR"}]

  - `card_brand_processing_currencies.card_brand` (string)
    Card brand the rule applies to.
    Example: MASTERCARD

  - `payment_methods` (array)
    Payment methods the connector account can process.
    Example: ["CARD","APPLE_PAY","GOOGLE_PAY","NETWORK_TOKEN","COF","PSP_TOKEN"]

  - `payment_features` (array)
    Payment features enabled on the connector account.
    Example: ["NETWORK_TOKEN_FIRST","NETWORK_TOKEN_RECURRING","COF_PAN","AVS"]

  - `required_fields` (array)
    Payment fields that are mandatory for processing in certain regions and must be provided in the API request. If `ZIP_CODE` is listed, routing skips this connector account for card payments with a USA-issued card and no ZIP code.
    Example: ["ZIP_CODE"]

  - `default_recurring_strategy` (object)
    Default strategy for recurring payments through this connector account. It is used when no recurring routing configuration applies to the payment. Methods are tried in the listed order. Methods that the connector account does not support are skipped. If omitted, the platform default picks the first available method in this order: `PSP_TOKEN`, then `COF`.

  - `default_recurring_strategy.processing_methods` (array, required)
    Recurring processing methods in the order they are tried.
    Example: ["NETWORK_TOKEN","COF"]

  - `authentication_settings` (object, required)
    Authentication settings of the connector account, such as 3DS.

  - `authentication_settings.is_3ds_enabled` (boolean, required)
    Whether 3DS authentication is enabled.
    Example: true

  - `authentication_settings.is_3ri_enabled` (boolean, required)
    Whether 3RI authentication is enabled.
    Example: false

  - `authentication_settings.is_data_only_enabled` (boolean, required)
    Whether Data Only authentication is enabled.
    Example: false

  - `authentication_settings.is_sca_tra_exemption_enabled` (boolean, required)
    Whether the SCA TRA exemption can be requested. Required by routing steps with `is_sca_tra_exemption`.
    Example: true

  - `authentication_settings.is_3ds_cascading_enabled` (boolean, required)
    Whether a 3DS result can be reused when a payment cascades to another connector account.
    Example: false

  - `authentication_settings.providers` (array)
    Providers of 3DS authentication selected for the connector account.
    Example: ["CARDINAL_MPI","EXTERNAL_MPI"]

  - `descriptor_settings` (object, required)
    Statement descriptor settings of the connector account.

  - `descriptor_settings.type` (string, required)
    Descriptor type.
The list of enum values may be extended without notice.
    Enum: "STATIC", "DYNAMIC"

  - `descriptor_settings.default_value` (string)
    Descriptor issued with the connector account.
    Example: EXAMPLE.COM

  - `descriptor_settings.is_initial_payment_suffix_fallback_enabled` (boolean)
    Whether a recurring payment without a descriptor suffix uses the suffix of the initial payment. Returned only for `DYNAMIC` descriptors.
    Example: true

  - `descriptor_settings.prefix` (object)
    Prefix added before the dynamic descriptor body. The value for the card brand of the payment is used.

  - `descriptor_settings.prefix.card_brand_values` (array, required)
    Prefixes for specific card brands.
    Example: [{"card_brand":"VISA","value":"V*"}]

  - `descriptor_settings.prefix.card_brand_values.card_brand` (string, required)
    Card brand the prefix applies to.
    Example: VISA

  - `descriptor_settings.prefix.card_brand_values.value` (string, required)
    Prefix value.
    Example: V*

  - `created_at` (string, required)
    Date and time when the connector account was created.
    Example: 2026-05-18T13:58:02.062000Z

  - `updated_at` (string, required)
    Date and time when the connector account was last updated.
    Example: 2026-09-21T10:52:55.814000Z

## Response 400:

  - `400` (unknown)
    Bad request

## Response 400 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "VALIDATION"

  - `message` (string, required)
    Message describing the error.
    Example: One or more fields failed validation due to constraints

  - `context` (object, required)
    Additional context about the validation error, including specific constraints.
    Example: {"constraints":{"email":{"type":"TYPE","message":"The 'email' field must be a valid email address"},"age":{"type":"MIN","message":"The 'age' field must be a number greater than or equal to 18"}}}

  - `context.constraints` (object, required)
    Failed constraints keyed by the field name.

## Response 401:

  - `401` (unknown)
    Unauthenticated

## Response 401 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "UNAUTHENTICATED"

  - `message` (string, required)
    Message describing the error.
    Example: Credentials are invalid or missing

## Response 403:

  - `403` (unknown)
    Unauthorized

## Response 403 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "PERMISSION_DENIED"

  - `message` (string, required)
    Message describing the error.
    Example: Permission denied

## Response 404:

  - `404` (unknown)
    Not found

## Response 404 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "NOT_FOUND"

  - `message` (string, required)
    Message describing the error. The entity varies by endpoint.
    Example: The requested resource could not be found

## Response 429:

  - `429` (unknown)
    Too many requests

## Response 429 fields (application/json):

  - `code` (string, required)
    Code identifying the error type.
    Enum: "RATE_LIMIT"

  - `message` (string, required)
    Message describing the error.
    Example: Rate limit exhausted

  - `context` (object)
    Additional context about the error.

  - `context.next_try_at` (string)
    Timestamp indicating when to retry the request.
    Example: 2024-12-31T23:59:59.000000Z

## Response 404 examples:

  - `notFound` (unknown)