---
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: `http://localhost:3000`
- URL: `http://localhost:3000/open-keys/itp/api/v2/payment-initiation/management-sessions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://keycloak.sandbox.shared.fsapps.io/auth/realms/openkeys-itp-v2-sandbox-dev/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: O nome do usuário que encontra-se logado
    - `loggedUser` CreateManagementSessionDataLoggedUser, required
      - `document` UserDocument, required
        - `identification` string, required
        - `rel` string, required
    - `businessEntity` CreateManagementSessionDataBusinessEntity
      - `document` BusinessDocument, required
        - `identification` string, required
        - `rel` string, required

## Response `200`

End user management session successfully returned.

- ManagementSession
  - `url` string, uri, required: URL da sessão de gerenciamento do usuário final.

## Other responses

- `401`: É necessária autenticação para acessar este recurso. O cliente deve fornecer credenciais válidas.
- `403`: O servidor entendeu a solicitação, mas se recusa a autorizá-la. O acesso é permanentemente proibido e vinculado à lógica da aplicação.
- `409`: A solicitação está em conflito com o estado atual do recurso no servidor.
- `422`: A solicitação contém dados inválidos ou mal formados que não podem ser processados.
- `500`: Ocorreu um erro inesperado no servidor ao processar a solicitação.
- `default`: Erro inesperado.

---

[API](https://skmtc.dev/celcoin/apis/api-itp-v2.md) - [All operations](https://skmtc.dev/celcoin/apis/api-itp-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-itp-v2/revisions/be47794b8e2c?raw)