---
title: "Consulta de dados de pagamentos"
method: GET
path: "/api/v1/transaction"
tags: ["Pagamentos"]
---

# Consulta de dados de pagamentos

`GET /api/v1/transaction`

**Consulta de Pagamento**. Este endpoint permite consultar os detalhes de um pagamento específico. <br/> <br/> <br/> **Requisição**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th><th>Obrigatoriedade</th></tr></thead><tbody><tr><td>transaction_id</td><td>Texto</td><td>ID único da transação</td><td>Sim</td></tr><tr><td>client-id</td><td>Texto</td><td>Client ID enviado no header</td><td>Sim</td></tr></tbody></table><br/><br/>**Resposta 200**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>message</td><td>Texto</td><td>Mensagem sobre a consulta</td></tr><tr><td>Tipo da transação</td><td>Texto</td><td>Tipo da transação</td></tr><tr><td>Status</td><td>Texto</td><td>Status da transação</td></tr><tr><td>Beneficiario</td><td>Texto</td><td>Nome do beneficiário</td></tr><tr><td>Data de criação do pagamento</td><td>Texto</td><td>Data de criação do pagamento</td></tr><tr><td>Valor</td><td>Texto</td><td>Valor do pagamento</td></tr><tr><td>descrição</td><td>Texto|null</td><td>Descrição do pagamento</td></tr><tr><td>errors</td><td>Texto|null</td><td>Erros retornados, se houver</td></tr><tr><td>statusCode</td><td>Inteiro</td><td>Código HTTP da resposta</td></tr><tr><td>status</td><td>Boleano</td><td>Status da operação</td></tr></tbody></table><br/><br/>**Resposta 201**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>message</td><td>Texto</td><td>Mensagem sobre a consulta</td></tr><tr><td>Tipo da transação</td><td>Texto</td><td>Tipo da transação</td></tr><tr><td>Beneficiario</td><td>Texto</td><td>Nome do beneficiário</td></tr><tr><td>Data de efetivação do pagamento</td><td>Texto</td><td>Data de efetivação do pagamento</td></tr><tr><td>Valor</td><td>Texto</td><td>Valor do pagamento</td></tr><tr><td>descrição</td><td>Texto|null</td><td>Descrição do pagamento</td></tr><tr><td>errors</td><td>Texto|null</td><td>Erros retornados, se houver</td></tr><tr><td>statusCode</td><td>Inteiro</td><td>Código HTTP da resposta</td></tr><tr><td>status</td><td>Boleano</td><td>Status da operação</td></tr></tbody></table>

## Query parameters

- `id` string, uuid, required

## Headers

- `client-id` string, uuid, required

## Response `200`

Pagamento consultado com sucesso

- object
  - `message` string
  - `Tipo da transação` string
  - `Status` string
  - `Beneficiario` string
  - `Data de criação do pagamento` string
  - `Valor` string
  - `descrição` string, nullable
  - `errors` string, nullable
  - `statusCode` integer
  - `status` boolean

## Other responses

- `201` — Pagamento efetivado
- `401` — Invalid client data
- `403` — Invalid token
- `422` — Invalid input fields

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)