Создание платёжной сущности
Ваш сайт или backend создаёт платёж через API LinksyPay. В запрос передаются сумма, идентификатор заказа, описание и служебные поля, необходимые для внутренней синхронизации.
Техническая часть
Интеграция LinksyPay API под реальный продовый сценарий оплаты
Страница для тех, кому важно понять логику: как создаётся платёж, когда появляется QR-код, как приходит webhook, что нужно сайту для синхронной и асинхронной обработки статусов.
LinksyPay API
REST / JSON
POST /v1/payments
create
GET /v1/payments/{id}
status
POST /v1/webhooks/test
check
QR delivery
instant
Старт
Как строится подключение
Интеграция делится на понятные шаги, чтобы команда разработки сразу видела конечный сценарий.
Выдача клиенту QR или платёжной ссылки
После создания платежа система возвращает идентификатор, ссылку на оплату и адрес QR-кода. Эти данные можно сразу встроить в страницу оплаты, попап или отдельный checkout-блок.
Получение статусов и webhook-событий
При изменении состояния платежа ваш backend получает webhook. Так сайт не зависит только от опроса и может автоматически закрывать заказ, менять статус услуги или запускать выдачу цифрового продукта.
Контроль через кабинет
Операционная команда видит платежи, суммы, статусы и историю событий. Это снижает нагрузку на ручные проверки и ускоряет разбор спорных ситуаций.
Архитектура
Базовая схема взаимодействия
Ниже показана понятная модель для продового сценария: фронтенд вызывает ваш backend, backend — LinksyPay API, а статусы приходят обратно в вашу систему через webhook.
Сайт / Frontend
→
Ваш Backend
→
LinksyPay API
↓
Webhook → Обновление заказа / услуги / подписки
Примеры методов
Как может выглядеть базовый набор
POST
/v1/payments
Создание платёжной сессии и получение ссылки / QR для оплаты.
{
"amount": 14900,
"currency": "RUB",
"order_id": "ORD-4021",
"description": "Оплата заказа",
"metadata": {
"client_id": "9182"
}
}
GET
/v1/payments/{payment_id}
Получение текущего статуса платежа и данных по счёту.
{
"payment_id": "LS-4021",
"status": "paid",
"amount": 14900,
"paid_at": "2026-03-12T11:42:16Z"
}
POST
Webhook: payment.updated
Асинхронное уведомление о смене статуса платежа.
{
"event": "payment.updated",
"payment_id": "LS-4021",
"status": "paid",
"order_id": "ORD-4021"
}
Что важно для продового запуска
Точки, которые обычно учитывают заранее
- Идемпотентность запросов на создание платежа
- Подпись webhook-событий и проверка источника
- Повторная отправка события при недоставке
- Request ID и история вызовов для поддержки
- Разделение тестовой и боевой среды
Подходит для
Кому особенно удобен такой сценарий
- Интернет-магазинам с быстрым checkout-потоком
- Сервисам бронирования и записи
- Цифровым продуктам и SaaS
- Маркетплейсам и платформенным сервисам
- Сайтам услуг, где нужен простой и понятный способ оплаты
LinksyPay API