Skip to main content
O PIX é a forma mais rápida de receber: o cliente paga em segundos e você é avisado por webhook. Toda cobrança PIX nasce com status pending e passa a paid quando o pagamento é confirmado.

​
Dois tipos de cobrança

PIX imediato

QR Code dinâmico avulso, sem vencimento. Ideal para checkout: o cliente paga agora.

PIX com vencimento

Cobrança com data de vencimento, multa, juros e desconto. Ideal para faturas e boletos.
Os dois retornam o mesmo par de campos para o cliente pagar:
  • emv — o código “copia e cola” (BR Code).
  • qrCode — a imagem PNG do QR Code, em base64, pronta para exibir.

​
O que acontece depois de criar

1

Você cria a cobrança

A API responde com status: "pending" e o id da transação. Guarde esse id.
2

O cliente paga

Ele usa o emv ou lê o QR Code no app do banco.
3

Você recebe o webhook

Chega um transaction_paid com status: "paid". Esse é o gatilho para liberar o pedido — não confie apenas na resposta da criação.
Valores são sempre em centavos: amountInCents: 10000 equivale a R$ 100,00.
Um PIX criado e não pago dispara o evento sale_lost após cerca de 1 hora — útil para recuperação de carrinho.

Referência: rotas PIX

Corpo completo da requisição, campos de customer, regras de cob (vencimento) e respostas.