Guía de Cuenta

Esta guía te muestra cómo trabajar con operaciones de cuenta usando el SDK de Retorna.

Obtener Balance

Obtén el balance total de tu cuenta:

import com.retorna.sdk.account.BalanceResponse;

BalanceResponse balance = client.account.getBalance();
System.out.println("Balance total: " + balance.getTotalBalance());
System.out.println("Moneda: " + balance.getCurrency());

Con Parámetros Opcionales

Puedes pasar parámetros adicionales como filtros:

import java.util.HashMap;
import java.util.Map;

Map<String, Object> params = new HashMap<>();
params.put("currency", "USD");

BalanceResponse balance = client.account.getBalance(params);

Obtener Rutas de Pago

Obtén todas las rutas de pago disponibles:

import com.retorna.sdk.account.PayoutRoute;
import java.util.List;

List<PayoutRoute> routes = client.account.getRoutes();

for (PayoutRoute route : routes) {
    System.out.println("Ruta: " + route.getName());
    System.out.println("País: " + route.getCountry());
    System.out.println("Estado: " + route.getStatus());
    System.out.println("---");
}

Filtrar Rutas

Filtra las rutas por país, moneda u otros criterios:

Map<String, Object> params = new HashMap<>();
params.put("country", "CO");
params.put("currency", "COP");

List<PayoutRoute> routes = client.account.getRoutes(params);

Información de Rutas

Cada PayoutRoute contiene información detallada:

PayoutRoute route = routes.get(0);

// Información básica
String name = route.getName();
String country = route.getCountry();
PayoutRouteStatus status = route.getStatus();

// Límites
PayoutRouteLimits limits = route.getLimits();
Double minAmount = limits.getMinAmount();
Double maxAmount = limits.getMaxAmount();

// Montos disponibles
PayoutRouteAmounts amounts = route.getAmounts();
Double available = amounts.getAvailable();

Ejemplo Completo

import com.retorna.sdk.config.Environment;
import com.retorna.sdk.config.LoggingLevel;
import com.retorna.sdk.core.RetornaClient;
import com.retorna.sdk.core.RetornaClientOptions;
import com.retorna.sdk.account.BalanceResponse;
import com.retorna.sdk.account.PayoutRoute;
import java.util.List;
import java.util.Map;
import java.util.HashMap;

public class AccountExample {
    public static void main(String[] args) {
        RetornaClient client = RetornaClient.create(
            RetornaClientOptions.builder()
                .environment(Environment.DEVELOP)
                .loggingLevel(LoggingLevel.INFO)
                .clientId(System.getenv("RETORNA_CLIENT_ID"))
                .clientSecret(System.getenv("RETORNA_CLIENT_SECRET"))
                .privateKey(System.getenv("RETORNA_PRIVATE_KEY"))
                .build()
        );
        
        try {
            // Obtener balance
            BalanceResponse balance = client.account.getBalance();
            System.out.println("=== Balance ===");
            System.out.println("Total: " + balance.getTotalBalance());
            System.out.println("Moneda: " + balance.getCurrency());
            
            // Obtener rutas
            List<PayoutRoute> routes = client.account.getRoutes();
            System.out.println("\n=== Rutas Disponibles ===");
            for (PayoutRoute route : routes) {
                System.out.println("Nombre: " + route.getName());
                System.out.println("País: " + route.getCountry());
                System.out.println("Estado: " + route.getStatus());
                
                if (route.getLimits() != null) {
                    System.out.println("Min: " + route.getLimits().getMinAmount());
                    System.out.println("Max: " + route.getLimits().getMaxAmount());
                }
                System.out.println("---");
            }
            
            // Filtrar rutas por país
            Map<String, Object> params = new HashMap<>();
            params.put("country", "CO");
            List<PayoutRoute> colombiaRoutes = client.account.getRoutes(params);
            System.out.println("\n=== Rutas de Colombia ===");
            System.out.println("Total: " + colombiaRoutes.size());
            
        } catch (Exception e) {
            System.err.println("Error: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Manejo de Errores

try {
    BalanceResponse balance = client.account.getBalance();
} catch (RuntimeException e) {
    // Error de API (4xx, 5xx)
    System.err.println("Error de API: " + e.getMessage());
} catch (Exception e) {
    // Error de red, parsing, etc.
    System.err.println("Error general: " + e.getMessage());
    e.printStackTrace();
}

Siguiente Paso

• Guía de Cotizaciones - Aprende a crear y consultar cotizaciones
• Guía de Órdenes - Aprende a crear y gestionar órdenes de pago