Поток запроса производственного API

Рекомендуемый порядок запросов для активных операций с явной областью владения и возможностью аудита транзакций.

  1. Выполните аутентификацию и получите ключ JWT пользователя или API приложения.
  2. Создавайте или обновляйте продукты с помощью /v1/products (POST, PUT, PATCH); видеть Продукты API CRUD и многоязычные примеры.
  3. Начните оформление заказа через Pay, указав идентификатор продукта.
  4. Получайте и проверяйте подписи обратного вызова/веб-перехватчика (payment.confirmed + зеркало проверить).
  5. Запрос результатов транзакции из /v1/transaction/status или /v1/transactions - видеть Детали транзакции.

Обязательные заголовки

Authorization: Bearer <token>
Content-Type: application/json

Базовый уровень обработки ошибок

  • Повторите временные сбои (5xx) с экспоненциальной задержкой.
  • Обращаться 401/403 как проблемы с авторизацией/разрешением.
  • Обращаться 409 как бизнес-конфликты (например, блокировщики удаления продуктов).
  • Записывайте идентификаторы транзакций, идентификаторы событий веб-перехватчиков и идентификаторы запросов для отслеживания.