Skip to main content
GET
/
transactions
Listar Transações
curl --request GET \
  --url https://api.example.com/transactions
{
  "200": {},
  "401": {},
  "500": {}
}

​
Visão Geral

Este endpoint permite listar todas as transações da sua conta, com opções de filtro por status e paginação para facilitar a navegação e geração de relatórios.

​
Endpoint

GET https://api.klivopay.com.br/api/public/v1/transactions

​
Parâmetros

​
api_token
string
required
Seu token de autenticação da API KlivoPay
​
page
integer
default:"1"
Número da página para paginação
​
per_page
integer
default:"20"
Quantidade de itens por página (máximo: 100)
​
status
string
Filtrar por status da transação:
  • pending - Aguardando pagamento
  • paid - Pago
  • canceled - Cancelado
  • refunded - Reembolsado

​
Exemplo de Requisição

curl -X GET 'https://api.klivopay.com.br/api/public/v1/transactions?api_token=seu_token_aqui&page=1&per_page=20&status=paid'

​
Resposta de Sucesso

200 OK
{
  "success": true,
  "data": [
    {
      "hash": "abc123def456",
      "status": "paid",
      "amount": 15000,
      "payment_method": "pix",
      "customer": {
        "name": "João Silva",
        "email": "joao@example.com"
      },
      "created_at": "2025-01-20T10:15:00Z",
      "paid_at": "2025-01-20T10:20:00Z"
    },
    {
      "hash": "def789ghi012",
      "status": "paid",
      "amount": 25000,
      "payment_method": "credit_card",
      "customer": {
        "name": "Maria Santos",
        "email": "maria@example.com"
      },
      "created_at": "2025-01-19T14:30:00Z",
      "paid_at": "2025-01-19T14:30:15Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 45,
    "total_pages": 3
  }
}

​
Códigos de Resposta

​
200
OK
Lista de transações retornada com sucesso
​
401
Unauthorized
Token de API inválido ou ausente
​
500
Internal Server Error
Erro interno do servidor
Use este endpoint para gerar relatórios, fazer conciliações financeiras e acompanhar o histórico de vendas.