Организация - это команда, баланс и журнал аудита; приложение - процессы, ключи и webhooks в «Проде» и «Песочнице». Изменение не сработало - проверьте среду.

Краткий ответ

Организация = ваша команда, ваш баланс биллинга, ваш журнал аудита. Приложение = рабочие процессы, API-ключи, webhook-эндпоинты, политика хранения данных и продукты в двух средах: Прод и Песочница. Большинство проблем «я изменил, но ничего не произошло» связаны с тем, что вы находитесь не в том приложении или не в той среде.

#Два уровня

Организация - это ваш аккаунт. Ей принадлежат:

  • Ваша команда и роли ее участников
  • Ваш баланс биллинга и счета
  • Ваш журнал аудита
  • Все ваши приложения

Приложение - это рабочее пространство внутри организации. Ему принадлежат:

  • Собственные рабочие процессы
  • Собственные API-ключи
  • Собственные webhook-эндпоинты
  • Собственная политика хранения данных
  • Собственные продукты, если включение продуктов для отдельного приложения уже доступно. См. продукты и что в них входит
  • Две среды: Прод и Песочница

Переключайте приложение через карточку приложения в верхней части боковой панели. Переключение применяется сразу. В том же меню открываются Настройки приложения и Создать приложение.

#Почему это важнее, чем кажется

Почти каждый отчет вида «я изменил и ничего не произошло» сводится к этой структуре:

  • Вы отредактировали рабочий процесс в приложении A, а ваши сессии работают в приложении B.
  • Вы добавили webhook-эндпоинт в одно приложение, а ожидали события из другого.
  • Вы смотрите на Песочницу, а ваш трафик идет в Проде, или наоборот.
  • Вы вызываете API с ключом от другого приложения, чем то, к которому относится нужный ресурс, и получаете 404 или 403 для того, что явно существует.

Прежде чем отлаживать что-либо еще, убедитесь, что вы в правильном приложении. См. ошибки API и что они означают.

#Прод и Песочница - это разные среды

Новые приложения создаются в среде Прод. Тестирование происходит в среде Песочница: это общее тестовое приложение вашей организации с собственными данными и собственными ключами. Переключайтесь между ними с помощью переключателя Прод / Песочница под названием приложения в боковой панели.

Верификации, API-ключи, webhooks и списки в каждой среде свои. Брендинг общий, а рабочие процессы создаются один раз и могут копироваться между средами. В этом и есть смысл разделения: тестовый трафик и реальные данные никогда не смешиваются, и sandbox-ключ не может случайно потратить реальные кредиты. См. тестирование в sandbox.

Совет

Называйте приложения так, чтобы их нельзя было спутать на глаз - acme-onboarding и acme-payments гораздо лучше, чем «Application» и «Application (2)». Храните ключи в своем менеджере секретов под именами, в которых указана среда, и никогда не держите одну переменную окружения, значение которой означает «какой ключ сейчас актуален».

#Сколько приложений вам нужно?

Большинство команд начинают с одного, и оно уже дает вам Прод и Песочницу. Дальше разделяйте по всему, что требует своей конфигурации или изоляции:

  • По продукту, если разным продуктам нужны разные рабочие процессы и разные webhook-эндпоинты.
  • По предпродакшн-окружению, если вам недостаточно одной Песочницы.
  • По бренду, если вы предоставляете верификацию под несколькими брендами с разным оформлением.
  • По политике хранения, поскольку хранение данных настраивается на уровне приложения.

Что не делится по приложениям - это ваш баланс, он на уровне организации. Все приложения расходуют одни и те же кредиты.

#Создание дополнительных приложений

Откройте карточку приложения в верхней части боковой панели, выберите Создать приложение и введите Название приложения (там, где продукты для отдельных приложений уже доступны, вы также выбираете, для чего оно). Если такой опции нет, либо вам нужно создавать приложения через API, а не через консоль, это вопрос прав доступа на уровне аккаунта, который стоит задать поддержке, а не пытаться обойти.

#Несколько организаций

Один человек может состоять в нескольких организациях и переключаться между ними через меню организации в верхней части боковой панели, где также появляются ожидающие приглашения. Самостоятельно создавать больше одной организации могут только реселлерские аккаунты (чтобы включить эту возможность, обратитесь в поддержку), и создать суборганизации или субаккаунты под вашей нельзя. Если вы обслуживаете несколько собственных клиентов, поддерживаемая структура - одно приложение на клиента внутри вашей единственной организации: у каждого приложения свои рабочие процессы, брендинг, ключи API, результаты и отчёты об использовании, полностью изолированные от остальных, а биллинг остаётся на уровне организации.

#Перепродажа Didit

Если вы хотите включить Didit в собственный продукт и брать за это плату с клиентов, это реселлерская модель. Как она работает, в тех формулировках, которые поддержка даёт всем, кто спрашивает:

  • Предоплаченный кредит. Минимальная первоначальная покупка $5,000 USD, предоплата, по годовому соглашению. Кредит не имеет срока действия, находится на уровне вашей организации и расходуется всеми конечными клиентами, которых вы подключаете, и включает скидку за объём, растущую с суммой.
  • Панель управления строите вы. Вы интегрируете API Didit в свой фронтенд, и ваши клиенты управляют там своими рабочими процессами, брендингом и ролями. Didit не предоставляет white-label-копию Business Console; экраны проверки, которые видят ваши конечные пользователи, могут нести ваш бренд (см. white label), консоль - нет.
  • Ваша маржа - ваша. Вы назначаете цену, которую платят ваши клиенты. Didit выставляет вам счёт за каждую выполненную функцию по единичным ценам, зафиксированным на срок соглашения.
  • Это не программа локальных партнёров. Didit проводит демонстрации, онбординг и поддержку напрямую с клиентами и не ищет партнёров по дистрибуции или внедрению.

Если вы не хотите заниматься перепродажей, используйте реферальную опцию: в Business Console откройте Настройки → Приглашайте и зарабатывайте, получите свою ссылку и поделитесь ею. Вы получаете комиссию 10% с каждого денежного пополнения приглашённой организации в течение 36 месяцев с её первого пополнения, которую можно использовать как кредит Didit или вывести банковским переводом после периода созревания - без обязательств по поставке или поддержке. Вы можете построить и протестировать интеграцию на тарифе Free до того, как решитесь на любой из вариантов.

#Удаление приложения

Безвозвратное удаление приложения пока недоступно: в разделе Настройки приложения есть блок «Опасная зона», но в нем указано, что удаление недоступно, и он ничего не удаляет. До тех пор у вас есть такие варианты:

  • Перестаньте им пользоваться. Переименуйте его (например, в acme-old), чтобы никто не выбрал его по ошибке, и отзовите его API-ключи в разделе Разработчикам → API-ключи.
  • Удалите данные клиентов. Данные верификации следуют политике хранения и правилам удаления для этих данных, а не жизненному циклу приложения - удаляйте данные явно. См. удаление сессий и персональных данных.
  • Начните заново. Поддержка может удалить всю организацию, чтобы вы могли создать новую, - это крайняя мера, поскольку вместе с ней удаляются команда, баланс и история.

#Все действия отслеживаемы

Каждое изменение фиксирует в журнале аудита, к какому приложению оно относилось. Именно это делает структуру с несколькими приложениями проверяемой, а не просто аккуратной. См. использование журналов аудита.

Не нашли ответ? Поговорите с человеком.

Укажите ID организации и ID сессии, о которой спрашиваете.

Связаться с поддержкой