10. Активная метка (ActiveTag)
Источник: https://docs.paykeeper.ru/dokumentatsiya-json-api/activetag/
10.1 Активация кассовой ссылки
Активация КС — создание заказа для последующей оплаты через QR-код. Перед активацией происходит принудительная деактивация (аннулирование предыдущего неоплаченного заказа).
Тип: POST
Формат: /change/sbpqr/activate
Параметры запроса:
| # | Параметр | Назначение | Обязательный |
|---|---|---|---|
| 1 | ps_id | ID платёжной системы | Нет |
| 2 | qrcId | ID QR-кода | Нет |
| 3 | sum | Сумма платежа | Да |
| 4 | paymentPurpose | Описание платежа для QR | Нет |
| 5 | ttl | Время жизни QR в минутах (максимум 20, по умолчанию 5) | Нет |
| 6 | token | Токен безопасности | Да |
| 7 | clientid | ID клиента | Нет |
| 8 | orderid | Номер заказа | Нет |
| 9 | service_name | Наименование услуги | Нет |
| 10 | client_email | Email клиента | Нет |
| 11 | client_phone | Телефон клиента | Нет |
| 12 | cart | Корзина товаров | Нет |
| 13 | login | Логин пользователя ЛК (иначе — из Basic) | Нет |
Пример cURL:
curl -u user:password 'https://example.server.paykeeper.ru/change/sbpqr/activate' \
--data-raw 'token=9b0d6d25bd2e6142bb803e3f9424ae99&ps_id=rsb&qrcId=AS1R002PG32BG00E812PBFPR38KR02BQ&sum=10&paymentPurpose=for_my_payment&ttl=10'Параметры ответа:
| # | Параметр | Назначение |
|---|---|---|
| 1 | qr_id | ID созданного QR-кода в СБП |
| 2 | qr_link | Ссылка на QR-код |
| 3 | qr_code | PNG-изображение QR-кода, base64 |
| 4 | payment_id | ID платежа в ЛК PayKeeper |
Пример ответа:
{
"qr_id": "BS1R00607TQTL42V9KLA90U43G7JCNC3",
"qr_link": "https://qr.nspk.ru/BS1R00607TQTL42V9KLA90U43G7JCNC3?type=01&bank=100000000014&crc=E0D2",
"qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKwAAACsAQMAAADc/9WbAAAABlBMVEX///8AAABVwtN+...",
"payment_id": "100"
}10.2 Активация универсальной активной метки
Тип: POST
Формат: /change/sbpqr/activatelnk
Параметры запроса:
| # | Параметр | Назначение | Обязательный |
|---|---|---|---|
| 1 | bill_id | ID созданного счёта | Да |
| 2 | token | Токен безопасности | Да |
Пример cURL:
curl -u user:password 'https://example.server.paykeeper.ru/change/sbpqr/activatelnk' \
--data-raw 'token=9b0d6d25bd2e6142bb803e3f9424ae99&bill_id=20260122092034356'Параметры ответа:
| # | Параметр | Назначение |
|---|---|---|
| 1 | status | Результат (success — при успехе) |
| 2 | shrinked_link | Ссылка на QR-код |
Пример ответа:
{
"status": "success",
"shrinked_link": "https://lnk.paykeeper.ru/active/XXXXXX"
}