Начало работы
Введение
В этом руководстве объясняется, как интегрировать Wealth Reader: пользователь выбирает свой банк, делает аутентификацию, и ваша система получает нормализованные данные.
Пример конечного результата: https://widget.wealthreader.com/demo-all/
Прежде чем начать
Вам нужно:
- Завершить регистрацию и получить
api_key. - Сессия адаптации с технической командой. Запишитесь на Поддержка.
- Определите тип интеграции (ниже).
- URL HTTPS получить callback, если интегрировать с помощью iframe.
Выберите тип интеграции
| Критерии | Iframe (виджет) | OAuth |
|---|---|---|
| Когда | Веб-приложение, способное встраивать iframe | Нативное приложение, или вы не можете встроить iframe |
| Фронтенд | Вы встраиваете виджет на свою страницу | Вы перенаправляете пользователя на oauth.wealthreader.com |
| Данные | Они приходят POST вашего callback URL |
Вы получаете их, выполнив испытание в /token/ |
| Начните с | Iframe: фронтенд | OAuth: бэкенд |
Большинство веб-клиентов используют iframe.
Вы программируете с помощью ИИ-помощника? Установите Wealth Reader навык в Claude Code, Codex, Cursor, Copilot или Gemini CLI и генерирует интеграцию, следуя этому руководству.
Как это работает (iframe)
- Ваша страница загружает виджет с
operation_id, который вы генерируете. - Пользователь выбирает сущность, даёт согласие и, при необходимости, разрешает двухфакторную проблему. Виджет управляет этими этапами.
- Wealth Reader получает данные и делает две задачи в следующем порядке:
- На ваш бэкенд Wealth Reader отправляет полный JSON по настроенному URL callback. Переданный
operation_idпозволяет связать данные с операцией на фронтенде. - На фронтенде iframe оповещает вашу страницу
postMessage(flow completed) только если callback ответил правильно. Используйте его, чтобы закрыть селектор или показать экран успеха.
- На ваш бэкенд Wealth Reader отправляет полный JSON по настроенному URL callback. Переданный
operation_id — это мост между фронтом и задней частями. Без него вы не сможете сопоставить то, что произошло в браузере, с данными, которые поступают на ваш сервер.
Сообщение flow completed не содержит банковских данных. Данные передаются на callback. Если callback не отвечает HTTP 200 {"status":"ok"}, фронт не получает flow completed.