Skip to main content
POST
Создать субсчёт
reference неизменяем. Это идентификатор, который вы отправляете в заголовке X-Sub-Account, чтобы выполнить операцию в субсчёте, и значение, которое приходит в поле subAccount вебхуков, — выбирайте его внимательно, изменить его после создания невозможно.Формат: ^[a-z0-9][a-z0-9_-]{1,31}$ — от 2 до 32 символов, только строчные латинские буквы, цифры, - и _, начиная со строчной буквы или цифры. reference должен быть уникальным в пределах аккаунта: повторное использование существующего возвращает 409 SUB_ACCOUNT_REFERENCE_TAKEN.Субсчёт создаётся с собственным нулевым балансом, полностью независимым от баланса основного аккаунта. См. Субсчета — там описано поведение заголовка X-Sub-Account и приведена полная таблица ошибок.

Авторизации

Authorization
string
header
обязательно

Токен доступа, полученный через POST /auth (client_id + client_secret). Действителен в течение 300 секунд.

Тело

application/json
reference
string
обязательно

Идентификатор субсчёта, задаваемый вами. Уникален в пределах аккаунта и неизменяем после создания. principal — зарезервированное слово основного аккаунта, использовать его нельзя: возвращается 400 SUB_ACCOUNT_INVALID_REFERENCE.

Pattern: ^[a-z0-9][a-z0-9_-]{1,31}$
Пример:

"loja-centro"

name
string
обязательно

Отображаемое имя субсчёта

Maximum string length: 255
Пример:

"Loja Centro"

Ответ

Субсчёт успешно создан

id
string<uuid>
обязательно

ID субсчёта

reference
string
обязательно

Reference субсчёта

Пример:

"loja-centro"

name
string
обязательно

Название субсчёта

Пример:

"Loja Centro"

status
string
обязательно

Статус субсчёта

Пример:

"approved"

createdAt
string<date-time>
обязательно

Дата создания