SDKs Corp-Merch para Portugal
Bibliotecas cliente oficiais tipadas para Node.js, Python e PHP. Retries automáticos, idempotência, verificação webhook, sandbox integrado.
O que os SDKs incluem
Cada SDK inclui: cliente tipado (TypeScript.d.ts / Python type stubs / PHP 8 attributes), retries automáticos com backoff exponencial, geração de idempotency-key, helper de verificação de assinatura webhook, toggle sandbox/produção, classes de erro estruturadas a partir de RFC 7807. Testados contra o catálogo real de Portugal antes de cada release.
Comandos de instalação
Node.js: npm install @corp-merch/sdk. Python: pip install corp-merch (Python 3.10+). PHP: composer require corp-merch/sdk (PHP 8.1+). Todos os pacotes assinados; lockfiles publicados. Minor semanal; semver-strict — sem breaking changes fora de majors.
Localização do país
SDKs aceitam country='Portugal' no init e automaticamente: aplicam IVA 23%, encaminham faturas via Portal das Finanças (AT), hub padrão Lisboa, formatam moeda para locale português. Override per-request via opts.country se necessário. Catálogo inclui name_i18n para inglês e português.
FAQ
Que linguagem escolher?
A que a sua equipa usa — paridade de features. Node.js mais popular (45%), Python segundo (30%), PHP terceiro (25%).
Os SDKs funcionam em serverless?
Sim — footprint pequeno (Node.js ~80 KB), sem dependências nativas. Testados em Vercel, AWS Lambda, Cloudflare Workers (com subpackage @corp-merch/sdk-edge).
Existe uma CLI?
npx @corp-merch/cli vem com o SDK Node.js — útil para dump de catálogo, criação de ordens sandbox, inspeção de payloads webhook.
Como estão estruturados os erros?
Todos os erros estendem CorpMerchError com code, message, httpStatus, detailUrl. Subclasses: ValidationError, AuthError, RateLimitError, ServerError, IdempotencyConflictError.
Política de versionamento?
SemVer-strict. Majors anuais com 12 meses de sobreposição de suporte. Minors mensais. Patches de segurança retroportados nos últimos dois majors.
Todas as páginas desta secção
7 páginas nesta secção.