SDK Corp-Merch для Италия
Официальные типизированные клиентские библиотеки для Node.js, Python и PHP. Auto-retry, идемпотентность, верификация webhook, встроенный sandbox.
Что включают SDK
Каждый SDK включает: типизированный клиент (TypeScript .d.ts / Python type stubs / PHP 8 attributes), автоматические retry с экспоненциальным backoff, генерация idempotency-key, helper верификации подписи webhook, toggle sandbox/production, структурированные классы ошибок из RFC 7807. Тестируются на реальном каталоге Италия перед каждым релизом.
Команды установки
Node.js: npm install @corp-merch/sdk. Python: pip install corp-merch (Python 3.10+). PHP: composer require corp-merch/sdk (PHP 8.1+). Все пакеты подписаны; lockfile публикуются. Minor — еженедельно; semver-strict — никаких breaking changes вне major-релизов.
Локализация под страну
SDK принимают country='Italy' при init и автоматически: применяют IVA 22%, маршрутизируют счета через SdI, default hub Милан, форматируют валюту под локаль страны. Override per-request через opts.country при необходимости. В каталоге name_i18n для английского и it.
FAQ
Какой язык выбрать?
Тот, который использует ваша команда — паритет функциональности. Node.js самый популярный (45%), Python второй (30%), PHP третий (25%).
SDK работают в serverless?
Да — небольшой footprint (Node.js ~80 KB), без нативных зависимостей. Протестированы на Vercel, AWS Lambda, Cloudflare Workers (с subpackage @corp-merch/sdk-edge).
Есть CLI?
npx @corp-merch/cli поставляется с Node.js SDK — полезно для дампа каталога, создания тестовых заказов в sandbox, инспекции webhook payload.
Как структурированы ошибки SDK?
Все ошибки наследуются от CorpMerchError с code, message, httpStatus, detailUrl. Подклассы: ValidationError, AuthError, RateLimitError, ServerError, IdempotencyConflictError.
Политика версионирования?
SemVer-strict. Major ~раз в год с 12-месячным overlap поддержки. Minor — ежемесячно. Security patches backportятся на последние два major.