QivoPay

Listar Transações

Consulte e filtre todas as transações da sua conta. Nossa API permite buscar transações por diversos critérios como status, período, método de pagamento e valor.

Endpoint

GET/api/v1/transactions

Parâmetros de Consulta

limitnumberopcional

Número máximo de resultados por página (1-100, padrão: 20)

statusstringopcional

Filtrar por status: "pending", "approved", "rejected", "cancelled"

created_afterdatetimeopcional

Transações criadas após esta data (formato ISO 8601)

created_beforedatetimeopcional

Transações criadas antes desta data (formato ISO 8601)

Exemplo de Requisição

cURL
curl -X GET "https://api.qivopay.com/v1/transactions?limit=10&status=approved" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Resposta de Sucesso

200 OK
{
  "data": [
    {
      "id": "txn_abc123",
      "status": "approved",
      "amount": 10050,
      "currency": "BRL",
      "payment_method": "credit_card",
      "customer": {
        "id": "cust_xyz789",
        "name": "João Silva",
        "email": "joao@exemplo.com"
      },
      "created_at": "2023-12-01T10:30:00Z",
      "updated_at": "2023-12-01T10:35:00Z"
    },
    {
      "id": "txn_def456",
      "status": "pending",
      "amount": 5000,
      "currency": "BRL",
      "payment_method": "pix",
      "customer": {
        "id": "cust_abc123",
        "name": "Maria Santos",
        "email": "maria@exemplo.com"
      },
      "created_at": "2023-12-01T09:15:00Z",
      "updated_at": "2023-12-01T09:15:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 20,
    "total": 150,
    "total_pages": 8,
    "has_next": true,
    "has_previous": false
  }
}

Paginação

Use os parâmetros limit eoffset para navegar entre páginas:

/api/v1/transactions?limit=20&offset=40

Campos da Resposta

idIdentificador único da transação
statusStatus atual da transação
amountValor em centavos
payment_methodMétodo de pagamento utilizado
Anterior: Criar TransaçãoPróximo: Atualizar Transação