Intercambiar un código OAuth

Intercambiar un código de autorización por un Access Token

Puedes tomar el código recibido como respuesta a una solicitud de permisos y hacer una solicitud para intercambiarlo por un Access Token y un Refresh Token. Para intercambiar tu code de autorización por un access token, realiza una solicitud a https://uni.staging.fluzapp.com/token/exchange con los siguientes parámetros de consulta:

query param	description
code	El token de autorización anterior
redirect_uri	el redirect_uri que usaste en el paso de autorización anterior. Este URI debe coincidir exactamente.

Además, configura un encabezado Authorization que sea una cadena codificada en base64 que combine tu client_id:app_secret. Este es un encabezado de autenticación Basic, por lo que debe seguir el siguiente formato: Authorization: Basic <base64 encoded CLIENT_ID:CLIENT_SECRET> Por ejemplo, si tu client_id es abc123 y tu client_secret de la configuración de OAuth es def456, el valor codificado en base64 sería YWJjMTIzOmRlZjQ1Ng==. El client_id y el client_secret se pueden encontrar en la pestaña Overview de Configurar app de OAuth. Aquí tienes un ejemplo de comando cURL:

curl -X GET "https://uni.staging.fluzapp.com/token/exchange?code=<the auth code>&redirect_uri=<the redirect_uri you used in the auth step>" -H "Authorization: Basic YWJjMTIzOmRlZjQ1Ng"

La respuesta incluirá:

query param	description
accessToken	Token de corta duración para solicitudes posteriores a los servicios backend de Fluz
refreshToken	refresh token para almacenar y usar cuando el accessToken haya expirado
scopes	los valores que el usuario permitió a través del flujo anterior

Aquí tienes un ejemplo de una respuesta completa:

{"accessToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTc1MjA5NDgwNH0.0dKCtVpN0mTHHMuGNNx4VLJisTnovFNPQKhSw6zWosc","authorizationCode":"f082972eb110b80f73b0d0f95d1de9266069a1e4","accessTokenExpiresAt":"2025-07-08T21:05:30.673Z","refreshToken":"8ec16c25951616150b0332a4a6d66547","refreshTokenExpiresAt":"2025-08-08T20:55:30.738Z","scope":\["MAKE\_WIDTHDRAW","MAKE\_DEPOSIT","LIST\_PAYMENT"],"client":\{"id":"dab5c80e-0321-4c3a-988a-ffedfd64d8db","app\_id":"0a92d46e-edf4-422e-8c62-946051e5067b","app\_name":"First OAuth integration","grants":\["authorization\_code","client\_credentials","password","refresh\_token"],"redirectUris":\["http\://localhost:3035/oauth/finalize"],"accessTokenLifetime":600},"user":\{"id":"5070d5a1-d71a-4190-91b0-f116eec51771"}}

​Intercambiar un código de autorización por un Access Token

Intercambiar un código de autorización por un Access Token