API

Pagamentos de condomínio dentro do seu sistema.

Integre cobranças, Pix, boletos, unidades e conciliação ao ERP da sua administradora ou ao seu app com uma API REST simples e bem documentada.

Solicitar acesso ao sandbox Status da API

Criar cobrança

curl -X POST https://sandbox.api.condopay.com.br/v1/cobrancas \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: 6f1c2a0e-out26-a101" \
  -H "Content-Type: application/json" \
  -d '{
    "condominio_id": "cnd_8Hq2",
    "unidade": "A-101",
    "descricao": "Taxa condominial out/26",
    "valor": 78000,
    "vencimento": "2026-10-10",
    "metodos": ["pix", "boleto"],
    "encargos": { "multa_percentual": 2, "juros_mensal_percentual": 1 }
  }'

Feita para desenvolvedores

Padrões de mercado para você integrar rápido e com segurança.

REST + JSON

Recursos previsíveis, verbos HTTP padrão, datas em ISO 8601 e valores em centavos.

OAuth 2.0

Autenticação por client credentials, com tokens de curta duração e escopos por recurso.

Webhooks assinados

Eventos em tempo real com assinatura HMAC-SHA256 e reenvio automático em caso de falha.

Idempotência

Envie o cabeçalho Idempotency-Key e repita requisições com segurança, sem cobranças duplicadas.

Sandbox

Ambiente de testes completo, com simulação de pagamentos Pix, boleto e cartão.

Segurança

TLS 1.2+ obrigatório, allowlist de IPs opcional e registro de auditoria de cada chamada.

Endpoints

Principais recursos da versão 1. A referência completa é entregue com o acesso ao sandbox.

Método	Rota	Descrição
POST	/v1/cobrancas	Cria uma cobrança (Pix, boleto ou cartão) para uma unidade
GET	/v1/cobrancas	Lista cobranças com filtros por status, período e condomínio
GET	/v1/cobrancas/{id}	Consulta uma cobrança e seus pagamentos
POST	/v1/cobrancas/{id}/cancelar	Cancela uma cobrança em aberto
POST	/v1/pix/qrcodes	Gera QR Code Pix dinâmico avulso
POST	/v1/pix/automatico/convites	Envia convite de adesão ao Pix Automático
GET	/v1/condominios/{id}/unidades	Lista unidades e responsáveis financeiros
POST	/v1/condominios/{id}/unidades	Cadastra ou atualiza uma unidade
GET	/v1/conciliacao/extrato	Extrato conciliado por período, em JSON ou CNAB
POST	/v1/webhooks	Registra um endpoint para receber eventos

Resposta

Resposta da criação de cobrança: um único recurso com Pix e boleto prontos.

201 Created

{
  "id": "cob_4tZr91",
  "status": "pendente",
  "valor": 78000,
  "vencimento": "2026-10-10",
  "pix": { "txid": "cp4tZr91...", "copia_e_cola": "000201..." },
  "boleto": { "linha_digitavel": "23793.38128 ...", "pdf_url": "https://..." },
  "criado_em": "2026-09-29T10:42:00-03:00"
}

Webhooks

Valide a assinatura com seu segredo de webhook antes de processar o evento.

Evento recebido

POST /seu-endpoint
X-Condopay-Signature: t=1759153320,v1=5d41402abc4b2a76...

{
  "evento": "cobranca.paga",
  "data": {
    "id": "cob_4tZr91",
    "unidade": "A-101",
    "valor_pago": 78000,
    "metodo": "pix",
    "pago_em": "2026-10-09T21:04:11-03:00"
  }
}

Evento	Quando é enviado
cobranca.criada	Cobrança emitida e enviada ao morador
cobranca.paga	Pagamento confirmado e baixa realizada
cobranca.vencida	Vencimento sem pagamento
cobranca.cancelada	Cobrança cancelada
pix_automatico.autorizado	Morador aderiu ao Pix Automático
pix_automatico.cancelado	Morador revogou a autorização
conciliacao.divergencia	Pagamento com valor ou identificação divergente

Limites de uso

Até 600 requisições por minuto por credencial. Respostas 429 trazem o cabeçalho Retry-After.

Versionamento

Versão na URL (/v1). Mudanças incompatíveis só em nova versão, com aviso mínimo de 6 meses.

Suporte técnico

Dúvidas de integração: dev@condopay.com.br. Parceiros têm canal dedicado.

Vamos integrar?

Conte qual sistema você usa e liberamos o acesso ao sandbox com um especialista acompanhando.

Começar agora Falar no WhatsApp