Центр разработчика

Интеграция с NineLogix

Текущие endpoints v1 принимают только Test-учетные данные для конкретного Store. Можно создавать тестовые заказы и проверять их через checkout NineLogix; Live-ключи и реальные платежи остаются под отдельным Gate.

Быстрый старт

  1. Получите тестовые Merchant ID, Store ID и одноразово отображаемый тестовый ключ в Merchant Portal.
  2. Используйте стабильный Idempotency-Key для каждого запроса на создание.
  3. Направьте клиента на возвращенный NineLogix checkout_url.
  4. Подтвердите итоговый статус через API или проверенный webhook.
curl https://www.ninelogix.com/api/v1/checkout-sessions \
  -H "Authorization: Bearer nlx_test_..." \
  -H "Idempotency-Key: order-demo-001" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"demo-001","price_id":"nlx_price_approved"}'

Аутентификация & Среды

Используйте Bearer API key. Тестовые ключи nlx_test_ ограничены одобренными scope; открытый ключ показывается один раз, NineLogix хранит только хеш. Производственные учетные данные требуют отдельного одобрения. Создание тестового ключа никогда не открывает реальные транзакции.

Webhook

События содержат уникальные event_id и временную метку. Проверяйте HMAC-SHA256 по исходному телу, отклоняйте устаревшие метки и сравнивайте подписи за постоянное время. Страница возврата не определяет итоговый статус. Test Webhook использует зашифрованный восстанавливаемый секрет, неизменяемые события и аудит доставки; повтор доставляет то же событие и никогда не повторяет платеж.

const expected = createHmac("sha256", secret)
  .update(timestamp + "." + rawBody)
  .digest("hex");
// Reject stale timestamps and compare signatures in constant time.

Ошибки и проверка запуска

401 — недействительные или отсутствующие учетные данные API · 403 — отсутствует scope, доступ к среде или производственное одобрение · 409 — конфликт состояния или идемпотентности · 400 — недействительный запрос · 429 — превышен лимит запросов.

Перед запуском: производственные данные одобрены, Store и возможности активны, адреса возврата зарегистрированы, подпись webhook и идемпотентный повтор проверены, а производственный Gate открыт администратором.

Текущие границы

Checkout принимает только утвержденный price_id. Сумма, валюта, модель тарификации и доступные способы оплаты определяются каталогом NineLogix и назначениями возможностей Store. Доступ к API не предоставляет права на возвраты, расчеты или выплаты.