For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

Última actualización

¿Te fue útil?