Introducción al SDK de Java

Bienvenido al SDK de Retorna para Java. Este SDK te permite integrar de forma sencilla y segura los servicios B2B de Retorna dentro de tus aplicaciones Java.

¿Qué es el SDK de Retorna?

El SDK de Retorna es una biblioteca que permite a las empresas realizar pagos, cobros, consultas de transacciones, conciliaciones, creación de órdenes y automatización de flujos financieros mediante una interfaz unificada y fácil de usar.

Características Principales

• ✅ Autenticación Automática: El SDK maneja automáticamente la autenticación OAuth2 y la renovación de tokens
• ✅ Firmas Digitales: Soporte completo para firmas RSA para seguridad adicional
• ✅ Manejo de Errores: Sistema robusto de manejo de errores con categorización
• ✅ Thread-Safe: El cliente es seguro para usar en entornos multi-hilo
• ✅ Logging Estructurado: Sistema de logging configurable para debugging
• ✅ Validación por País: Validadores específicos para cada país/plataforma

Requisitos

• Java 17 o superior
• Maven 3.6 o superior

Inicio Rápido

import com.retorna.sdk.config.Environment;
import com.retorna.sdk.config.LoggingLevel;
import com.retorna.sdk.core.RetornaClient;
import com.retorna.sdk.core.RetornaClientOptions;

// Crear cliente
RetornaClient client = RetornaClient.create(
    RetornaClientOptions.builder()
        .environment(Environment.DEVELOP)
        .loggingLevel(LoggingLevel.INFO)
        .clientId("YOUR_CLIENT_ID")
        .clientSecret("YOUR_CLIENT_SECRET")
        .privateKey("YOUR_PRIVATE_KEY_PEM")
        .build()
);

// Obtener balance
BalanceResponse balance = client.account.getBalance();
System.out.println("Balance: " + balance.getTotalBalance());

Próximos Pasos

• Instalación - Aprende cómo instalar el SDK
• Configuración - Configura el SDK para tu entorno
• Guía de Cuenta - Trabaja con operaciones de cuenta
• Guía de Cotizaciones - Crea y consulta cotizaciones
• Guía de Órdenes - Crea y gestiona órdenes de pago