> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bloobank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

> Integrate the BlooBank Transactions Engine API — wallets, payment orders, and webhooks.

The **BlooBank Transactions Engine API** connects your systems to the BlooBank platform: provision wallets, route inbound and outbound PIX payments, and receive real-time webhook events.

This documentation has two surfaces:

<CardGroup cols={2}>
  <Card title="Get Started" icon="book-open">
    Concepts, tutorials, and integration guides. **You are here.**
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Every endpoint, schema, and error contract.
  </Card>
</CardGroup>

## Start here

<Steps>
  <Step title="Generate your keys">
    Create an ECDSA `secp256k1` keypair and register the public half with BlooBank.

    <Card href="/get-started/authentication/generate-keys" icon="key" horizontal>
      Generate your keys
    </Card>
  </Step>

  <Step title="Sign your first request">
    Learn how the Access Protocol signs every request — canonical string, SHA-256, ECDSA, four headers.

    <Card href="/get-started/authentication/sign-request" icon="signature" horizontal>
      Sign a request
    </Card>
  </Step>

  <Step title="Make your first call">
    Run the end-to-end quickstart — five minutes from key generation to first authenticated response.

    <Card href="/get-started/quickstart" icon="rocket" horizontal>
      Quickstart
    </Card>
  </Step>
</Steps>

## Core concepts

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/get-started/authentication/overview">
    Access Protocol v1 — ECDSA-signed requests over `secp256k1`.
  </Card>

  <Card title="Wallets" icon="wallet" href="/get-started/wallets/overview">
    Tenant-scoped balance containers — the isolation boundary for payments.
  </Card>

  <Card title="Payments" icon="money-bill-transfer" href="/get-started/payments/overview">
    Inbound (cash-in) and outbound (cash-out) PIX flows.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/get-started/webhooks/overview">
    Receive real-time events for payment lifecycle and reconciliation.
  </Card>

  <Card title="Errors" icon="bug" href="/get-started/errors/overview">
    Canonical error envelope, branching logic, retry strategy.
  </Card>

  <Card title="Glossary" icon="book" href="/get-started/concepts/glossary">
    Every term used across the platform, defined once.
  </Card>
</CardGroup>