Cliente

ClientsClient expone la identidad y los permisos del cliente B2B autenticado (con alcance de token). Es el cliente de dominio más chico — un único método de solo lectura — y una buena primera llamada para confirmar que tus credenciales y tu firma son correctas antes de tocar movimiento de dinero.

Accede directamente en RetornaClient o a través de client.clients() — las dos formas ejecutan el mismo código.

getMyClient()

Devuelve información de identidad y permisos del cliente al que pertenecen las credenciales actuales.

Firma

public ClientResponse getMyClient()

Parámetros

Este método no toma parámetros.

Retorno

ClientResponse:

Accesor	Tipo	Significado
client()	ClientInfo	Identidad y permisos — ver abajo.
funding()	Map<String, Object>	Opaco, nullable. No se documenta en más detalle aquí; trátalo como no estructurado.

ClientInfo:

Accesor	Tipo	Significado
id()	String	UUID del cliente.
client()	String	Clave/slug interno del cliente.
name()	String	Nombre para mostrar.
isActive()	boolean	Si el cliente está activo.
permissions()	List<String>	Strings de permisos otorgados.

Ejemplo

import app.retorna.sdk.RetornaClient;
import app.retorna.sdk.RetornaClientBuilder;
import app.retorna.sdk.core.environment.RetornaEnvironment;
import app.retorna.sdk.models.client.ClientResponse;

RetornaClient client = new RetornaClientBuilder()
        .environment(RetornaEnvironment.SANDBOX)
        .clientId(System.getenv("RETORNA_CLIENT_ID"))
        .clientSecret(System.getenv("RETORNA_CLIENT_SECRET"))
        .privateKey(System.getenv("RETORNA_PRIVATE_KEY"))
        .buildClient();

ClientResponse me = client.getMyClient();
System.out.printf("%s (active=%s) permissions=%s%n",
        me.client().name(), me.client().isActive(), me.client().permissions());

Errores

• RetornaB2BException con codeEnum() uno de: B2B_UNAUTHORIZED — token o firma rechazados, B2B_COMPANY_NOT_FOUND, B2B_RATE_LIMITED — reintentable, B2B_UNKNOWN. Revisa e.codeEnum().isRetryable().
• RetornaAuthException — falló el propio intercambio de token OAuth2.
• RetornaSdkException — falla de red o falla de deserialización.

Notas

• Si esta llamada lanza una excepción, el tipo te dice si el problema fue tu token (RetornaAuthException) o tu firma (RetornaB2BException con B2B_UNAUTHORIZED) — una buena primera llamada al conectar un entorno nuevo.
• No hay una página pública de referencia de la API para este endpoint (no forma parte de la referencia de la API publicada).