Аутентификация
Все запросы к API выполняются по HTTPS и требуют заголовка Authorization с API-ключом, который можно выпустить в личном кабинете.
curl https://api.poscenter.kz/v1/terminals \
-H "Authorization: Bearer YOUR_API_KEY"☝️ Важно: Храните ключ в секрете
Не передавайте API-ключ в клиентском коде и не публикуйте его в публичных репозиториях. При компрометации немедленно отзовите ключ в личном кабинете.
Основные эндпоинты
| Метод | Путь | Описание |
|---|---|---|
| GET | /v1/terminals | Список терминалов аккаунта |
| GET | /v1/terminals/{id}/status | Статус конкретного терминала |
| POST | /v1/receipts | Создать чек |
| GET | /v1/receipts/{id} | Получить чек по идентификатору |
Пример ответа
Ответ на GET /v1/terminals/{id}/status:
{
"id": "term_9f21ab",
"status": "online",
"last_seen": "2026-07-13T10:42:00Z",
"firmware_version": "2.4.0"
}