Introdução

Bem-vindo à API Ciabra Invoice

Em poucos passos sua aplicação está integrada para emitir cobranças via Pix e Boleto e receber notificações de pagamento em tempo real.

Fluxo de integração

Siga estes seis passos para colocar sua aplicação em produção.

1

Cadastre-se na plataforma Ciabra e envie a documentação de compliance (CNPJ, representante legal e outros documentos exigidos). A validação leva de 1 a 3 dias úteis e libera o acesso à integração.

Primeiros passos →

2

Com a conta validada, acesse o painel da Ciabra e gere suas chaves pública e privada. Elas serão usadas para autenticar todas as requisições da sua aplicação.

Chaves de acesso →

3

Combine suas chaves em Base64 e envie no header Authorization: Basic {token} em todas as chamadas à API.

Autenticação →

4

Cadastre seus clientes para vincular às cobranças. Os dados ficam centralizados e prontos para reutilização nas próximas emissões.

Cadastrar cliente →

5

Envie uma requisição com cliente, valor, vencimento e tipo de pagamento (Pix, Boleto ou ambos). A API retorna a URL de pagamento pronta para o seu cliente.

Cadastrar cobrança →

6

Configure URLs de webhook para receber eventos em tempo real: cobrança criada, pagamento confirmado e estorno realizado.

Webhooks →
Primeiros passosPular para Chaves de acesso