---
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`

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.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)