Obtener token ACG (envío del pago)

post

https://api.{environment}redebanopenfinance.com/{BankId}/token.oauth2/v1

Token ACG — grant_type=authorization_code. El TPP obtiene el access token requerido para enviar el pago (POST /{Bank}/domestic-payments/v1, paso 8), presentando el code recibido tras la SCA.

Es el mismo endpoint del paso 2 (/{Bank}/token.oauth2/v1); aquí se documenta su segundo uso. La URL real es idéntica.

El cliente utiliza el punto final del token para obtener un token de acceso presentando su token de concesión de autorización o de actualización.

Path Params

BankId

string

required

Identificador único del banco registrado que va en el PATH de la API.

Form Data

Cuerpo de petición para grant_type=authorization_code. Se usa después de que el usuario completó la SCA en el banco y el TPP recibió un code en la redirección. El access token resultante habilita el envío del pago.

grant_type

string

enum

required

Debe ser exactamente authorization_code.

Allowed:

client_id

string

required

ID de cliente registrado en la plataforma de APIs de Redeban.

client_assertion_type

string

enum

required

Tipo de aserción estándar de OAuth2.

Allowed:

client_assertion

string

required

JWT firmado por el cliente con su clave privada (método private_key_jwt).

code

string

required

Código de autorización temporal emitido al cliente después de que el usuario autentica y autoriza exitosamente en el endpoint de autorización del banco.

redirect_uri

string

required

URL de redirección del TPP, debe coincidir con la registrada durante el DCR y la usada en la solicitud de autorización.

code_verifier

string

PKCE code_verifier: cadena criptográficamente aleatoria emparejada con el code_challenge enviado en la solicitud de autorización (RFC 7636).

Headers

DPoP

string

required

Una demostración de un token Proof-of-Possession (DPoP) según el estándar RFC 9449.

x-fapi-interaction-id

string

Un UID RFC4122 utilizado como un ID de correlación.

Responses

200OK

400Bad request

401Unauthorized

403Forbidden

500Internal Server Error