Informações gerais

Informações e caracteristas do pagamento por Pix e/ou Boleto.

Pix

O Pix é um meio de pagamento instantâneo criado pelo Banco Central do Brasil que permite realizar transferências e pagamentos em poucos segundos, 24 horas por dia, todos os dias da semana, incluindo finais de semana e feriados.

Com o Pix, através da API é possível realizar pagamentos utilizando:

  • QR Code.
  • Pix Copia e Cola.

O pagamento é processado em tempo real, permitindo confirmação imediata da transação tanto para o pagador quanto para o recebedor.

📘

Principais características do Pix

  • Disponibilidade 24/7;
  • Pagamento via QR Code;
  • Confirmação imediata;
  • Integração simples para cobranças e e-commerce.

Tipos de Pix

Meio de PagamentoParâmetroDescrição
Pix cobrança imediatapix-cobPix cobrança imediata. Permite configurar um tempo de expiração em segundos, permitindo assim um vencimento estendido desde minutos até horas.
Pix cobrança com vencimentopix-cobvPix cobrança com data de vencimento, juros, multas e descontos. Permite configurar uma data de expiração e vencimento.

QRCode e código Copia/Cola

Os QRCode e o código copia/cola são retornados via api através do campo transactions.extra e transactions.payment_number

🚧

O QRCode é codificado em base64

Em nossa API, retornamos o QRCode codificado em Base64, portanto é necessário que o converta para imagem caso o intuito seja exibi-lo para leitura em seu e-commerce.

Boleto

O boleto bancário é um meio de pagamento amplamente utilizado no Brasil para cobranças e pagamentos à vista.

Ele funciona como um documento de cobrança emitido por uma instituição financeira, contendo informações como valor, vencimento e código de barras.

📘

O pagamento do boleto pode ser realizado via:

  • Aplicativos bancários;
  • Internet banking;
  • Caixas eletrônicos;
  • Lotéricas;
  • Agências bancárias.

Informações adicionais

📘

Algumas observações importantes:

  • O pagamento via PIX costuma ser confirmado em poucos segundos após a conclusão da transação.
  • Atualmente, o pagamento de boletos também é imediato, porém há casos que depende da compensação bancária e pode levar até alguns dias úteis para confirmação.
  • Cobranças expiradas ou canceladas não poderão ser pagas.
  • Em cobranças PIX com prazo de expiração, o pagamento somente poderá ser realizado enquanto a cobrança estiver válida.

Boas práticas

👍

Segue algumas dicas de boas práticas:

  • Sempre armazenar o identificador da transação retornado pela API.
  • Utilizar webhooks para confirmação de pagamento.
  • Exibir claramente a data de vencimento do boleto.
  • Informar o prazo de expiração do PIX ao comprador.
  • Considerar o status da transação antes de liberar produtos ou serviços.
  • Considerar que boletos podem levar mais tempo para confirmação do pagamento.