Arquitetura

Na implementação da API, a Cielo é responsável por gerar o QR Code para pagamentos via Pix, garantindo conformidade com os requisitos de segurança do Banco Central. Durante a transação, são identificadas informações importantes, como:

Data e hora da operação;
Nome do pagador;
Nome do recebedor;
Valor da transação.

Funcionalidades

A API Pix disponibiliza um conjunto de recursos projetados para otimizar a jornada de pagamento, ampliar a automação operacional e proporcionar maior controle sobre as transações financeiras. Entre os principais destaques estão:

Cobrança

Geração de QR Code imediato para pagamento instantâneo, válido para uma única utilização;
Personalização do tempo de expiração do QR Code;
Alteração ou remoção de um QR Code imediato previamente gerado;
Geração de cobranças, por meio do Pix Automático.

Conciliação

Geração de relatórios e consulta de transações, utilizando TXID ou ID E2E como parâmetros;
Consulta de informações de um QR Code imediato específico;
Lista de todos os QR Codes imediatos disponíveis.

📘
O tempo de expiração do QR Code é totalmente parametrizável, podendo ser definido conforme a necessidade do negócio. Caso nenhum valor seja enviado, aplica‑se o prazo padrão de 42.300 segundos (12 horas). Em operações de frente de caixa, é comum que esse tempo seja reduzido para cerca de 5 minutos.

Devolução

Devolução de transações Pix, sempre de forma individual, identificando a transação original a ser devolvida de forma total ou parcial.

Pix automático

Criação de pedidos de autorização de recorrência, nos quais o usuário pagador concede permissão para que cobranças automáticas sejam debitadas de sua conta transacional em intervalos pré-estabelecidos;
Consulta, atualização ou cancelamento de recorrências ativas, garantindo total controle sobre o ciclo de cobrança.