SDKs Corp-Merch para España
Bibliotecas cliente oficiales tipadas para Node.js, Python y PHP. Reintentos automáticos, idempotencia, verificación de webhooks, sandbox integrado.
Qué incluyen los SDKs
Cada SDK incluye: cliente tipado (TypeScript.d.ts / Python type stubs / PHP 8 attributes), reintentos automáticos con backoff exponencial, generación de idempotency-key, helper de verificación de firma webhook, toggle sandbox/producción, clases de error estructuradas desde RFC 7807. Probados contra el catálogo real español antes de cada release.
Comandos de instalación
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 los paquetes firmados; lockfiles publicados. Minor semanal; semver-strict — sin breaking changes fuera de majors.
Localización por país
Los SDKs aceptan country='Spain' en init y automáticamente: aplican IVA 21%, enrutan facturas vía FACe/SII (AEAT), hub por defecto Madrid, formatean moneda para locale español. Override per-request vía opts.country si es necesario. Catálogo incluye name_i18n para inglés y español.
FAQ
¿Qué lenguaje elegir?
El que use tu equipo — paridad de funcionalidades. Node.js más popular (45%), Python segundo (30%), PHP tercero (25%).
¿Los SDKs funcionan en serverless?
Sí — footprint pequeño (Node.js ~80 KB), sin dependencias nativas. Probados en Vercel, AWS Lambda, Cloudflare Workers (con subpaquete @corp-merch/sdk-edge).
¿Hay CLI?
npx @corp-merch/cli se distribuye con el SDK Node.js — útil para dumps de catálogo, creación de pedidos sandbox, inspección de payloads webhook.
¿Cómo se estructuran los errores?
Todos los errores extienden CorpMerchError con code, message, httpStatus, detailUrl. Subclases: ValidationError, AuthError, RateLimitError, ServerError, IdempotencyConflictError.
¿Política de versionado?
SemVer-strict. Majors anuales con 12 meses de overlap de soporte. Minors mensuales. Parches de seguridad retroportados a las últimas dos majors.
Las páginas de la sección «SDKs Corp-Merch para España»
7 páginas en esta sección.