---
title: "Список эквайеров юрлиц"
method: GET
path: "/api/v1/finance/acquirers"
tags: ["Finance acquiring"]
---

# Список эквайеров юрлиц

`GET /api/v1/finance/acquirers`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/acquirers`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Настройка «Эквайринг»: какой контрагент — эквайер юрлица по провайдеру. Нужна НДС с комиссии — эквайер становится поставщиком во входном налоге.

## Headers

- `X-Tenant` string, required

## Response `200`

Эквайеры доступных юрлиц

- FinanceAcquirerList
  - `acquirers` FinanceAcquirer[], required: Эквайеры доступных юрлиц
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `provider` string, required: Ключ провайдера, как в подтверждении оплаты картой (yookassa)
    - `contact_id` string, uuid, required
    - `contact_name` string: Название контрагента-эквайера
    - `fee_vat_rate` string, nullable, required: Ставка НДС, которую эквайер начисляет на комиссию, в процентах; null — без НДС
    - `fee_recognition` 'payment' | 'closing_document', required: Когда признаётся расход по комиссии: payment — по данным платежа; closing_document — по закрывающему документу эквайера (УПД или акт за период)
    - `relinked` FinanceAcquirerRelink
      - `reposted` integer, required: Сколько оплат картой без эквайера перепроведено на выбранного эквайера
      - `failed` FinanceAcquirerRelinkFailed[], required: Оплаты, которые перепровести не удалось
        - `receipt_document_id` string, uuid, required
        - `number` string, required: Номер документа оплаты
        - `reason` 'period_closed' | 'repost_failed', required: period_closed — оплата в закрытом периоде; repost_failed — перепроведение отказало

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)