> For the complete documentation index, see [llms.txt](https://doc.ecomm.api.tietoevry.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/integraciones/sdk-de-la-api-unificada-para-comerciantes.md). # SDK de la API Unificada para Comerciantes El SDK de la API Unificada para Comerciantes proporciona SDKs del lado servidor, listos para producción, para integrar las aplicaciones backend del comerciante con la Pasarela de Pagos. Disponible para Java, .NET y PHP, el SDK abstrae la autenticación, el cifrado, la comunicación con la API y la gestión de webhooks, permitiendo a los desarrolladores centrarse en la lógica de negocio en lugar de en la infraestructura de pagos. Tanto si estás construyendo una plataforma de comercio electrónico personalizada, integrándola en un sistema ERP o ampliando un checkout existente, el SDK proporciona un modelo de integración coherente y seguro en todos los lenguajes compatibles. ## Beneficios El SDK de la API Unificada para Comerciantes simplifica la integración de pagos en el backend al proporcionar bibliotecas reutilizables que estandarizan la comunicación con la Pasarela de Pagos. #### Compatibilidad multilenguaje Usa el SDK en tu tecnología backend preferida manteniendo un modelo de integración coherente. Las plataformas compatibles incluyen: * Java * .NET * PHP #### Integración más rápida Reduce el esfuerzo de desarrollo con componentes preconstruidos para autenticación, comunicación con la API, cifrado y notificaciones de pago. #### Diseñado con seguridad Las capacidades de seguridad están integradas en el SDK, reduciendo la complejidad de implementación al tiempo que se admite un procesamiento de pagos seguro. #### Listo para producción El SDK incluye un manejo de errores sólido, modelos de solicitud tipados y componentes reutilizables adecuados para integraciones de pagos empresariales. ## Capacidades principales ### Autenticación Acceso seguro a la Pasarela de Pagos mediante OAuth 2.0. Las características incluyen: * Gestión automática de tokens de acceso * Autenticación con credenciales de cliente * Conexión segura a los entornos Sandbox y de Producción ### Cifrado seguro La información sensible de pago se cifra antes de su transmisión a la Pasarela de Pagos. Las capacidades incluyen: * Cifrado JWE del lado del cliente * Manejo seguro del payload * Gestión automática de claves de cifrado ### Cliente API de la Pasarela El SDK proporciona bibliotecas cliente fuertemente tipadas para interactuar con la Pasarela de Pagos. Las operaciones compatibles incluyen: * Servicios para comerciantes * Iniciación de pagos * Obtención del estado del pago * Sesiones de checkout * Gestión de tokens * Operaciones de pago ### Compatibilidad con webhooks Recibe notificaciones asíncronas de la Pasarela de Pagos para mantener los sistemas backend sincronizados con los eventos de pago. Las notificaciones típicas incluyen: * Pago completado * Pago fallido * Pago cancelado * Reembolso procesado * Actualizaciones de estado ### Modelos reutilizables El SDK incluye modelos tipados de solicitud y respuesta que reducen el esfuerzo de desarrollo y mejoran la calidad del código. Los beneficios incluyen: * Objetos de solicitud basados en builder * Tipado fuerte * Validación integrada * Estructura de API coherente ### Productividad del desarrollador Diseñado para acelerar el desarrollo mediante componentes reutilizables y APIs simplificadas. El SDK proporciona: * APIs fluidas * Manejo de errores estandarizado * Serialización integrada * Registro configurable * Arquitectura extensible ## Flujo típico de integración ``` Backend del comerciante (Java | .NET | PHP) │ ▼ SDK de la API Unificada para Comerciantes │ ├── Autenticación ├── Cifrado ├── Validación de solicitudes ├── Comunicación con la API └── Procesamiento de webhooks │ ▼ Pasarela de Pagos │ ▼ Redes de pago / adquirentes │ ▼ Resultado del pago │ ▼ Backend del comerciante ``` ## Rol de despliegue El SDK de la API Unificada para Comerciantes actúa como la capa de integración entre la aplicación backend del comerciante y la Pasarela de Pagos. El backend del comerciante sigue siendo responsable de: * Gestión de pedidos * Gestión de clientes * Orquestación del checkout * Reglas de negocio * Gestión de inventario * Procesamiento posterior al pago El SDK es responsable de: * Conectividad segura con la pasarela * Autenticación * Cifrado de solicitudes * Comunicación con la API * Procesamiento de webhooks * Manejo de errores ## Cuándo usar el SDK de la API Unificada para Comerciantes Se recomienda el SDK para comerciantes que necesitan: * Integraciones personalizadas de comercio electrónico * Procesamiento de pagos en el backend * Comunicación segura servidor a servidor * Compatibilidad de desarrollo multilenguaje * Integración simplificada con la pasarela * Servicios de pago de nivel empresarial --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://doc.ecomm.api.tietoevry.com/tietoevry-egw-documentation-es/integraciones/sdk-de-la-api-unificada-para-comerciantes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.