Перейти к содержимому
reKassareKassareKassa APIAPI v1

Проверка организации

Прежде чем организация начнёт работать, сотрудники reKassa проверяют её реквизиты. Владелец заполняет реквизиты и отправляет организацию на проверку, сотрудник портала принимает решение.

  1. Реквизиты. PATCH /v1/orgs/{id} — адрес, руководитель, банк, МФО и расчётный счёт.

  2. Отправка. POST /v1/orgs/{id}/verify переводит организацию в статус pending. Пока идёт проверка, реквизиты менять нельзя.

  3. Решение. Сотрудник reKassa вызывает POST /v1/portal/orgs/{id}/verification: verified, needs_action или rejected. Статус и комментарий приходят в verificationStatus и verificationNote организации.

  4. Исправление. При needs_action исправьте реквизиты по комментарию и отправьте снова.

Статусы

Заголовок раздела «Статусы»
verificationStatus Что значит Что можно сделать
not_started организация создана, на проверку не отправлялась менять реквизиты, отправить на проверку
pending на проверке у сотрудника reKassa ждать решения — реквизиты заблокированы
verified проверка пройдена менять реквизиты — статус при этом не меняется
needs_action нужны исправления, причина — в verificationNote исправить реквизиты и отправить снова
rejected в проверке отказано, причина — в verificationNote менять реквизиты; повторно отправить нельзя 
not_started ──► pending ──► verified
                  │  ▲
                  │  └──── needs_action
                  └──────► rejected

Изменить реквизиты

Заголовок раздела «Изменить реквизиты»
PATCH/v1/orgs/{id}

Нужен доступ orgs.manage в организации — из ролей клиента он есть у «Владельца» и «Директора». Все поля необязательные, передавайте только те, что меняются. kind, tin и clientId после создания не меняются.

Поле Ограничения
name 1–300 символов
address 1–500 символов
directorName 1–200 символов
phone см. Телефоны
bankName 1–200 символов
bankMfo ровно 5 цифр
bankAccount ровно 20 цифр
Окно терминала
curl -X PATCH https://api.rekassa.uz/v1/orgs/8c1e4a27-5d3b-4f60-9a82-1b7e0c3d9f45 \
  -H 'Authorization: Bearer <accessToken>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bankName": "АКБ «Капиталбанк»",
    "bankMfo": "01088",
    "bankAccount": "20208000900123456001"
  }'

Ответ 200 — организация целиком, в том же виде, что при создании.

Статус Код Когда
400 validation_failed МФО не из 5 цифр, счёт не из 20 цифр, пустое значение
403 forbidden нет доступа orgs.manage в этой организации
404 organization_not_found организации нет
422 verification_state_invalid организация на проверке (pending)

Отправить на проверку

Заголовок раздела «Отправить на проверку»
POST/v1/orgs/{id}/verify

Тело не нужно. Отправить можно из статусов not_started и needs_action, и только если заполнены все реквизиты, нужные для проверки:

Поле Что это
address адрес
directorName руководитель
bankName банк
bankMfo МФО банка, 5 цифр
bankAccount расчётный счёт, 20 цифр
Окно терминала
curl -X POST https://api.rekassa.uz/v1/orgs/8c1e4a27-5d3b-4f60-9a82-1b7e0c3d9f45/verify \
  -H 'Authorization: Bearer <accessToken>'

Ответ 200 — организация со статусом pending и заполненным submittedAt.

Если реквизитов не хватает, ответ 422 requisites_incomplete, а незаполненные поля перечислены в details.missing:

{
  "error": {
    "code": "requisites_incomplete",
    "message": "Заполните реквизиты перед отправкой на проверку",
    "details": { "missing": ["bankName", "bankMfo", "bankAccount"] },
    "requestId": "4a9d1c7e-2b6f-4e30-8d15-9c3a7f0e2b64"
  }
}
Статус Код Когда
403 forbidden нет доступа orgs.manage в этой организации
404 organization_not_found организации нет
422 requisites_incomplete не заполнены реквизиты из details.missing
422 verification_state_invalid статус не not_started и не needs_action
© reKassarekassa.uz