ЮKassa: POST /pos_links — Активация кассовой ссылки

Используйте этот запрос, чтобы создать в ЮKassa объект кассовой ссылки и активировать кассовую ссылку для последующего приема платежей по платежным табличкам. В запросе необходимо передать кассовую ссылку и идентификатор торговой точки.

Документация: https://yookassa.ru/developers/api#create_pos_link

Параметр	Где	Тип	Обяз.	Описание
Idempotence-Key	header	string	да	Ключ идемпотентности. Рекомендуется использовать строку вида UUID v7
recipient	body	object	да	Идентификатор торговой точки. Например, конкретной кассы в вашем магазине. Вы получите идентификатор от менеджера ЮKassa при подключении платежей.
recipient.gateway_id	body	string	да	Идентификатор субаккаунта. Используется для разделения потоков платежей в рамках одного аккаунта.
pos_link_data	body	object	да	Данные кассовой ссылки — уникальной ссылки, зашифрованной в QR-коде и NFC-метке на платежной табличке.
pos_link_data.link	body	string	да	Кассовая ссылка с платежной таблички. Чтобы получить ее, отсканируйте QR-код на табличке.

Пример запроса:

{
  "recipient": {
    "gateway_id": "456"
  },
  "pos_link_data": {
    "link": "https://qr.nspk.ru/AD100003N2S98C2U48D6N60M12345678"
  }
}

Пример ответа:

{
  "id": "pl-1da5c87d-0984-50e8-a7f3-8de646dd9ec9",
  "status": "active",
  "type": "nspk",
  "recipient": {
    "gateway_id": "456"
  }
}

Базовые URL

• Основной: https://api.yookassa.ru/v3

Авторизация

Тип: Basic Auth

HTTP Basic Auth: имя пользователя — идентификатор магазина (shopId, раздел Настройки — Магазин) или шлюза для выплат (agentId, раздел Настройки выплат), пароль — секретный ключ (раздел Интеграция — Ключи API). Для тестового магазина ключ выпускается автоматически. Участники партнерской программы используют OAuth 2.0 и передают Bearer-токен. Секретный ключ и OAuth-токен нельзя публиковать.

curl https://api.yookassa.ru/v3/payments/{payment_id} \
  -u <Идентификатор магазина>:<Секретный ключ>

Нюансы

• capture по умолчанию false: без capture: true платеж останется в статусе waiting_for_capture и в момент expires_at отменится автоматически, деньги вернутся покупателю.
• Для POST и DELETE обязателен заголовок Idempotence-Key — до 64 символов, рекомендуется UUID. Повтор с тем же ключом в течение 24 часов вернет результат первого запроса; для новой операции нужен новый ключ.
• HTTP 500 не значит, что операция не прошла: результат неизвестен. Повтори запрос с теми же данными и тем же ключом идемпотентности или запроси объект через GET.
• Возврат покупателя на return_url не означает успешную оплату — статус проверяй на сервере или по HTTP-уведомлению.
• Сумма — строка с точкой и двумя знаками: "1000.00", вместе с кодом валюты.
• Методы /webhooks работают только с OAuth-токеном в партнерской программе. Обычный магазин настраивает уведомления в личном кабинете.
• Вернуть платеж можно в течение трех лет с момента создания. Комиссия ЮKassa за платеж не возвращается.
• Для Чеков от ЮKassa частичная предоплата, аванс и кредит не поддерживаются.

---

Если этого недостаточно — официальная документация: https://yookassa.ru/developers/api#create_pos_link Вся интеграция одним документом: https://mcp-everything.ru/integrations/yookassa.md