Платёжная инфраструктура для разработчиков Paysido построена на принципах простоты интеграции и надёжности. REST API, готовые SDK, виджеты и плагины для популярных CMS позволяют подключить приём платежей на сайте или в приложении за один-два рабочих дня — без сложной технической экспертизы и длительного согласования.
Paysido — платёжный сервис, сертифицированный по стандарту PCI DSS. Все финансовые операции обрабатываются в защищённой среде: данные банковских карт не хранятся на стороне мерчанта, передача данных осуществляется по протоколу TLS 1.2+. Архитектура платформы обеспечивает высокую доступность (99,9% uptime) и горизонтальное масштабирование под любой объём транзакций.
Разработчик может выбрать способ интеграции в зависимости от архитектуры проекта и требуемой гибкости. Paysido поддерживает несколько подходов — от готовых плагинов до полноценного API.
Доступны три основных способа: REST API для полного контроля над платёжным потоком, встраиваемый виджет для быстрого старта без серверной логики и готовые плагины для CMS. Выбор способа определяется технической зрелостью проекта и временем, отведённым на разработку.
Paysido предоставляет готовые модули для WordPress / WooCommerce, Tilda, Bitrix, OpenCart и других популярных платформ. Установка выполняется через стандартный менеджер плагинов: загрузите модуль, укажите API-ключ из личного кабинета — интеграция завершена. Настройка занимает от 15 минут.
Встраиваемый платёжный виджет подключается одной строкой JavaScript и отображает форму оплаты поверх страницы сайта. Виджет адаптирован под мобильные устройства, поддерживает приём карт Visa, Mastercard, МИР, а также оплату через СБП. Внешний вид виджета настраивается под дизайн сайта через CSS-параметры.
Платёжный конструктор — инструмент для создания кастомных платёжных форм без написания серверного кода. Разработчик задаёт параметры (сумма, описание, список товаров) через визуальный интерфейс, получает готовый код для вставки на сайт или ссылку для размещения в любом канале.
Paysido поддерживает все актуальные сценарии приёма оплаты на сайте и в мобильных приложениях. Каждый метод сопровождается подробными примерами запросов в документации.
Для создания платежа через API отправьте POST-запрос на эндпоинт /v1/payments с параметрами суммы, валюты и описания. В ответе вы получите payment_id и ссылку для перенаправления клиента на страницу оплаты. После завершения транзакции система отправляет вебхук на указанный callback URL со статусом операции.
Инициализируйте виджет на странице через вызов Paysido.Widget.open({ amount, orderId, description }). Виджет самостоятельно обрабатывает ввод данных карты, 3-D Secure и уведомление о результате — серверная часть получает только финальный статус платежа через вебхук.
Для приёма платежей в мессенджерах (Telegram, VK) используйте API генерации платёжных ссылок. Метод /v1/payment-links создаёт короткую ссылку с предзаполненными параметрами: клиент переходит по ссылке и оплачивает в стандартном интерфейсе. Срок жизни ссылки и параметры оплаты настраиваются при создании.
Для интеграции офлайн-терминала используйте SDK для Android и iOS или REST API в режиме card-present. Поддерживаются сценарии оплаты с физическим считыванием карты, QR-оплата через СБП и приём платежей через POS-терминалы сторонних производителей. Инициализация терминала и управление транзакциями выполняются через единый API-интерфейс.
Рекуррентные платежи позволяют автоматически списывать средства по расписанию без повторного ввода данных карты клиентом. Для активации рекуррентного сценария укажите recurrent: true при создании первого платежа — клиент вводит карту один раз, после чего она сохраняется в токенизированном виде.
Запуск рекуррентного цикла — POST-запрос на /v1/subscriptions с указанием customer_id и шаблона платежа. Остановка подписки: PATCH /v1/subscriptions/{id} с параметром status: cancelled. Все изменения немедленно отражаются в личном кабинете мерчанта.
Поддерживаемые интервалы: daily, weekly, monthly, custom. При использовании custom-интервала передайте cron-выражение в поле schedule. Система автоматически создаёт плановые платежи согласно расписанию и отправляет уведомления о результате каждого списания.
Для изменения суммы действующей подписки отправьте PATCH-запрос на /v1/subscriptions/{id} с новым значением amount. Изменение применяется со следующего планового платежа. История изменений суммы доступна в детализации подписки через GET /v1/subscriptions/{id}/history.
Безопасная сделка — сервис условного депонирования: средства покупателя резервируются на счёте Paysido и передаются продавцу только после подтверждения факта выполнения обязательств. Инструмент подходит для маркетплейсов, C2C-платформ и любых сделок, где стороны не знакомы лично.
Для активации режима безопасной сделки обратитесь к менеджеру Paysido: функциональность подключается как дополнение к основному договору. После активации в API становятся доступны методы /v1/safe-deals для создания, подтверждения и отмены защищённых транзакций.
Поддерживаются две схемы: двусторонняя (покупатель → эскроу → продавец) и трёхсторонняя (покупатель → эскроу → платформа → продавец). Во второй схеме платформа получает комиссию автоматически при финальном переводе средств.
Для тестирования используйте sandbox-среду с отдельными API-ключами. Тестовый контур полностью воспроизводит логику продакшн-окружения. Набор тестовых карт с различными сценариями (успешная оплата, отклонение, 3-DS, недостаток средств) доступен в личном кабинете разработчика.
В sandbox-режиме онлайн-касса работает в тестовом режиме ФНС: чеки формируются, но не передаются в налоговый орган. Для проверки корректности фискальных данных используйте встроенный валидатор чеков в разделе «Тестирование» личного кабинета.
Полная техническая документация по всем методам API доступна в формате OpenAPI 3.0. Каждый метод содержит описание параметров, примеры запросов и ответов на нескольких языках программирования (Python, PHP, Node.js, Java, Go).
В разделе FAQ собраны ответы на типовые технические вопросы: настройка вебхуков, работа с возвратами, обработка ошибок API, особенности работы с 3-D Secure и специфика фискализации при различных режимах налогообложения.
Техническая поддержка для разработчиков доступна по email dev@paysido.com и в Telegram-чате. Приоритетная поддержка с SLA 2 часа предоставляется по тарифным планам Enterprise. В стандартном режиме время ответа — до одного рабочего дня.
API возвращает стандартизированные коды ошибок в поле error.code. Класс 4xx — ошибки клиента (неверные параметры, недостаточно прав, объект не найден). Класс 5xx — серверные ошибки, при которых рекомендуется повторить запрос с экспоненциальной задержкой. Полный справочник кодов с описанием и рекомендациями по обработке — в документации.
Каждый платёж проходит через фиксированный набор статусов: created → processing → succeeded / failed / cancelled. Статус refunded присваивается при полном или частичном возврате. Текущий статус доступен через GET /v1/payments/{id} или через вебхук-уведомление.
Webhook-уведомления отправляются на указанный callback URL при каждом изменении статуса транзакции. Поддерживаемые типы событий: payment.succeeded, payment.failed, payment.cancelled, refund.succeeded, subscription.renewed, subscription.failed. Для тестирования вебхуков используйте функцию «Повторная отправка» в личном кабинете.
Paysido предоставляет официальные SDK для популярных языков и фреймворков. Каждый SDK включает готовые методы для всех операций API, автоматическую обработку ошибок и повторные запросы, а также встроенное логирование для отладки.
API построен по архитектуре REST. Базовый URL: https://api.paysido.com/v1. Все запросы и ответы передаются в формате JSON. Для обеспечения идемпотентности операций используйте заголовок Idempotency-Key при создании платежей и возвратов.
Аутентификация выполняется через HTTP Basic Auth: в качестве логина передаётся Secret Key из личного кабинета, поле пароля остаётся пустым. Для серверных запросов используйте Secret Key, для клиентских сценариев (виджет, мобильное приложение) — Public Key. Ротация ключей доступна в разделе «Настройки» личного кабинета.
При прохождении 3-D Secure API возвращает статус payment.pending и URL для перенаправления клиента на страницу подтверждения банка. После прохождения верификации клиент возвращается на return_url, указанный при создании платежа. Финальный статус платежа передаётся через вебхук.
Уведомления отправляются методом POST на webhook_url, указанный в настройках магазина. Тело запроса содержит объект события с полями event, object и created_at. Для подтверждения получения сервер мерчанта должен вернуть HTTP 200. При отсутствии ответа система повторяет отправку по расписанию: через 1, 5, 30 минут и 6 часов.
Список событий, на которые можно подписаться: payment.succeeded, payment.waiting_for_capture, payment.cancelled, refund.succeeded, deal.closed, payout.succeeded. Подписка на конкретные типы событий настраивается в личном кабинете в разделе «Вебхуки».
Paysido поддерживает нативную интеграцию с ведущими российскими платёжными сервисами. Все методы доступны через единый API без необходимости отдельных договоров с каждой системой.
Для приёма оплаты через SberPay передайте payment_method_type: sber_pay при создании платежа. Клиент будет перенаправлен в приложение СберБанк Онлайн для подтверждения. Поддерживаются десктопный и мобильный сценарии.
Интеграция с MIR Pay работает аналогично: payment_method_type: mir_pay. Метод доступен для физических лиц с картами МИР. При оплате с мобильного устройства клиент перенаправляется в банковское приложение через deep link.
Для генерации QR-кода СБП используйте метод /v1/payments с payment_method_type: sbp. В ответе возвращается qr_data (строка для QR-кода) и qr_image (base64-изображение). Оплата через СБП не требует 3-D Secure и обрабатывается мгновенно.
Перед началом интеграции можно протестировать работу инструментов в интерактивном режиме без написания кода — в sandbox-среде с тестовыми данными.
Интерактивное демо виджета доступно по адресу https://demo.paysido.com/widget. Вы можете проверить внешний вид на различных устройствах, протестировать сценарии успешной и отклонённой оплаты, а также настроить цветовую схему и набор отображаемых методов.
Демо платёжного конструктора позволяет сформировать тестовую платёжную форму с произвольными параметрами и получить готовый HTML-код для вставки. Демо доступно по адресу https://demo.paysido.com/constructor и не требует регистрации.
.webp)