# Enumere todos los Cargos para una Autorización de Pago.

{% admonition type="warning" name="Próximamente" %}
  Este endpoint está actualmente en desarrollo. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Lista todos los Charges asociados con una Payment Authorization.

Endpoint: GET /payments/br/payment-authorizations/{payment_authorization_id}/charges/
Version: 1.223.0
Security: basicAuth

## Path parameters:

  - `payment_authorization_id` (string, required)
    El payment-authorization.id al que pertenecen los cargos.
    Example: "a3b92311-1888-449f-acaa-49ae28d68fcd"

## 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

  - `status` (string)
    Devuelve resultados solo para este valor.
    Example: "SUCCEEDED"

  - `status__in` (string)
    Devolver resultados para el estado listado.
    Example: "PENDING,SUCCEEDED"

## 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 charge.

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

  - `results.created_at` (string)
    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.status_updated_at` (string,null)
    La marca de tiempo ISO-8601 de cuando se actualizó por última vez el estado del Cargo.
    Example: "2025-06-09T08:45:50.406032Z"

  - `results.status` (string)
    El estado actual del Cargo. Puede ser uno de los siguientes valores:

  - PENDING
  - SCHEDULED
  - SETTLED
  - CANCELED
  - FAILED
    Enum: "PENDING", "SCHEDULED", "SETTLED", "CANCELED", "FAILED"

  - `results.status_reason_code` (string,null)
    El código de motivo para el estado actual del Cargo, si corresponde.

  - `results.status_reason_message` (string,null)
    Más información sobre el status_reason_code.

  - `results.amount` (string,null)
    El monto del Charge.
    Example: "100.12"

  - `results.date` (string,null)
    La fecha original del Cargo.
    Example: "2025-06-09"

  - `results.end_to_end_id` (string,null)
    El ID de extremo a extremo del Cargo. Este es un identificador único para la transacción que se puede utilizar para rastrearla a través de diferentes sistemas.
    Example: "1234567890abcdef"

  - `results.statement_description` (string)
    La descripción que aparecerá en el extracto bancario del cliente (si se proporciona).
    Example: "Super Shoe Store - Brown Sneakers"

  - `results.external_id` (string)
    Un identificador único adicional para el recurso con fines internos.

{% admonition type="success" name="Altamente Recomendado" %}
  Recomendamos usar este campo para almacenar su propio identificador único para cada recurso (cliente, cuenta bancaria, intención de pago o inscripción). Esto puede ser útil para rastrear el recurso en su sistema y para fines de depuración.
{% /admonition %}
    Example: "4b8a81a0-e33c-45a6-8567-479efb105f73"

  - `results.beneficiary` (object)
    Información sobre el beneficiario del Cargo.

  - `results.beneficiary.bank_account` (object)
    Información sobre la cuenta bancaria del beneficiario.

  - `results.beneficiary.bank_account.id` (string)
    ID único de Belvo utilizado para identificar la cuenta bancaria del beneficiario.
    Example: "088bc38f-1430-40c5-a5d2-80bd67189d11"

  - `results.beneficiary.bank_account.holder` (object)
    Información sobre el titular de la cuenta bancaria del beneficiario.

  - `results.beneficiary.bank_account.holder.name` (string)
    El nombre completo del titular de la cuenta bancaria del beneficiario.
    Example: "Jane Smith"

  - `results.beneficiary.bank_account.holder.identifier` (string)
    El identificador del titular de la cuenta bancaria del beneficiario. Puede ser un CPF (11 caracteres) o un CNPJ (14 caracteres).
    Example: "12345678901"

  - `results.beneficiary.bank_account.details` (object)
    Detalles de la cuenta bancaria del beneficiario.

  - `results.beneficiary.bank_account.details.institution` (string)
    El ID único de Belvo utilizado para identificar el banco del beneficiario.
    Example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"

  - `results.beneficiary.bank_account.details.agency` (string)
    El número de agencia de la cuenta bancaria del beneficiario.
    Example: "5678"

  - `results.beneficiary.bank_account.details.number` (string)
    El número de cuenta de la cuenta bancaria del beneficiario.
    Example: "987654321"

  - `results.beneficiary.bank_account.details.account_type` (string)
    El tipo de la cuenta bancaria del beneficiario. Puede ser CHECKINGS, SAVINGS o PAYMENTS.
    Example: "SAVINGS"

  - `results.beneficiary.bank_account.details.code` (string)
    El código ISPB del banco del beneficiario.
    Example: "678901"

  - `results.payer` (object)
    Información sobre el pagador del Cargo.

  - `results.payer.bank_account` (object)
    Información sobre la cuenta bancaria del pagador.

  - `results.payer.bank_account.holder` (object)
    Información sobre el titular de la cuenta bancaria del pagador.

  - `results.payer.bank_account.holder.identifier` (string)
    El identificador del titular de la cuenta bancaria del pagador. Puede ser un CPF (11 caracteres) o un CNPJ (14 caracteres).
    Example: "12345678902"

  - `results.payer.bank_account.details` (object)
    Detalles de la cuenta bancaria del pagador.

  - `results.payer.bank_account.details.institution` (string)
    ID único de Belvo utilizado para identificar el banco del pagador.

  - `results.payer.bank_account.details.code` (string)
    El código ISPB del banco del pagador.
    Example: "123345"

  - `results.payer.bank_account.details.account_type` (string)
    El tipo de la cuenta bancaria del pagador. Puede ser CHECKINGS, SAVINGS o PAYMENTS.
    Example: "CHECKINGS"

  - `results.payer.bank_account.details.agency` (string)
    El número de agencia de la cuenta bancaria del pagador.
    Example: "1234"

  - `results.payer.bank_account.details.number` (string)
    El número de cuenta de la cuenta bancaria del pagador.
    Example: "123456789"

  - `results.metadata` (object)
    Objeto opcional y personalizable donde puedes proporcionar cualquier par clave-valor adicional para tus propósitos internos. Por ejemplo, un número de referencia interno para la intención de pago.

{% admonition type="info" name="Limitaciones de Metadata" %}
  Solo puedes proporcionar hasta 50 claves (las claves pueden tener hasta 50 caracteres cada una y cada valor puede tener hasta 500 caracteres). No soportamos objetos anidados, solo valores ASCII.
{% /admonition %}
    Example: {"internal_reference_id":"GGq73487w2"}

  - `results.next` (string,null)
    El Belvo ID del siguiente Cargo en la secuencia (solo aplicable si el Cargo fue reintentado). Si es null, indica que no hay más Cargos en la secuencia.
    Example: "7d159b21-9f25-4365-9fa2-734d20797819"

  - `results.previous` (string,null)
    El ID de Belvo del Cargo anterior en la secuencia (solo aplicable si el Cargo fue reintentado). Si es null, indica que no hay Cargos anteriores en la secuencia.
    Example: "7d159b21-9f25-4365-9fa2-734d20797818"

## 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"