Поддержка Tiyn Business
- support@tiyn.io
- Telegram
- @TiynSupport_bot
- Документация
- Merchant API и Tiyn.js
Руководства и ответы о подключении, личном кабинете и интеграции Tiyn Business
51 ответ в 3 разделах
Интернет-эквайринг — это сервис, который позволяет принимать оплату банковскими картами онлайн: через сайт, мобильное приложение или платёжную ссылку.
Подключить интернет-эквайринг могут компании (ТОО и АО) и индивидуальные предприниматели, зарегистрированные в Казахстане.
Для компаний:
Для ИП:
Да. Для каждого сайта, магазина или направления бизнеса создаётся отдельная точка продаж в рамках одного аккаунта. Это позволяет:
После подключения вы самостоятельно создаёте учётную запись:
Подробнее о регистрации — в разделе «Начало работы» этого справочника.
Банковские карты:
Цифровые кошельки:
Все способы оплаты отображаются на единой платёжной форме. Клиент выбирает удобный вариант самостоятельно.
Да. Tiyn Business специально создан для этого: не нужен интернет-магазин или сложная CMS, чтобы принимать деньги.
Соцсети и мессенджеры. Если у вас магазин в Instagram, Telegram или WhatsApp — просто отправляйте клиентам платёжную ссылку в личные сообщения. Никакой интеграции не требуется.
Мобильное приложение. Через API Tiyn Business можно встроить приём платежей в собственное мобильное приложение.
| Вариант | Описание | Когда использовать |
|---|---|---|
| Платёжная ссылка | Ссылка из ЛК без написания кода | Без сайта, соцсети, мессенджеры, быстрый старт |
| Merchant API | REST API: создание счетов, возвраты, выплаты, подписки | Полная интеграция в сайт или приложение |
| Tiyn.js | Готовая платёжная форма (iframe) без PCI DSS на стороне мерчанта | Встройте форму на сайт через script tag или npm |
| CMS-модули | Готовые плагины для популярных платформ | WordPress, Битрикс24, 1С‑Битрикс, InSales, Wix |
API-документация доступна по адресу /business/api, а также по кнопке «Техническая документация» в технических настройках любой точки продаж в ЛК.
API-ключ формируется автоматически при создании точки продаж. Найдите его в технических настройках точки. У каждой точки продаж свой API-ключ.

Да. Создайте тестовую точку продаж в ЛК — она активируется мгновенно, без модерации, и работает без реальных денег.
Проверка интеграции:
POST /merchant-api/api/v2/invoices) — получите paymentLink.Callback (Webhook) — автоматический POST-запрос, который Tiyn Business отправляет на ваш сервер при изменении статуса счёта или выплаты. Это надёжнее редиректа: клиент мог закрыть браузер, но уведомление всё равно придёт.
Настройка в ЛК:
ResultURL) — адрес вашего сервера для уведомлений о статусах платежей.Payout Result URL) — для уведомлений о статусах выплат.
x-sign — подпись тела уведомления для проверки подлинности.{"success": true, "uuid": "..."}
Весь процесс занимает несколько секунд. Данные карты не передаются вам — они обрабатываются напрямую в защищённой среде Tiyn.
Все платежи отображаются в разделе Операции и отчёты. Для поиска используйте строку поиска (по ID, email, телефону) или фильтры.

| Статус | Значение |
|---|---|
| Успех | Платёж успешно завершён, средства получены. |
| В обработке | Платёж создан и ожидает ответа банка. |
| Ошибка | Платёж отклонён или возникла техническая ошибка. |
| Возвращён | По платежу проведён полный или частичный возврат. |
Через API статус платежа можно проверить запросом к эндпоинту получения деталей операции. Актуальный статус также приходит в Webhook-уведомлении.
Причина отклонения отображается в деталях операции в ЛК. Если платёж регулярно отклоняется без очевидной причины — обратитесь в поддержку с идентификатором транзакции.
3-D Secure (3DS) — это дополнительный уровень проверки при оплате картой онлайн. После ввода данных карты клиент получает SMS с одноразовым кодом от своего банка и вводит его на странице оплаты.
Зачем это нужно: 3DS защищает от несанкционированного использования карты. Если платёж прошёл с 3DS — ответственность за возможный chargeback переходит на банк, а не на продавца.
Как это работает: Tiyn Business автоматически инициирует проверку 3DS для карт, которые её поддерживают. От вас никаких дополнительных действий не требуется.
Успех.Возможно, платёж в промежуточном статусе и всё ещё обрабатывается. Если платёж долго не меняет статус — обратитесь в поддержку с идентификатором транзакции.
Отправьте PUT-запрос на:
https://business.tiyn.io/merchant-api/api/v2/invoices/<uuid>/refund
где uuid — идентификатор счёта, полученный в ответе при создании платежа.
| Параметр | Обяз. | Описание |
|---|---|---|
| requestId | Да | Уникальный идентификатор запроса |
| amount | Да | Сумма возврата. Не может превышать сумму исходного платежа |
| reason | Да | Причина возврата |
Технически возврат обрабатывается в течение нескольких минут после подтверждения. Срок зачисления на карту зависит от банка-эмитента:
Статус возврата в ЛК изменится на Успех как только возврат подтверждён на стороне платёжной системы. После этого остаётся только ждать зачисления от банка.
Нет. После того как возврат создан и принят системой, отменить его нельзя.
Перед подтверждением возврата проверьте сумму и номер операции.
На банковскую карту — как правило, в течение нескольких минут. В редких случаях банк-получатель может зачислять средства до 1–3 рабочих дней.
Актуальный баланс и история выплат доступны в разделе Точки продаж — нажмите на карточку нужной точки. Баланс обновляется в реальном времени. Все комиссии и удержания видны сразу.
Выписку можно получить в личном кабинете:


Ошибка или давно зависла — обратитесь в поддержку с номером операции.Да. Tiyn Business работает по стандартам банковской индустрии. Соответствует стандарту PCI DSS — международному стандарту безопасности данных платёжных карт:
Нет. Данные банковских карт клиентов (номер, CVV, срок действия) не передаются продавцу и не хранятся на его стороне.
Вся обработка платёжных данных происходит на защищённой инфраструктуре Tiyn Business в соответствии с требованиями PCI DSS. Продавец получает только уведомление о результате платежа и базовую информацию: маскированный номер карты, тип платёжной системы и статус операции.
Команда Tiyn проведёт расследование и при необходимости инициирует процедуру chargeback или дополнительную проверку.
Подключение к Tiyn Business бесплатно. Размер комиссии за эквайринг индивидуален и зависит от:
Все комиссии и удержания видны сразу в кабинете — никаких скрытых списаний. Для получения актуального предложения напишите на support@tiyn.io.
Актуальные условия обслуживания доступны на сайте https://business.tiyn.io/ в разделе «Правила сервиса» и «Политика конфиденциальности».
Индивидуальные условия (тарифы, лимиты, расписание выплат) закрепляются в договоре эквайринга, который подписывается при подключении.
Напишите в поддержку Tiyn Business — ответим по почте или в Telegram. Для вопросов по интеграции откройте документацию API.
Укажите название точки продаж
Для платежа — номер счёта, дату и сумму
Не отправляйте секретный ключ и пароли