Центр разработчика
Интеграция с NineLogix
Текущие endpoints v1 принимают только Test-учетные данные для конкретного Store. Можно создавать тестовые заказы и проверять их через checkout NineLogix; Live-ключи и реальные платежи остаются под отдельным Gate.
Быстрый старт
- Получите тестовые Merchant ID, Store ID и одноразово отображаемый тестовый ключ в Merchant Portal.
- Используйте стабильный Idempotency-Key для каждого запроса на создание.
- Направьте клиента на возвращенный NineLogix checkout_url.
- Подтвердите итоговый статус через 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 не предоставляет права на возвраты, расчеты или выплаты.