# Payment Authorizations (Brazil)

Una Autorización de Pago es el consentimiento que tu usuario te da para cargar (debitando dinero de) sus cuentas. Necesitas realizar una Autorización de Pago por cada ‘contrato’ (por ejemplo, si tu empresa maneja tanto electricidad como agua pero se facturan por separado, entonces deberás crear dos Autorizaciones de Pago separadas).

Una vez que el usuario confirma la autorización, necesitarás escuchar un webhook `PAYMENT_AUTHORIZATION` con el estado configurado en `AUTHORIZED`. Una vez que recibas este webhook, el proceso de autorización estará completo y podrás cargar a tu usuario.

{% admonition type="info" name="¿Qué es un cargo?" %}
Un **cargo** representa el pago individual (débito) que tu cliente realizará.
{% /admonition %}

{% admonition type="danger" name="Encabezado de Versión" %}
  El recurso de Autorización de Pago requiere que envíes el encabezado `X-Belvo-API-Resource-Version` configurado en `Payments-BR.V2`.
{% /admonition %}

## Crear una nueva Autorización de Pago

 - [POST /payments/br/payment-authorizations/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/createpaymentauthorizationbrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Crear una Autorización de Pago.

## Enumere todas las Autorizaciones de Pago

 - [GET /payments/br/payment-authorizations/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/listpaymentauthorizationsbrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Lista todas las Autorizaciones de Pago asociadas con tu cuenta de Belvo.

## Obtener detalles sobre una Autorización de Pago

 - [GET /payments/br/payment-authorizations/{payment_authorization_id}/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/detailpaymentauthorizationbrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Obtén los detalles sobre una Autorización de Pago específica.

## Cancelar una Autorización de Pago

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/cancel/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/cancelpaymentauthorizationbrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Cancelar una Autorización de Pago

Respondemos con un  y te informaremos a través de un webhook que la Autorización de Pago fue cancelada exitosamente.

{% admonition type="warning" name="Restricciones de Tiempo para Cancelación" %}
El último momento en que puedes cancelar una Autorización de Pago es hasta las 22:00:00 (GMT-3) del día anterior a la fecha del próximo Cargo. Si no cumples con el tiempo límite, la Autorización de Pago será cancelada, .
{% /admonition %}

## Crear un nuevo Charge

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/charges/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/createpaymentauthorizationchargebrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Crea un nuevo Charge para una Payment Authorization.

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

 - [GET /payments/br/payment-authorizations/{payment_authorization_id}/charges/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/listpaymentauthorizationchargesbrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. 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.

## Obtener detalles sobre un Cargo para una Autorización de Pago

 - [GET /payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/detailpaymentauthorizationchargebrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Obtén los detalles sobre un Cargo específico asociado con una Autorización de Pago.

## Reintentar un Cargo fallido para una Autorización de Pago

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/retry/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/retrypaymentauthorizationchargebrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. 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 %}

## Cancelar un Cargo programado

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/cancel/](https://developers.belvo.com/es/apis/belvoopenapispec/payment-authorizations-(brazil)/cancelpaymentauthorizationchargebrazil.md): {% admonition type="warning" name="En BETA" %}
  Este endpoint está en BETA. Como tal, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}

Cancela un Cargo programado.

Respondemos con un  y te informaremos a través de un webhook que el cargo fue cancelado exitosamente.

{% admonition type="warning" name="Restricción de Tiempo para Cancelación" %}
  La última hora para cancelar un Cargo programado es a las 22:00:00 (GMT-3) del día anterior a la fecha del Cargo. Si no cumples con el tiempo límite, recibirás un error de API de Belvo y el pago se procesará.
{% /admonition %}