# Reintentar un Cargo fallido 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 %}

Reintentar un Cargo fallido para una Autorización de Pago dada.

{% admonition type="warning" name="Documentación adicional" %}
  Por favor, asegúrate de leer la documentación dedicada a Reintentar Cargos y Cargos Vinculados antes de intentar reintentar un cargo.
{% /admonition %}

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

## Header parameters:

  - `X-Belvo-API-Resource-Version` (string)
    Encabezado que indica qué versión de la API de Pagos deseas utilizar. Actualmente, esto solo es aplicable para Cuentas Bancarias, Clientes y Autorizaciones de Pago en Brasil. En el caso de que estés utilizando nuestro producto de Autorizaciones de Pago, entonces debes enviar este encabezado configurado en Payments-BR.V2.

{% admonition type="warning" name="Próximamente" %}
  Esta versión está en Próximamente. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}
    Enum: "Payments-BR.V2"

## Path parameters:

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

  - `charge_id` (string, required)
    El charge.id sobre el cual deseas obtener detalles.
    Example: "a3b92311-1888-449f-acaa-49ae28d68fcd"

## Request fields (application/json):

  - `date` (string)
    La fecha en la que deseas reintentar el Cargo, en formato YYYY-MM-DD. Debe ser al menos un día en el futuro.
    Example: "2025-06-30"

## Response 201 fields (application/json):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `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"}

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

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