Coufai API documentation

Coufai is a Brazilian PIX payments gateway. This documentation describes the public REST API for merchant and partner integration.

What you can do

Generate dynamic PIX charges (POST /v1/pix).
Initiate PIX withdrawals to external keys (POST /v1/withdraw).
Query available balance (GET /v1/balance).
List and query transactions (GET /v1/transactions, GET /v1/transactions/:id).
Receive signed webhooks when a charge or withdrawal status changes.

Prerequisites

Coufai account with approved KYC and verified email.
API key generated in the dashboard.
Public HTTPS endpoint if you want to receive webhooks (optional but recommended).

Base URL

https://api.coufai.com.br/v1

Coufai runs in a single production environment. Every call moves real money — to validate your integration, use small amounts close to the allowed minimum (R$ 1.00).

Next steps

Quickstart — your first charge in minutes.
Authentication — API key format and management.
Webhook — how to receive payment notifications.

Amounts in cents

All monetary fields (amountCents, feeCents, netCents) use cents as integers. R$ 10.00 = 1000.

Quickstart