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

Помощь для бизнеса

Руководства и ответы о подключении, личном кабинете и интеграции Tiyn Business

Разделы справки

51 ответ в 3 разделах

Подключение Tiyn

Что такое интернет-эквайринг?

Интернет-эквайринг — это сервис, который позволяет принимать оплату банковскими картами онлайн: через сайт, мобильное приложение или платёжную ссылку.

Кто может подключить и какие документы нужны?

Подключить интернет-эквайринг могут компании (ТОО и АО) и индивидуальные предприниматели, зарегистрированные в Казахстане.

Для компаний:

  • Свидетельство о регистрации компании (или выписка из госреестра)
  • Учредительные документы (устав или учредительный договор)
  • Документы, подтверждающие полномочия руководителя или доверенного лица (при необходимости)

Для ИП:

  • Документы о регистрации ИП
  • Удостоверение личности или паспорт
Как подключить и сколько времени это занимает?
  1. Зарегистрируйтесь в Tiyn.
  2. Создайте в личном кабинете точку продаж, указав валидные данные, и отправьте её на модерацию.
  3. С вами свяжется менеджер для уточнения деталей и заключения договора.
  4. После проверки документов и заключения договора вам будут настроены тарифы.
  5. Менеджер переведёт точку продаж в статус «Онлайн».
  6. Создайте первую ссылку на оплату и отправьте её клиенту.
Можно ли подключить несколько сайтов или магазинов?

Да. Для каждого сайта, магазина или направления бизнеса создаётся отдельная точка продаж в рамках одного аккаунта. Это позволяет:

  • Вести раздельную статистику и отчётность.
  • Использовать разные настройки и ссылки для каждого направления.
  • Ограничивать доступ сотрудников до конкретных точек.
Как получить доступ в личный кабинет после подключения?

После подключения вы самостоятельно создаёте учётную запись:

  1. Перейдите на страницу входа Tiyn Business и нажмите «Зарегистрироваться».
  2. Введите email и телефон.
  3. Подтвердите номер через SMS-код.
  4. Перейдите по ссылке из приветственного письма и установите пароль.

Подробнее о регистрации — в разделе «Начало работы» этого справочника.

Приём платежей

Какие способы оплаты поддерживаются?

Банковские карты:

  • Visa и Mastercard — международные карты любых банков.
  • Карты казахстанских банков (Kaspi, Halyk, ForteBank, Jusan и др.).

Цифровые кошельки:

  • Apple Pay — оплата через устройства Apple (iPhone, iPad, Mac).
  • Google Pay — оплата через устройства на Android.

Все способы оплаты отображаются на единой платёжной форме. Клиент выбирает удобный вариант самостоятельно.

Можно ли принимать платежи без сайта — через ссылку, соцсети или приложение?

Да. Tiyn Business специально создан для этого: не нужен интернет-магазин или сложная CMS, чтобы принимать деньги.

Соцсети и мессенджеры. Если у вас магазин в Instagram, Telegram или WhatsApp — просто отправляйте клиентам платёжную ссылку в личные сообщения. Никакой интеграции не требуется.

Мобильное приложение. Через API Tiyn Business можно встроить приём платежей в собственное мобильное приложение.

Интеграция

Какие варианты интеграции доступны?
ВариантОписаниеКогда использовать
Платёжная ссылкаСсылка из ЛК без написания кодаБез сайта, соцсети, мессенджеры, быстрый старт
Merchant APIREST API: создание счетов, возвраты, выплаты, подпискиПолная интеграция в сайт или приложение
Tiyn.jsГотовая платёжная форма (iframe) без PCI DSS на стороне мерчантаВстройте форму на сайт через script tag или npm
CMS-модулиГотовые плагины для популярных платформWordPress, Битрикс24, 1С‑Битрикс, InSales, Wix
Где найти API-документацию и как получить API-ключи?

API-документация доступна по адресу /business/api, а также по кнопке «Техническая документация» в технических настройках любой точки продаж в ЛК.

API-ключ формируется автоматически при создании точки продаж. Найдите его в технических настройках точки. У каждой точки продаж свой API-ключ.

API Key в настройках точки продаж
Есть ли тестовая среда и как проверить успешность интеграции?

Да. Создайте тестовую точку продаж в ЛК — она активируется мгновенно, без модерации, и работает без реальных денег.

Проверка интеграции:

  1. Создайте счёт через API (POST /merchant-api/api/v2/invoices) — получите paymentLink.
  2. Перейдите по ссылке и оплатите тестовой картой. Тестовые карты описаны в API-документации.
  3. Убедитесь, что операция появилась в ЛК со статусом Успех.
  4. Проверьте, что Callback-уведомление пришло на ваш сервер.
