---
title: "Выбрать эквайера юрлица"
method: PUT
path: "/api/v1/finance/acquirers"
tags: ["Finance acquiring"]
---

# Выбрать эквайера юрлица

`PUT /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

## Request body

- FinanceAcquirerInput
  - `company_id` string, uuid, required
  - `provider` string, required: Ключ провайдера, как в подтверждении оплаты картой (yookassa)
  - `contact_id` string, uuid, required
  - `fee_vat_rate` string, nullable: Ставка НДС эквайера на комиссию в процентах, от 0 до 100; пусто или null — без НДС
  - `fee_recognition` 'payment' | 'closing_document': Когда признаётся расход по комиссии: payment — по данным платежа; closing_document — по закрывающему документу эквайера

## Response `200`

Сохранённая настройка

- FinanceAcquirer
  - `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

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `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/3c60ded179f2?raw)