BEbelvo
Payment Authorizations (Brazil)

List all Payment Authorizations

Changed on

List all Payment Authorizations associated with your Belvo account.

get/payments/br/payment-authorizations/

Request

Query parameters

pageinteger
Example:1

A page number within the paginated result set.

page_sizeinteger
Example:100

Indicates how many results to return per page. By default we return 100 results per page.

ℹ️ The minimum number of results returned per page is 1 and the maximum is 1000. If you enter a value greater than 1000, our API will default to the maximum value (1000).

id__instring[]

Return information for these resource ids.

[
  "6b3dea0f-be29-49d1-aabe-1a6d588642e6"
]
amountnumber float
Example:1000.02

Return results only for this value.

amount__gtnumber float
Example:1000.02

Return results only for more than this amount.

amount__gtenumber float
Example:1000.02

Return results only for and more than this amount.

amount__ltnumber float
Example:1000.02

Return results only for less than this amount.

amount__ltenumber float
Example:1000.02

Return results only for this amount or less.

amount__rangenumber[]

Return results between this amount range. The first value indicates the start of the range and the second value indicates the end of the range.

[
  100,
  5000
]
created_atstring date
Example:2022-05-05

Return items that were last updated in Belvo's database on this date (in YYYY-MM-DD format).

created_at__gtstring date
Example:2022-05-05

Return items that were last updated in Belvo's database after this date (in YYYY-MM-DD format).

created_at__gtestring date
Example:2022-05-04

Return items that were last updated in Belvo's database after or on this date (in YYYY-MM-DD format).

created_at__ltstring date
Example:2022-04-01

Return items that were last updated in Belvo's database before this date (in YYYY-MM-DD format).

created_at__ltestring date
Example:2022-03-30

Return items that were last updated in Belvo's database before or on this date (in YYYY-MM-DD format).

created_at__rangestring[]

Return accounts that were last updated in Belvo's database between two dates (in YYYY-MM-DD format). The first value indicates the start of the range and the second value indicates the end of the range.

[
  "2022-01-01",
  "2022-12-31"
]
customerstring uuid
Example:24e5b3a5-19aa-40fe-91e5-4db7f22ecc2d

The customer.id you want to get results for.

customer__instring[]

One or more customer.ids that you want to get results for.

[
  "cb320adc-9a6b-4224-933a-5b08cf771ac7"
]
external_idstring uuid
Example:295ebb46-65b8-47de-85cd-34ffbc327c09

Return objects with this external ID.

external_id__instring[]

Return objects with these external IDs.

[
  "446bdd9f-5b3e-4c05-9159-7a5c87cfc810"
]
searchstring
Example:trai

Return results that match the description you searched for.

Note:

This filter supports both full and partial search queries, with a minimum of three characters required.

For example, searching for trai may match the following values:

  • Awesome training sneakers
  • Training equipment

Searching for car may match the following values:

    - `Carlos Vives`
    - `Carmen Domínguez` 
    - `carlos.vives@musicabrazil.br`
updated_atstring date
Example:2022-05-05

Return items that were last updated in Belvo's database on this date (in YYYY-MM-DD format).

updated_at__gtstring date
Example:2022-05-05

Return items that were last updated in Belvo's database after this date (in YYYY-MM-DD format).

updated_at__gtestring date
Example:2022-05-04

Return items that were last updated in Belvo's database after or on this date (in YYYY-MM-DD format).

updated_at__ltstring date
Example:2022-04-01

Return items that were last updated in Belvo's database before this date (in YYYY-MM-DD format).

updated_at__ltestring date
Example:2022-03-30

Return items that were last updated in Belvo's database before or on this date (in YYYY-MM-DD format).

updated_at__rangestring[]

Return accounts that were last updated in Belvo's database between two dates (in YYYY-MM-DD format). The first value indicates the start of the range and the second value indicates the end of the range.

[
  "2022-01-01",
  "2022-12-31"
]

Headers

X-Belvo-API-Resource-Version'Payments-BR.V2'
Example:Payments-BR.V2

Header indicating which version of the Payment API you want to use. Currently this is only applicable for Bank Accounts, Customers, and Payment Authorizations in Brazil. In the case that you are using our Payment Authorizations product (including Smart Transfers authorizations and their Charges), then you must send through this header set to Payments-BR.V2.

Response

OK

countinteger

The total number of results in your Belvo account.

nextstring uri nullable

The URL to next page of results. Each page consists of up to 100 items. If there are not enough results for an additional page, the value is null.

In our documentation example, we use {endpoint} as a placeholder value. In production, this value will be replaced by the actual endpoint you are currently using (for example, accounts or owners).

previousstring uri nullable

The URL to the previous page of results. If there is no previous page, the value is null.

Example response

{
  "count": 130,
  "next": "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908&page=2",
  "results": [
    {
      "id": "9fc68b84-f2d6-4142-b2ad-9d2d1ad70432",
      "created_at": "2025-05-20T09:55:02Z",
      "updated_at": "2025-05-20T09:55:02Z",
      "status": "AWAITING_AUTHORIZATION",
      "status_updated_at": "2025-05-20T09:55:02Z",
      "authorized_at": "2025-05-20T09:55:02Z",
      "external_id": "c169a8a9-e9f5-48db-9f4a-818caef9356b",
      "description": "Internal description used by the merchant only",
      "return_url": "https://merchant.com/return",
      "expiration_date_time": "2027-10-31T23:59:59Z",
      "payment_method": "PIX_OF_IMMEDIATE",
      "payer": {
        "customer": "533e7a9b-e6c7-4bd4-be79-3a3c3bd78044",
        "institution": "770932b4-8f1f-4b0f-8470-1c605903fdb2",
        "representative_identifier": "12345678901122",
        "bank_account": {
          "holder": {
            "identifier": "***456789**"
          },
          "details": {
            "account_type": "CHECKINGS",
            "agency": "0001",
            "code": "12345678",
            "number": "***4567"
          }
        }
      },
      "beneficiary": {
        "type": "BANK_ACCOUNT",
        "target": "b6278377-f710-4d1a-a026-7bab757256d0"
      },
      "payment_method_configuration": {
        "amount": "10000.05",
        "statement_description": "Blue Suede Shoes - Premium",
        "authorization_url": "https://auth.belvo.com/authorize?token=abc123def456"
      },
      "charges": [
        "7d159b21-9f25-4365-9fa2-734d20797819"
      ],
      "metadata": {
        "internal_reference_id": "GGq73487w2"
      }
    }
  ]
}

Changes

  • acb784e42ca0Revision changes
    • breaking

      the response property //// became nullable for the status

    • warning

      added the new PIX_OF_SMART_TRANSFERS enum value to the /// response property for the response status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added to the /// response property anyOf list for the response status

    • info

      removed from the /// response property oneOf list for the response status

  • 32caefea14a8Revision changes
    • info

      added to the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status