Skip to main content
Cobranças são PIX In — requisições de pagamento que você cria para receber dinheiro. Ao criar uma cobrança, a plataforma gera um QR Code e um Copia e Cola que o pagador usa para concluir o pagamento.

O que você pode fazer

  • Criar cobranças com valor fixo e referência externa (external_ref) para rastreamento no seu sistema
  • Split de pagamento: distribuir automaticamente o valor recebido entre múltiplas contas (percentual ou fixo)
  • Beneficiário final (final_beneficiary): identificar quem é o recebedor final da cobrança para fins de compliance
  • Estornar uma cobrança liquidada quando necessário

Ciclo de vida

PENDING → PAID → REFUNDED
PENDING → PAID → PARTIALLY_REFUNDED → REFUNDED
PENDING → PROCESSING → PAID
PENDING → PROCESSING → FAILED
PENDING → CANCELLED
PENDING → EXPIRED    
Quando uma cobrança muda de status, um webhook PAYMENT é disparado automaticamente.

Referência da API

Criar Cobrança

POST /api/v1/payments

Listar Cobranças

GET /api/v1/payments

Detalhar Cobrança

GET /api/v1/payments/{uuid}

Estornar Cobrança

POST /api/v1/payments/{uuid}/refund

Receitas

Criar cobrança PIX

Gere uma cobrança e exiba o QR Code para o pagador

Processar confirmação via webhook

Configure o endpoint e reaja ao evento PAYMENT em tempo real

Cobrança com split

Distribua automaticamente o valor entre múltiplas contas