Getting Started with Bradesco API Integration

Bradesco, one of Brazil's largest private banks, offers a robust suite of APIs through its developer portal. Whether you're building a fintech application, automating payments, or integrating banking services into your platform, understanding the fundamentals of Bradesco's API ecosystem is the essential first step.

Table of Contents

Accessing the Developer Portal

Bradesco's developer resources are accessible through the Bradesco Developers portal. To get started, you'll need to create an account and register your application. The portal provides documentation, API references, sandbox credentials, and support channels for developers.

Before registering, make sure you have the following ready:

  • A valid CNPJ (for companies) or CPF (for individuals)
  • A business or personal Bradesco account
  • A clear description of your intended application and use case
  • A registered callback/redirect URI for OAuth flows

Obtaining Your Credentials

After registering your application, Bradesco will issue you a Client ID and Client Secret. These are the foundation of your API authentication. Keep your Client Secret secure — never expose it in frontend code or public repositories.

Bradesco APIs use OAuth 2.0 as the primary authentication standard, with some endpoints also requiring mTLS (Mutual TLS) for an additional layer of security. You'll need to generate a certificate and have it signed through the registration process for production use.

Working in the Sandbox Environment

Always start development in the sandbox environment. The sandbox mimics production behavior without processing real transactions, allowing you to:

  1. Test authentication flows end-to-end
  2. Simulate payment transactions (PIX, boleto, TED)
  3. Verify error handling and edge cases
  4. Iterate on your integration without financial risk

Sandbox credentials are separate from production credentials. Never mix sandbox and production keys in the same codebase without proper environment management.

Making Your First API Request

Once you have sandbox credentials, your first task is obtaining an access token. Here's the general flow:

  1. Send a POST request to Bradesco's OAuth token endpoint with your client_id, client_secret, and desired scope.
  2. Receive a Bearer token in the response (with an expiry time, typically 3600 seconds).
  3. Include this token in the Authorization header of subsequent API calls.

Common scopes you'll encounter include openid, payments, accounts, and boletos, depending on which Bradesco products you are integrating.

Next Steps

With your sandbox credentials working and your first token obtained, you're ready to explore specific API products. Consider these logical next steps:

  • PIX Integration — ideal for instant payment use cases
  • Boleto Cobrança — for billing and invoice generation
  • Account Data — via Open Banking consent flows
  • Webhooks — to receive real-time payment notifications

Understanding the authentication model thoroughly before diving into specific product APIs will save you significant debugging time down the line.