# BlooBank > BlooBank Transactions Engine API — wallets, payment orders (PIX), and webhooks. ## Docs - [Errors](https://developers.bloobank.com/api-reference/conventions/errors.md): Canonical error envelope, status codes, reason codes, and how to branch on them. - [Filtering (SFS-1)](https://developers.bloobank.com/api-reference/conventions/filtering.md): Full normative reference for the SFS-1 filter syntax used by every list endpoint. - [HTTP](https://developers.bloobank.com/api-reference/conventions/http.md): Methods, content types, status codes, and TLS requirements shared by every BlooBank endpoint. - [Pagination](https://developers.bloobank.com/api-reference/conventions/pagination.md): Cursor-based pagination via page_size, page_token, and nextPageToken — the reference contract for every list endpoint. - [API Reference](https://developers.bloobank.com/api-reference/introduction.md): BlooBank Transactions Engine API — try it live, copy code, inspect schemas. - [Approve payment order](https://developers.bloobank.com/api-reference/payment-orders/approve.md) - [Cancel payment order](https://developers.bloobank.com/api-reference/payment-orders/cancel.md) - [Create payment order](https://developers.bloobank.com/api-reference/payment-orders/create.md) - [Get payment order](https://developers.bloobank.com/api-reference/payment-orders/get.md) - [List payment orders](https://developers.bloobank.com/api-reference/payment-orders/list.md) - [Payment Orders](https://developers.bloobank.com/api-reference/payment-orders/overview.md): The PaymentOrder resource — inbound and outbound payments routed through provider networks. - [Create wallet](https://developers.bloobank.com/api-reference/wallets/create.md) - [Get wallet](https://developers.bloobank.com/api-reference/wallets/get.md) - [Get wallet balance](https://developers.bloobank.com/api-reference/wallets/get-balance.md) - [List wallets](https://developers.bloobank.com/api-reference/wallets/list.md) - [Wallets](https://developers.bloobank.com/api-reference/wallets/overview.md): The Wallet resource — tenant-scoped balance containers. - [Update wallet](https://developers.bloobank.com/api-reference/wallets/update.md) - [Code examples](https://developers.bloobank.com/get-started/authentication/code-examples.md): Working ECDSA signer clients in Node.js, Python, Go, Java, PHP, and .NET — copy, set credentials, run. - [Generate your keys](https://developers.bloobank.com/get-started/authentication/generate-keys.md): Create an ECDSA secp256k1 keypair on your infrastructure and register the public half with BlooBank. - [Authentication](https://developers.bloobank.com/get-started/authentication/overview.md): Access Protocol v1 — ECDSA-signed requests over secp256k1. - [Sign a request](https://developers.bloobank.com/get-started/authentication/sign-request.md): Build the canonical request string, sign it with ECDSA secp256k1, attach the four headers, and send. - [Troubleshooting](https://developers.bloobank.com/get-started/authentication/troubleshooting.md): Diagnose SIGNATURE_INVALID, TIMESTAMP_SKEW_EXCEEDED, REPLAY_DETECTED, and other authentication failures. - [Amounts & currency](https://developers.bloobank.com/get-started/concepts/amounts-and-currency.md): Minor-unit integers, the Amount and Asset shapes, and supported currency codes. - [Architecture](https://developers.bloobank.com/get-started/concepts/architecture.md): High-level view of the BlooBank platform and how the Transactions Engine API fits in. - [Date & time](https://developers.bloobank.com/get-started/concepts/date-and-time.md): UTC ISO 8601 timestamps, the ±10-second request-signing tolerance, and clock synchronization. - [Filtering (SFS-1)](https://developers.bloobank.com/get-started/concepts/filtering.md): Filter list results with SFS-1 expressions — the mental model and common patterns. - [Glossary](https://developers.bloobank.com/get-started/concepts/glossary.md): Every term used across the BlooBank API, defined once. - [Idempotency](https://developers.bloobank.com/get-started/concepts/idempotency.md): How to make every retryable request safe to retry — the idempotencyKey pattern. - [Ordering results](https://developers.bloobank.com/get-started/concepts/ordering.md): Sort list results deterministically with the order_by parameter. - [Pagination](https://developers.bloobank.com/get-started/concepts/pagination.md): Cursor-based pagination via opaque page tokens — when to paginate and how to think about it. - [Rate limiting](https://developers.bloobank.com/get-started/concepts/rate-limiting.md): Quotas, response headers, and the recommended backoff strategy when limits are exceeded. - [Resources & naming](https://developers.bloobank.com/get-started/concepts/resources-and-naming.md): How resources are identified — id, selfName, etag, kind, and version fields. - [Error catalog](https://developers.bloobank.com/get-started/errors/error-catalog.md): Every reason code returned by the BlooBank API, grouped by category, with HTTP status and remediation. - [Handling errors](https://developers.bloobank.com/get-started/errors/handling.md): Branching patterns and retry rules — how to handle BlooBank errors safely in code. - [Errors overview](https://developers.bloobank.com/get-started/errors/overview.md): How the BlooBank API signals failures — canonical envelope, branching rules, and what to log. - [Retry strategy](https://developers.bloobank.com/get-started/errors/retry-strategy.md): Exponential backoff with jitter — when to retry, how to back off, when to give up. - [Welcome](https://developers.bloobank.com/get-started/overview.md): Integrate the BlooBank Transactions Engine API — wallets, payment orders, and webhooks. - [Instrument types](https://developers.bloobank.com/get-started/payments/instrument-types.md): The five PIX instrument variants — static QR, dynamic QR, key, EMV, and account — and when to use each. - [Payment lifecycle](https://developers.bloobank.com/get-started/payments/lifecycle.md): The payment-order state machine — from AWAITING_APPROVAL to SUCCESS, FAILED, CANCELED, EXPIRED, or REFUNDED. - [Payments overview](https://developers.bloobank.com/get-started/payments/overview.md): Inbound (cash-in) and outbound (cash-out) payment-order flows on the BlooBank platform. - [Pix cash-in](https://developers.bloobank.com/get-started/payments/pix-cash-in.md): Build a complete inbound PIX flow — create a dynamic QR, render it to the customer, reconcile via webhook. - [Pix cash-out](https://developers.bloobank.com/get-started/payments/pix-cash-out.md): Build a complete outbound PIX flow — create, approve (or cancel), submit, reconcile via webhook. - [Security](https://developers.bloobank.com/get-started/security.md): How BlooBank secures the API — signed requests, environment isolation, and your security obligations. - [Wallet lifecycle](https://developers.bloobank.com/get-started/wallets/lifecycle.md): The wallet state machine — ACTIVE, DISABLED, and the transitions between them. - [Wallet overview](https://developers.bloobank.com/get-started/wallets/overview.md): Tenant-scoped balance containers — the isolation boundary for payments and ledger. ## OpenAPI Specs - [openapi-v1](https://developers.bloobank.com/openapi-v1.yml)