Corp-Merch SDKs for Poland
Official typed client libraries for Node.js, Python and PHP. Auto-retries, idempotency, webhook verification, sandbox built in.
What the SDKs include
Each SDK ships with: a typed client (TypeScript .d.ts / Python type stubs / PHP 8 attributes), automatic retries with exponential backoff, idempotency-key generation, webhook signature verification helper, sandbox/production toggle, structured error classes mapped from RFC 7807 problem+json. Tested against the real Poland catalog before every release.
Install commands
Node.js: npm install @corp-merch/sdk (or yarn add / pnpm add). Python: pip install corp-merch (Python 3.10+). PHP: composer require corp-merch/sdk (PHP 8.1+). All packages signed; lockfiles published. Minor version bumps weekly; semver-strict — no breaking changes outside major releases.
Country localisation
SDKs accept country='Poland' on init and automatically: apply VAT 23%, route invoices through KSeF, default fulfilment hub to Warszawa, format currency for the country locale. Override per-request via opts.country if needed (rare). Catalog responses include name_i18n for both English and pl.
FAQ
Which language should I pick?
Use what your team uses — feature parity is identical. Node.js most popular for our customers (45%), Python second (30%), PHP third (25%).
Do SDKs work in serverless?
Yes — small footprint (Node.js ~80 KB minified), no native deps. Tested on Vercel, AWS Lambda, Cloudflare Workers (with the @corp-merch/sdk-edge subpackage).
Is there a CLI?
npx @corp-merch/cli ships with the Node.js SDK — useful for catalog dumps, sandbox order creation, webhook payload inspection.
How are SDK errors structured?
All errors extend CorpMerchError with code (machine), message (human), httpStatus, detailUrl. Subclasses: ValidationError, AuthError, RateLimitError, ServerError, IdempotencyConflictError.
Versioning policy?
SemVer-strict. Major releases ~yearly with 12-month support overlap. Minor releases monthly. Security patches backported to last two majors.