# Belvo Payment Authorizations (Brazil) API

**Canonical:** https://apis.io/apis/belvo/belvo-payment-authorizations-brazil-api/  
**Provider:** Belvo — https://apis.io/providers/belvo/  
**Base URL:** https://api.belvo.com/api  
**Documentation:** https://developers.belvo.com/apis/belvoopenapispec/links

Belvo Payment Authorizations (Brazil) API is one of 37 APIs that [Belvo](https://apis.io/providers/belvo/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Payment Authorizations (Brazil). The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

A Payment Authorization is the consent that your user gives you to charge (debit money from) their accounts. You need to perform one Payment Authorization per ‘contract’ (for example, if your company does both electricity and water but they are billed separately, then you will create two separate Payment Authorizations). Once the user confirms the authorization, you will need to listen for a a `PAYMENT_AUTHORIZATION` webhook with the status set to `AUTHORIZED`. Once you receive this webhook, the authorization process is complete, and you will be able to charge your user. {% admonition type="info" name="What is a charge?" %} A **charge** represents the individual payment (debit) that your customer will make. {% /admonition %} {% admonition type="danger" name="Version Header" %} The Payment Authorization resource requires that you send through the `X-Belvo-API-Resource-Version` header set to `Payments-BR.V2`. {% /admonition %}

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| POST | `/payments/br/payment-authorizations/` | Create a new Payment Authorization |
| GET | `/payments/br/payment-authorizations/` | List all Payment Authorizations |
| GET | `/payments/br/payment-authorizations/{payment_authorization_id}/` | Get details about a Payment Authorization |
| POST | `/payments/br/payment-authorizations/{payment_authorization_id}/cancel/` | Cancel a Payment Authorization |
| GET | `/payments/br/payment-authorizations/{payment_authorization_id}/charges/` | List all Charges for a Payment Authorization |
| GET | `/payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/` | Get details about a Charge for a Payment Authorization |
| POST | `/payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/retry/` | Retry a failed Charge for a Payment Authorization |
| POST | `/payments/br/payment-authorizations/{payment_authorization_id}/charges/{charge_id}/cancel/` | Cancel a scheduled Charge |

## Machine-readable artifacts (18)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/belvo/refs/heads/main/openapi/belvo-payment-authorizations-brazil-api-openapi.yml
- **Documentation** — https://developers.belvo.com/docs/links
- **APIReference** — https://developers.belvo.com/apis/belvoopenapispec/links
- **PostmanCollection** — https://raw.githubusercontent.com/api-evangelist/belvo/refs/heads/main/collections/belvo.postman_collection.json
- **OpenCollection** — https://raw.githubusercontent.com/api-evangelist/belvo/refs/heads/main/collections/belvo.opencollection.json
- **Documentation** — https://developers.belvo.com/docs/accounts
- **APIReference** — https://developers.belvo.com/apis/belvoopenapispec/accounts
- **Documentation** — https://developers.belvo.com/docs/transactions
- **APIReference** — https://developers.belvo.com/apis/belvoopenapispec/transactions
- **Documentation** — https://developers.belvo.com/docs/owners
- **APIReference** — https://developers.belvo.com/apis/belvoopenapispec/owners
- **Documentation** — https://developers.belvo.com/docs/institutions
- **APIReference** — https://developers.belvo.com/apis/belvoopenapispec/institutions
- **Documentation** — https://developers.belvo.com/products/payments_brazil/payments-brazil-pix-via-open-finance-api-guide
- **APIReference** — https://developers.belvo.com/apis/belvoopenapispec/payment-intents-(brazil)
- **Documentation** — https://developers.belvo.com/docs/webhooks
- **APIReference** — https://developers.belvo.com/developer_resources/resources-webhooks-aggregation
- **Review** — https://raw.githubusercontent.com/api-evangelist/belvo/refs/heads/main/review.yml

## Other Belvo APIs (12)

- [Belvo Accounts API](https://apis.io/apis/belvo/belvo-accounts-api/)
- [Belvo Balances API](https://apis.io/apis/belvo/belvo-balances-api/)
- [Belvo Incomes API](https://apis.io/apis/belvo/belvo-incomes-api/)
- [Belvo Institutions API](https://apis.io/apis/belvo/belvo-institutions-api/)
- [Belvo Links API](https://apis.io/apis/belvo/belvo-links-api/)
- [Belvo Owners API](https://apis.io/apis/belvo/belvo-owners-api/)
- [Belvo Recurring Expenses API](https://apis.io/apis/belvo/belvo-recurring-expenses-api/)
- [Belvo Transactions API](https://apis.io/apis/belvo/belvo-transactions-api/)
- [Belvo Bank Accounts (Brazil) API](https://apis.io/apis/belvo/belvo-bank-accounts-brazil-api/)
- [Belvo Bills API](https://apis.io/apis/belvo/belvo-bills-api/)
- [Belvo Biometric payments Widget Access Token (Brazil) API](https://apis.io/apis/belvo/belvo-biometric-payments-widget-access-token-brazil-api/)
- [Belvo Charges (Brazil) API](https://apis.io/apis/belvo/belvo-charges-brazil-api/)

## Tags

Payment Authorizations (Brazil)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/belvo/belvo-payment-authorizations-brazil-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/belvo/.