# Listar todas as transações de pagamento

Liste todas as transações de pagamento associadas à sua conta Belvo.

Endpoint: GET /payments/br/transactions/
Version: 1.223.0
Security: basicAuth

## Query parameters:

  - `page` (integer)
    Um número de página dentro do conjunto de resultados paginados.
    Example: 1

  - `page_size` (integer)
    Indica quantos resultados retornar por página. Por padrão, retornamos 100 resultados por página.

ℹ️ O número mínimo de resultados retornados por página é 1 e o máximo é 1000. Se você inserir um valor maior que 1000, nossa API usará o valor máximo por padrão (1000).
    Example: 100

  - `id__in` (array)
    Retorne informações para esses ids de recurso.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

  - `created_at` (string)
    Retorne itens que foram atualizados pela última vez no banco de dados da Belvo nesta data (no formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Retorne itens que foram atualizados pela última vez no banco de dados da Belvo após esta data (no formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Retorne itens que foram atualizados pela última vez no banco de dados da Belvo após ou nesta data (no formato YYYY-MM-DD).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Retorne itens que foram atualizados pela última vez no banco de dados da Belvo antes desta data (no formato YYYY-MM-DD).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Retorne itens que foram atualizados pela última vez no banco de dados da Belvo antes ou na data especificada (no formato YYYY-MM-DD).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Retorne contas que foram atualizadas pela última vez no banco de dados do Belvo entre duas datas (no formato YYYY-MM-DD). O primeiro valor indica o início do intervalo e o segundo valor indica o final do intervalo.
    Example: ["2022-01-01","2022-12-31"]

  - `charge` (string)
    O charge.id para o qual você deseja obter resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `charge__in` (array)
    Um ou mais charge.ids para os quais você deseja obter resultados.
    Example: ["2f122ae2-fc09-4c6d-9940-b6220e8d191d"]

  - `beneficiary` (string)
    O beneficiary.id para o qual você deseja obter resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `beneficiary__in` (array)
    Um ou mais beneficiary.ids para os quais você deseja obter resultados.
    Example: ["ee43f030-4feb-4a06-95e7-d8d8afe5b16e"]

  - `payer` (string)
    O bank-account.id do pagador para o qual você deseja obter resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `payer__in` (array)
    Um ou mais bank-account.ids do pagador para os quais você deseja obter resultados.
    Example: ["901bc024-be57-4972-b4cf-31664b369d6e"]

  - `customer` (string)
    O customer.id para o qual você deseja obter resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `customer__in` (array)
    Um ou mais customer.ids para os quais você deseja obter resultados.
    Example: ["cb320adc-9a6b-4224-933a-5b08cf771ac7"]

  - `payment_intent` (string)
    O payment-intent.id para o qual você deseja obter resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `payment_intent__in` (array)
    Um ou mais payment-intent.ids para os quais você deseja obter resultados.
    Example: ["cb320adc-9a6b-4224-933a-5b08cf771ac7"]

  - `transaction__type` (string)
    Retorne os resultados para este tipo de transação. Pode ser INFLOW ou OUTFLOW.
    Enum: "INFLOW", "OUTFLOW"

  - `currency` (string)
    Retorne resultados que contenham finanças ou saldos apenas neste código de moeda de três letras.
    Example: "BRA"

  - `description` (string)
    Retornar resultados para itens com esta descrição.
    Example: "Training shoes"

  - `amount` (number)
    Retorne resultados apenas para este valor.
    Example: 1000.02

  - `amount__gt` (number)
    Retorne resultados apenas para valores acima deste montante.
    Example: 1000.02

  - `amount__gte` (number)
    Retorne resultados apenas para e acima deste valor.
    Example: 1000.02

  - `amount__lt` (number)
    Retorne resultados apenas para menos do que este valor.
    Example: 1000.02

  - `amount__lte` (number)
    Retorne resultados apenas para este valor ou menos.
    Example: 1000.02

  - `amount__range` (array)
    Retorne resultados dentro deste intervalo de valores. O primeiro valor indica o início do intervalo e o segundo valor indica o final do intervalo.
    Example: [100,5000]

## Response 200 fields (application/json):

  - `count` (integer)
    O número total de resultados na sua conta Belvo.
    Example: 130

  - `next` (string,null)
    A URL para a próxima página de resultados. Cada página consiste em até 100 itens. Se não houver resultados suficientes para uma página adicional, o valor será null.

Em nosso exemplo de documentação, usamos {endpoint} como um valor de espaço reservado. Em produção, esse valor será substituído pelo endpoint real que você está usando atualmente (por exemplo, accounts ou owners).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908&page=2"

  - `previous` (string,null)
    A URL para a página anterior de resultados. Se não houver uma página anterior, o valor será null.

  - `results` (array)
    Array de objetos de transação.

  - `results.id` (string, required)
    Identificador único da Belvo para o item atual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.created_at` (string, required)
    O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.created_by` (string, required)
    O ID único para o usuário que criou este item.
    Example: "bcef7f35-67f2-4b19-b009-cb38795faf09"

  - `results.amount` (string, required)
    O valor da transação.

Nota: O valor exibido é sempre positivo, pois indicamos a direção da transação no parâmetro transaction_type.
    Example: "1020.00"

  - `results.currency` (string, required)
    A moeda do valor pago, por exemplo, BRL (Real Brasileiro).
    Enum: "BRL"

  - `results.description` (string, required)
    A descrição do pagamento.
    Example: "Training shoes"

  - `results.transaction_type` (string, required)
    A direção da transação.

  - INFLOW indica dinheiro entrando na conta.
  - OUTFLOW indica dinheiro saindo da conta.
    Enum: "INFLOW", "OUTFLOW"

  - `results.beneficiary` (string, required)
    ID único da Belvo usado para identificar a conta bancária do beneficiário.
    Example: "a80d5a9d-20ae-479a-8dd7-ff3443bcbbfc"

  - `results.payer` (any, required)
    Nota: Para OFPI, isso retornará um objeto vazio {}.

  - `results.payment_intent` (string)
    O ID único da intenção de pagamento associado à transação.
    Example: "004a28bb-fac2-4172-884b-5b6ea15314ad"

  - `results.customer` (string)
    ID único da Belvo para o cliente associado a esta transação.
    Example: "9eebd63b-3339-44a9-8a5a-72bb6cb2f310"

## Response 403 fields (application/json):

  - `code` (string)
    Um código de erro único (access_to_resource_denied) que permite classificar e tratar o erro programaticamente.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Uma breve descrição do erro.

Para erros access_to_resource_denied, a descrição é:

  - You don't have access to this resource..
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Um código de erro único (not_found) que permite classificar e lidar com o erro programaticamente.
    Example: "not_found"

  - `message` (string)
    Uma breve descrição do erro.

Para erros not_found, a descrição é:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Um código de erro único (request_timeout) que permite classificar e lidar com o erro programaticamente.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Uma breve descrição do erro.

Para erros de request_timeout, a descrição é:

  - The request timed out, you can retry asking for less data by changing your query parameters.
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Um código de erro único (unexpected_error) que permite classificar e tratar o erro de forma programática.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Uma breve descrição do erro.

Para erros unexpected_error, a descrição é:

  - Belvo não consegue processar a solicitação devido a um problema interno do sistema ou a uma resposta não suportada de uma instituição.
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"