Skip to main content
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:

Get Started

Concepts, tutorials, and integration guides. You are here.

API Reference

Every endpoint, schema, and error contract.

Start here

1

Generate your keys

Create an ECDSA secp256k1 keypair and register the public half with BlooBank.

Generate your keys
2

Sign your first request

Learn how the Access Protocol signs every request — canonical string, SHA-256, ECDSA, four headers.

Sign a request
3

Make your first call

Run the end-to-end quickstart — five minutes from key generation to first authenticated response.

Quickstart

Core concepts

Authentication

Access Protocol v1 — ECDSA-signed requests over secp256k1.

Wallets

Tenant-scoped balance containers — the isolation boundary for payments.

Payments

Inbound (cash-in) and outbound (cash-out) PIX flows.

Webhooks

Receive real-time events for payment lifecycle and reconciliation.

Errors

Canonical error envelope, branching logic, retry strategy.

Glossary

Every term used across the platform, defined once.