# Enumere todas las transacciones de pago.

Enumere todas las transacciones de pago asociadas con su cuenta de Belvo.

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

## Query parameters:

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

  - `page_size` (integer)
    Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página.

ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000).
    Example: 100

  - `id__in` (array)
    Devuelve información para estos ids de recursos.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

  - `created_at` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después de esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después o en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes de esta fecha (en formato YYYY-MM-DD).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes o en esta fecha (en formato YYYY-MM-DD).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Devolver cuentas que fueron actualizadas por última vez en la base de datos de Belvo entre dos fechas (en formato YYYY-MM-DD). El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: ["2022-01-01","2022-12-31"]

  - `charge` (string)
    El charge.id para el que deseas obtener resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `charge__in` (array)
    Uno o más charge.ids para los que deseas obtener resultados.
    Example: ["2f122ae2-fc09-4c6d-9940-b6220e8d191d"]

  - `beneficiary` (string)
    El beneficiary.id para el que deseas obtener resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `beneficiary__in` (array)
    Uno o más beneficiary.ids para los que deseas obtener resultados.
    Example: ["ee43f030-4feb-4a06-95e7-d8d8afe5b16e"]

  - `payer` (string)
    El bank-account.id del pagador para el que deseas obtener resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `payer__in` (array)
    Uno o más bank-account.id del pagador para los que deseas obtener resultados.
    Example: ["901bc024-be57-4972-b4cf-31664b369d6e"]

  - `customer` (string)
    El customer.id para el que deseas obtener resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `customer__in` (array)
    Uno o más customer.ids para los que deseas obtener resultados.
    Example: ["cb320adc-9a6b-4224-933a-5b08cf771ac7"]

  - `payment_intent` (string)
    El payment-intent.id para el que deseas obtener resultados.
    Example: "24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d"

  - `payment_intent__in` (array)
    Uno o más payment-intent.ids para los que deseas obtener resultados.
    Example: ["cb320adc-9a6b-4224-933a-5b08cf771ac7"]

  - `transaction__type` (string)
    Devuelve resultados para este tipo de transacción. Puede ser INFLOW o OUTFLOW.
    Enum: "INFLOW", "OUTFLOW"

  - `currency` (string)
    Devuelve resultados que contengan finanzas o saldos solo en este código de moneda de tres letras.
    Example: "BRA"

  - `description` (string)
    Devolver resultados para artículos con esta descripción.
    Example: "Training shoes"

  - `amount` (number)
    Devuelve resultados solo para este valor.
    Example: 1000.02

  - `amount__gt` (number)
    Devolver resultados solo para más de esta cantidad.
    Example: 1000.02

  - `amount__gte` (number)
    Devuelve resultados solo para y más de esta cantidad.
    Example: 1000.02

  - `amount__lt` (number)
    Devolver resultados solo por menos de esta cantidad.
    Example: 1000.02

  - `amount__lte` (number)
    Devuelve resultados solo para esta cantidad o menos.
    Example: 1000.02

  - `amount__range` (array)
    Devuelve resultados entre este rango de cantidades. El primer valor indica el inicio del rango y el segundo valor indica el final del rango.
    Example: [100,5000]

## Response 200 fields (application/json):

  - `count` (integer)
    El número total de resultados en tu cuenta de Belvo.
    Example: 130

  - `next` (string,null)
    La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es null.

En nuestro ejemplo de documentación, usamos {endpoint} como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo, accounts o owners).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908&page=2"

  - `previous` (string,null)
    La URL a la página anterior de resultados. Si no hay una página anterior, el valor es null.

  - `results` (array)
    Matriz de objetos de transacción.

  - `results.id` (string, required)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.created_at` (string, required)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.created_by` (string, required)
    El ID único para el usuario que creó este elemento.
    Example: "bcef7f35-67f2-4b19-b009-cb38795faf09"

  - `results.amount` (string, required)
    El monto de la transacción.

Nota: El monto mostrado siempre es positivo ya que indicamos la dirección de la transacción en el parámetro transaction_type.
    Example: "1020.00"

  - `results.currency` (string, required)
    La moneda del monto pagado, por ejemplo, BRL (Real Brasileño).
    Enum: "BRL"

  - `results.description` (string, required)
    La descripción del pago.
    Example: "Training shoes"

  - `results.transaction_type` (string, required)
    La dirección de la transacción.

  - INFLOW indica dinero que entra en la cuenta.
  - OUTFLOW indica dinero que sale de la cuenta.
    Enum: "INFLOW", "OUTFLOW"

  - `results.beneficiary` (string, required)
    El ID único de Belvo utilizado para identificar la cuenta bancaria del beneficiario.
    Example: "a80d5a9d-20ae-479a-8dd7-ff3443bcbbfc"

  - `results.payer` (any, required)
    Nota: Para OFPI, esto devolverá un objeto vacío {}.

  - `results.payment_intent` (string)
    El ID único del payment intent asociado con la transacción.
    Example: "004a28bb-fac2-4172-884b-5b6ea15314ad"

  - `results.customer` (string)
    El ID único de Belvo para el cliente asociado con esta transacción.
    Example: "9eebd63b-3339-44a9-8a5a-72bb6cb2f310"

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único (access_to_resource_denied) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores access_to_resource_denied, la descripción es:

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

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Un código de error único (not_found) que te permite clasificar y manejar el error de manera programática.
    Example: "not_found"

  - `message` (string)
    Una breve descripción del error.

Para errores not_found, la descripción es:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único (request_timeout) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de request_timeout, la descripción es:

  - 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)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único (unexpected_error) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores unexpected_error, la descripción es:

- Belvo no puede procesar la solicitud debido a un problema interno del sistema o a una respuesta no soportada de una institución.
    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)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"