Что такое Webhook (Callback) и как настроить уведомления о платежах?

Callback (Webhook) — автоматический POST-запрос, который Tiyn Business отправляет на ваш сервер при изменении статуса счёта или выплаты. Это надёжнее редиректа: клиент мог закрыть браузер, но уведомление всё равно придёт.

Настройка в ЛК:

  1. Откройте нужную точку продаж → «Технические настройки».
  2. Укажите Callback URL (ResultURL) — адрес вашего сервера для уведомлений о статусах платежей.
  3. Укажите Payout Callback URL (Payout Result URL) — для уведомлений о статусах выплат.
  4. Нажмите «Сохранить изменения».
Callback URL в настройках точки продаж
  • Tiyn Business отправляет POST-запрос с JSON-телом, содержащим данные счёта и его статус.
  • Заголовок x-sign — подпись тела уведомления для проверки подлинности.
  • Ваш сервер должен вернуть: {"success": true, "uuid": "..."}
  • Если невалидный ответ или ответ не получен — система повторит отправку конечное число раз.

Платежи

Как проходит процесс оплаты для клиента?
  1. Клиент нажимает кнопку оплаты или переходит по платёжной ссылке.
  1. Открывается защищённая платёжная форма Tiyn.
Платёжная форма Tiyn
  1. Клиент вводит данные карты: номер, срок действия, CVV.
  1. Если карта подключена к 3D Secure — клиент вводит код из SMS от банка.
  1. Платёж обрабатывается, клиент видит результат: успешно или ошибка.
  1. На ваш сервер приходит Webhook-уведомление. Деньги сразу видны в кабинете.

Весь процесс занимает несколько секунд. Данные карты не передаются вам — они обрабатываются напрямую в защищённой среде Tiyn.

Какие бывают статусы платежа и как найти конкретный платёж?

Все платежи отображаются в разделе Операции и отчёты. Для поиска используйте строку поиска (по ID, email, телефону) или фильтры.

Раздел Операции и отчёты
СтатусЗначение
УспехПлатёж успешно завершён, средства получены.
В обработкеПлатёж создан и ожидает ответа банка.
ОшибкаПлатёж отклонён или возникла техническая ошибка.
ВозвращёнПо платежу проведён полный или частичный возврат.

Через API статус платежа можно проверить запросом к эндпоинту получения деталей операции. Актуальный статус также приходит в Webhook-уведомлении.

Почему платёж может быть отклонён?
  • Недостаточно средств на счёте плательщика.
  • Карта не поддерживает онлайн-платежи — не активирована для интернет-операций или заблокирована банком.
  • Истёк срок действия карты или она заблокирована.
  • Не пройдена проверка 3-D Secure — плательщик не подтвердил операцию в приложении банка.
  • Превышен лимит по карте (дневной, месячный или на одну операцию).
  • Сработала антифрод-защита — операция показалась подозрительной (необычная сумма, геолокация, частые попытки).
  • Технический сбой на стороне банка или платёжной инфраструктуры.
  • Истёк срок действия платёжной ссылки.

Причина отклонения отображается в деталях операции в ЛК. Если платёж регулярно отклоняется без очевидной причины — обратитесь в поддержку с идентификатором транзакции.

Что такое 3-D Secure?

3-D Secure (3DS) — это дополнительный уровень проверки при оплате картой онлайн. После ввода данных карты клиент получает SMS с одноразовым кодом от своего банка и вводит его на странице оплаты.

Зачем это нужно: 3DS защищает от несанкционированного использования карты. Если платёж прошёл с 3DS — ответственность за возможный chargeback переходит на банк, а не на продавца.

Как это работает: Tiyn Business автоматически инициирует проверку 3DS для карт, которые её поддерживают. От вас никаких дополнительных действий не требуется.

Что делать, если клиент оплатил, но заказ не обработан?
  1. Проверьте статус операции в разделе «Операции и отчёты» — он должен быть Успех.
  2. Убедитесь, что в технических настройках точки указан корректный Callback URL.
  3. Проверьте лог вашего сервера — возможно, Webhook пришёл, но не был обработан корректно.
  4. Если платёж успешен, но система не получила уведомление — запросите статус через API.

Возможно, платёж в промежуточном статусе и всё ещё обрабатывается. Если платёж долго не меняет статус — обратитесь в поддержку с идентификатором транзакции.

Возвраты

Как оформить возврат (полный или частичный)?

Отправьте PUT-запрос на:

https://business.tiyn.io/merchant-api/api/v2/invoices/<uuid>/refund

