Visão geral
Entenda como funcionam o Pix imediato, o Pix com vencimento e o Boleto.
Pix
Com o Pix, o comprador pode pagar por QR Code ou pelo código Copia e Cola, diretamente no aplicativo do banco.
O pagamento costuma ser confirmado em poucos segundos, e o serviço funciona 24 horas por dia, inclusive aos fins de semana e feriados.
Existem duas modalidades de cobrança:
- Pix imediato (Cob): usado principalmente em checkouts e compras que precisam ser pagas em um prazo curto. A cobrança pode ter um tempo de expiração.
- Pix com vencimento (CobV): permite definir uma data de vencimento e, quando houver suporte, configurar condições como juros, multa e descontos.
QR Code e Copia e Cola
No pagamento por Pix, o comprador pode receber um QR Code para escanear ou um código Copia e Cola para inserir no aplicativo do banco.
A resposta da API pode trazer os dados necessários para apresentar essas opções no checkout. Cabe à aplicação tratar o formato recebido e exibir as informações de pagamento.
Também é importante mostrar até quando a cobrança pode ser paga, especialmente nos casos com expiração ou vencimento.
Boleto
O boleto é uma alternativa para quem prefere pagar pelos canais bancários tradicionais. A cobrança tem valor, data de vencimento e linha digitável ou código de barras para pagamento.
Diferentemente do Pix, a confirmação do boleto pode levar mais tempo, dependendo do processamento bancário.
Mesmo depois de emitir o boleto, o pedido deve continuar aguardando a confirmação do pagamento.
Qual meio ou modalidade utilizar?
| Modalidade | Quando utilizar | O que observar |
|---|---|---|
| Pix Imediato (Cob) | Compras em checkout, com pagamento esperado em minutos ou horas. | Configurar a expiração e acompanhar a confirmação. |
| Pix com Vencimento (CobV) | Cobranças com data definida para pagamento. | Exibir claramente vencimento e regras da cobrança. |
| Boleto | Cobranças com vencimento e público que prefere canais bancários tradicionais. | Não liberar produto/serviço apenas porque o boleto foi emitido. |
Boas práticas ao integrar Pix ou Boleto
- Guarde os identificadores da Venda e da Transação. Eles serão necessários para acompanhar o pagamento e consultar sua situação.
- Informe ao comprador o prazo de expiração do Pix ou a data de vencimento da cobrança.
- Não considere o pedido pago apenas porque a API retornou sucesso ao criar a cobrança.
- Configure o webhook para receber as atualizações de pagamento. Se necessário, consulte a API para conferir o estado atual.
- Defina como o pedido será tratado quando a cobrança vencer ou expirar sem confirmação de pagamento.
- Antes de liberar o produto, acesso ou serviço, confirme que o pagamento foi aprovado.
Da cobrança à confirmação
O fluxo abaixo mostra o que acontece desde a criação da cobrança até a atualização do pedido no e-commerce.
- Cobrança criada: o e-commerce solicita a cobrança à Cyclopay.
- Dados para pagamento: o comprador recebe o QR Code do Pix ou os dados do boleto.
- Pagamento realizado pelo cliente: o comprador efetua o pagamento pelo banco ou aplicativo.
- Processamento bancário: a instituição financeira processa o pagamento.
- Atualização na Cyclopay: a transação recebe a atualização correspondente ao resultado do processamento.
- Webhook ou consulta: o e-commerce recebe a atualização ou consulta o estado do pagamento pela API ou BackOffice.
- Atualização do pedido: com o pagamento confirmado, o e-commerce pode atualizar o pedido e seguir com a liberação.
Os meios de pagamento Pix e Boleto são meios em que a confirmação pode acontecer depois da criação da cobrança. Diferentemente de uma resposta síncrona de cartão, criar a cobrança não significa que o cliente já pagou. O e-commerce precisa acompanhar a evolução da Venda e da Transação.
Updated 21 days ago