Интеграция с Yario

Начните здесь

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

Важно: текущая версия Integration API не проводит платежи и не работает с картами, балансами, возвратами или выплатами. Для знакомства с платформой используйте только тестовые данные.

Что будет готово в результате

После прохождения этого маршрута ваша команда:

• получит доступ к тестовой среде Yario;
• подключит создание и обновление обращений, обмен сообщениями и выбранные дополнительные функции;
• настроит безопасный приём уведомлений от Yario;
• самостоятельно проверит интеграцию и получит отчёт с результатами.

Успешная техническая проверка подтверждает, что интеграция работает в тестовой среде. Для подключения к реальным клиентам всё равно потребуется отдельное согласование с Yario.

Кто участвует

• Владелец партнёрской организации регистрирует компанию, заполняет профиль и принимает необходимые соглашения.
• Разработчик партнёра подключает API, настраивает приём уведомлений и запускает проверку.
• Юрист и уполномоченный сотрудник Yario отдельно рассматривают заявку на рабочий доступ.

Что подготовить заранее

• рабочий email владельца партнёрской организации;
• сведения о компании и документы, необходимые для выбранного сценария;
• защищённое хранилище для тестового API-ключа;
• HTTPS-адрес, на который Yario сможет отправлять уведомления;
• тестовые идентификаторы, полученные в кабинете партнёра.

Порядок подключения

1. Получите тестовый доступ

Откройте кабинет партнёра, зарегистрируйте организацию, подтвердите email, заполните профиль и примите тестовое соглашение. Подробный порядок описан на странице «Регистрация и получение доступа».

Нажмите на скриншот, чтобы открыть его в полном размере.

Готово, если: кабинет один раз показал тестовый ключ с префиксом yario_test_. Сразу сохраните его в защищённом хранилище — повторно посмотреть этот ключ нельзя.

Если ключ не появился, проверьте подтверждение email, обязательные поля профиля, выбранные функции и статус тестового соглашения.

2. Подключите свою систему

Начните с краткого обзора Integration API, а затем используйте инструкции по нужным частям интеграции:

• как хранить и использовать API-ключ;
• как создавать обращения, сообщения и вложения;
• как передавать данные мерчанта для проверки (KYC);
• как принимать автоматические уведомления от Yario;
• как обрабатывать ошибки и безопасно повторять запросы;
• полное описание запросов и ответов API.

Готово, если: запрос /v1/me возвращает сведения о вашей тестовой среде, а ваша система умеет создавать обращения и сообщения только для разрешённых тестовых клиентов.

3. Проверьте интеграцию

Сначала посмотрите работающее демо. Войдите с логином demo и паролем partner-demo-2026, затем запустите полную проверку. Демо обращается к настоящему Integration API в изолированной тестовой среде, но не передаёт API-ключ в браузер и не показывает внутренние идентификаторы.

Если вы хотите увидеть реализацию, откройте готовый пример интеграции на GitHub. Это небольшое приложение с открытым исходным кодом, которое:

• подключается к Integration API;
• создаёт тестовые обращения и сообщения;
• показывает пример проверки данных мерчанта;
• принимает и проверяет уведомления от Yario;
• не обрабатывает повторное уведомление дважды;
• запускает автоматическую проверку и сохраняет отчёт.

Пример работает только с заранее разрешёнными тестовыми данными и по умолчанию не принимает рабочие ключи. Он не проводит платежи и не хранит реальные данные клиентов.

Чтобы запустить тот же пример у себя, склонируйте репозиторий и выполните шаги из его README. После этого пройдите проверку тестовой интеграции.

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

4. Завершите демо или запросите рабочий доступ

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

Yario отдельно проверит документы, согласованный сценарий работы и результат технических тестов. Успешное демо само по себе не включает рабочий доступ.

Быстрые ссылки

Что нужно сделать	Куда перейти
Зарегистрировать партнёрскую организацию	Кабинет партнёра
Посмотреть все методы API	Описание Integration API
Открыть работающий пример	Интерактивное демо
Скачать исходный код примера	Репозиторий на GitHub
Проверить свою интеграцию	Тестирование и техническая проверка

Нужна помощь с внедрением?

Yario может адаптировать готовый пример под вашу платформу и помочь довести интеграцию до тестового запуска. Стоимость такой работы начинается от 2 000 USD и рассчитывается после согласования объёма.

В базовую работу входят подключение к API, приём уведомлений, автоматические тесты и подготовка к запуску в тестовой среде. Комиссии сторонних сервисов, юридическая экспертиза и нестандартная продуктовая разработка оцениваются отдельно.

Чтобы обсудить задачу, напишите в Telegram.