Payments V4 - List Journey Session API

Visão Geral

Esta API permite a listagem de sessões de jornada de payments.

Endpoint

GET /open-keys/itp/api/v2/payments/v4/journeys-sessions

Autenticação

A API requer autenticação OAuth2 com a seguinte permissão:

app: Para integrações diretas via API

O token de acesso deve ser enviado no header:

Authorization: Bearer {access_token}

Estrutura da Requisição

Parâmetros que podem ser enviados

{
  "pageSize": 10,
  "page": 1
}

Campos da Requisição

Nível Raiz

Campo	Tipo	Obrigatório	Descrição
`pageSize`	Number	Não	Quantidade de itens por página
`page`	Number	Não	Página atual da listagem

Exemplo de Requisição (cURL)

curl --location 'https://api.exemplo.com/open-keys/itp/api/v2/payments/v4/journeys-sessions?pageSize=10&page=1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Resposta da API

Sucesso (200 OK)

A API retorna um objeto contendo:

{
    "data": [
        {
            "journeyId": "{journeyId}",
            "paymentInitiationApi": "PAYMENTS_V4",
            "applicationId": "{applicationId}",
            "tokenId": "{tokenId}",
            "journeySessionStageId": "{journeySessionStageId}",
            "journeySessionUrl": "{url}",
            "status": "PENDING",
            "id": "{id}",
            "..."
        }
    ],
    "meta": {
        "total": 242,
        "page": 1,
        "pageSize": 10,
        "totalPages": 25
    }
}

Erros Comuns

401 Unauthorized

{
    "error": "Unauthorized",
    "message": "Token inválido ou expirado"
}

Solução: Verifique se o token de acesso é válido e possui a permissão necessária (app).