---
title: "Criar sessão de gerenciamento de usuário final com URL."
method: POST
path: "/open-keys/itp/api/v2/payment-initiation/management-sessions"
tags: ["Sessão de Gerenciamento de Iniciação de Pagamento"]
---

# Criar sessão de gerenciamento de usuário final com URL.

`POST /open-keys/itp/api/v2/payment-initiation/management-sessions`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/open-keys/itp/api/v2/payment-initiation/management-sessions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `http://localhost:8080/auth/realms/master/protocol/openid-connect/token` scopes: `app`

Método para criar uma sessão de gerenciamento de usuário final com URL.

## Request body

- CreateManagementSession
  - `data` CreateManagementSessionData, required
    - `userName` string: Name of the user who is logged in to the Payment Initiation institution
    - `loggedUser` CreateManagementSessionDataLoggedUser
      - `document` UserDocument, required
        - `identification` string, required: CPF number of the natural person, composed of 11 numeric digits without dots, dashes or spaces. Must be a valid CPF according to the Brazilian Federal Revenue validation algorithm.
        - `rel` string, required: Type of identification document. For Brazilian natural persons, always 'CPF' (Individual Taxpayer Registry). Identifies the type of document presented in the identification field.
    - `businessEntity` CreateManagementSessionDataBusinessEntity
      - `document` BusinessDocument, required
        - `identification` string, required: CNPJ number of the legal entity, composed of 14 numeric digits without dots, slashes or spaces. Must be a valid CNPJ according to the Brazilian Federal Revenue validation algorithm.
        - `rel` string, required: Type of identification document. For Brazilian legal entities, always 'CNPJ' (National Registry of Legal Entities). Identifies the type of document presented in the identification field.
    - `redirectUrl` string, uri: Authorized redirect URI by the application for post-management session flow

## Response `200`

End user management session successfully returned.

- ManagementSession
  - `url` string, uri, required: Authenticated URL for accessing the payment initiation management interface with embedded opaque token for secure session access.

## Other responses

- `401`: Authentication is required to access this resource. The client must provide valid credentials.
- `403`: The server understood the request but refuses to authorize it. Access is permanently forbidden and tied to the application logic.
- `409`: The request conflicts with the current state of the resource on the server.
- `422`: The request contains invalid or malformed data that cannot be processed.
- `500`: An unexpected error occurred on the server while processing the request.
- `default`: Unexpected error.

---

[API](https://skmtc.dev/celcoin/apis/api-para-transa-es.md) - [All operations](https://skmtc.dev/celcoin/apis/api-para-transa-es/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-para-transa-es/revisions/85dd6188a37b?raw)