где uuid — идентификатор счёта, полученный в ответе при создании платежа.

ПараметрОбяз.Описание
requestIdДаУникальный идентификатор запроса
amountДаСумма возврата. Не может превышать сумму исходного платежа
reasonДаПричина возврата
Сколько времени занимает возврат средств?

Технически возврат обрабатывается в течение нескольких минут после подтверждения. Срок зачисления на карту зависит от банка-эмитента:

  • Обычно: от 1 до 5 рабочих дней.
  • В некоторых банках: до 10–30 рабочих дней.

Статус возврата в ЛК изменится на Успех как только возврат подтверждён на стороне платёжной системы. После этого остаётся только ждать зачисления от банка.

Можно ли отменить возврат после создания?

Нет. После того как возврат создан и принят системой, отменить его нельзя.

Перед подтверждением возврата проверьте сумму и номер операции.

Выплаты

Когда поступают выплаты по принятым платежам?

На банковскую карту — как правило, в течение нескольких минут. В редких случаях банк-получатель может зачислять средства до 1–3 рабочих дней.

Актуальный баланс и история выплат доступны в разделе Точки продаж — нажмите на карточку нужной точки. Баланс обновляется в реальном времени. Все комиссии и удержания видны сразу.

Где скачать выписку?

Выписку можно получить в личном кабинете:

  1. Перейдите в раздел Операции и отчёты.
  1. Настройте фильтры по нужному периоду и точке продаж.
  1. Нажмите «↓ Отчёт» в правом верхнем углу.
Кнопка Отчёт в разделе операций
  1. Выберите формат (Excel или CSV) и форму отчёта:Реестр всех операций — все транзакции за период.Выписка — только успешные платежи и выплаты.
Форма создания отчёта
  1. Введите email — файл придёт на почту.
Что делать, если выплата не поступила?
  1. Проверьте статус выплаты в разделе Операции и отчёты — отфильтруйте по типу «Выплата».
  2. Убедитесь, что реквизиты получателя в настройках точки указаны верно.
  3. Уточните сроки выплат по условиям вашего договора.
  4. Если выплата в статусе Ошибка или давно зависла — обратитесь в поддержку с номером операции.

Безопасность

Безопасно ли принимать платежи и как обеспечивается защита?

Да. Tiyn Business работает по стандартам банковской индустрии. Соответствует стандарту PCI DSS — международному стандарту безопасности данных платёжных карт:

  • Все данные карт передаются по зашифрованному протоколу HTTPS/TLS.
  • Платёжная форма размещена на защищённой инфраструктуре Tiyn.
  • Система антифрод-мониторинга анализирует каждую транзакцию в реальном времени.
  • Поддержка 3D Secure для дополнительной верификации плательщика.
Передаются ли данные карт продавцу?

Нет. Данные банковских карт клиентов (номер, CVV, срок действия) не передаются продавцу и не хранятся на его стороне.

Вся обработка платёжных данных происходит на защищённой инфраструктуре Tiyn Business в соответствии с требованиями PCI DSS. Продавец получает только уведомление о результате платежа и базовую информацию: маскированный номер карты, тип платёжной системы и статус операции.

Что делать при подозрении на мошенничество?
  1. Немедленно свяжитесь с поддержкой Tiyn.
  2. Укажите номер(а) подозрительных операций и описание ситуации.
  3. Если возможно — заморозьте обработку подозрительных заказов до выяснения.

Команда Tiyn проведёт расследование и при необходимости инициирует процедуру chargeback или дополнительную проверку.

Тарифы и условия

Какова комиссия и от чего она зависит?

Подключение к Tiyn Business бесплатно. Размер комиссии за эквайринг индивидуален и зависит от:

  • Оборота и типа бизнеса.
  • Категории MCC (вида деятельности).
  • Выбранного тарифного плана.

Все комиссии и удержания видны сразу в кабинете — никаких скрытых списаний. Для получения актуального предложения напишите на support@tiyn.io.

Где ознакомиться с условиями обслуживания?

Актуальные условия обслуживания доступны на сайте https://business.tiyn.io/ в разделе «Правила сервиса» и «Политика конфиденциальности».

Индивидуальные условия (тарифы, лимиты, расписание выплат) закрепляются в договоре эквайринга, который подписывается при подключении.

Не нашли ответ?

Напишите в поддержку Tiyn Business — ответим по почте или в Telegram. Для вопросов по интеграции откройте документацию API.

  • Укажите название точки продаж

  • Для платежа — номер счёта, дату и сумму

  • Не отправляйте секретный ключ и пароли