# Payment Authorizations (Brazil)

Uma Autorização de Pagamento é o consentimento que seu usuário dá para que você debite dinheiro de suas contas. Você precisa realizar uma Autorização de Pagamento por ‘contrato’ (por exemplo, se sua empresa fornece tanto eletricidade quanto água, mas elas são cobradas separadamente, então você criará duas Autorizações de Pagamento separadas).

Assim que o usuário confirmar a autorização, você precisará escutar um webhook `PAYMENT_AUTHORIZATION` com o status definido como `AUTHORIZED`. Assim que você receber esse webhook, o processo de autorização estará completo, e você poderá cobrar seu usuário.

{% admonition type="info" name="O que é uma cobrança?" %}
Uma **cobrança** representa o pagamento individual (débito) que seu cliente fará.
{% /admonition %}

{% admonition type="danger" name="Cabeçalho de Versão" %}
  O recurso de Autorização de Pagamento requer que você envie o cabeçalho `X-Belvo-API-Resource-Version` configurado para `Payments-BR.V2`.
{% /admonition %}

## Criar uma nova Autorização de Pagamento

 - [POST /payments/br/payment-authorizations/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/createpaymentauthorizationbrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Crie uma Autorização de Pagamento.

## Listar todas as Autorizações de Pagamento

 - [GET /payments/br/payment-authorizations/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/listpaymentauthorizationsbrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante Belvo.
{% /admonition %}

Liste todas as Autorizações de Pagamento associadas à sua conta Belvo.

## Obter detalhes sobre uma Autorização de Pagamento

 - [GET /payments/br/payment-authorizations/{payment_authorization_id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/detailpaymentauthorizationbrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante Belvo.
{% /admonition %}

Obtenha os detalhes sobre uma Autorização de Pagamento específica.

## Cancelar uma Autorização de Pagamento

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/cancel/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/cancelpaymentauthorizationbrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Cancelar uma Autorização de Pagamento

Respondemos com um  e informaremos você via webhook que a Autorização de Pagamento foi cancelada com sucesso.

{% admonition type="warning" name="Restrições de Horário para Cancelamento" %}
O horário limite para cancelar uma Autorização de Pagamento é até as 22:00:00 (GMT-3) do dia anterior à próxima data de Cobrança. Se você perder o prazo, a Autorização de Pagamento será cancelada, .
{% /admonition %}

## Criar uma nova Charge

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/charges/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/createpaymentauthorizationchargebrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante Belvo.
{% /admonition %}

Crie uma nova Cobrança para uma Autorização de Pagamento.

## Listar todas as Cobranças para uma Autorização de Pagamento

 - [GET /payments/br/payment-authorizations/{payment_authorization_id}/charges/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/listpaymentauthorizationchargesbrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Liste todas as Cobranças associadas a uma Autorização de Pagamento.

## Obter detalhes sobre uma Cobrança para uma Autorização de Pagamento

 - [GET /payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/detailpaymentauthorizationchargebrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Obtenha os detalhes sobre uma Charge específica associada a uma Payment Authorization.

## Tentar novamente uma Cobrança falhada para uma Autorização de Pagamento

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/retry/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/retrypaymentauthorizationchargebrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante da Belvo.
{% /admonition %}

Tente novamente uma Cobrança falhada para uma determinada Autorização de Pagamento.

{% admonition type="warning" name="Documentação adicional" %}
  Certifique-se de ler a documentação dedicada a Retentativas de Cobranças e Cobranças Vinculadas antes de tentar repetir uma cobrança.
{% /admonition %}

## Cancelar uma Cobrança agendada

 - [POST /payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/cancel/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/payment-authorizations-(brazil)/cancelpaymentauthorizationchargebrazil.md): {% admonition type="warning" name="Em BETA" %}
  Este endpoint está em BETA. Portanto, pequenas alterações ou bugs podem ocorrer. Se você encontrar algum problema, entre em contato com seu representante Belvo.
{% /admonition %}

Cancele uma Cobrança agendada.

Respondemos com um  e informaremos você via webhook que a cobrança foi cancelada com sucesso.

{% admonition type="warning" name="Restrição de Tempo para Cancelamento" %}
  O horário limite para cancelar uma Cobrança agendada é até as 22:00:00 (GMT-3) do dia anterior à data da Cobrança. Se você perder o prazo, receberá um erro da API da Belvo e o pagamento será processado.
{% /admonition %}