API Introduction

Overview

The Fire Banking Public API is a comprehensive platform for integrating with PIX payment services and account management. Our API allows you to:

Generate dynamic PIX charges for receiving payments
Send PIX payments to any key
Send PIX payments via QR Code
Query balances in real time
Manage transaction refunds
Integrate instant payments into your application

Environment

Production

https://api.public.firebanking.com.br

Authentication

All API endpoints (except the token generation endpoint) require Bearer token authentication. The authentication process follows the OAuth 2.0 standard with X.509 certificates:

Request your clientId and clientSecret through the Avista portal

Install the client certificate provided in your environment

Use the /api/auth/token endpoint with your credentials and certificate to generate a Bearer token

Include the token in the Authorization: Bearer {token} header in all requests

The generated token is valid for 30 minutes and must be renewed after that period.

HTTP Status Codes

The API uses standard HTTP status codes to indicate the success or failure of a request:

Code	Meaning	Description
`200`	OK	Successful request (GET)
`201`	Created	Resource created successfully (POST)
`400`	Bad Request	Invalid data in the request
`401`	Unauthorized	Token missing, invalid, or expired
`404`	Not Found	Resource not found
`500`	Internal Server Error	Internal server error