A API Pix é o elemento do arranjo responsável por viabilizar que usuários pagadores ou recebedores automatizem a comunicação com seus respectivos Prestadores de Serviços de Pagamento (PSPs). Por meio dessa interface, é possível realizar ou receber transações Pix de maneira integrada, segura e sem necessidade de interações manuais.

O foco da API está na automação do fluxo do usuário recebedor, permitindo que ele:

Gere cobranças de forma programática;
Acompanhe e confirme, via integração, o pagamento dessas cobranças dentro do próprio arranjo Pix.

Abaixo, você confere os possíveis caminhos de integração dos sistemas do usuário recebedor com a API Pix do PSP, neste caso a Cielo.

Primeira etapa: Cobrança com geração do QR Code

Uma venda é iniciada no ponto de venda (PDV);
O software de automação comercial recebe essa informação e envia os dados para ERP, Sefaz (quando houver nota fiscal) e para a impressora fiscal quando necessário;
Em seguida, o software de automação solicita ao módulo TEF/Gateway que gere uma cobrança Pix;
O TEF ou Gateway se conecta à API Pix do PSP recebedor;
A API Pix gera um QR Code dinâmico contendo as informações necessárias;
O QR Code gerado é exibido no PDV para o cliente.

Segunda etapa: Pagamento pelo usuário pagador

O pagador lê o QR Code com o app do banco ou carteira digital;
O app envia a ordem de pagamento ao PSP pagador (banco do cliente);
O PSP pagador envia o pagamento ao PSP recebedor, usando a infraestrutura do Banco Central.

Terceira etapa: Confirmação do pagamento e retorno ao comércio

O PSP recebedor recebe o pagamento e atualiza o status da cobrança.
A API Pix comunica ao Gateway/TEF que a cobrança foi liquidada. Isso ocorre por consulta ativa ou por notificação (webhook), dependendo da integração.
O TEF/Gateway informa o SW de automação comercial que o pagamento foi confirmado.
O PDV então libera a venda, finaliza o pedido, registra no ERP, emite nota fiscal pela Sefaz e/ou dispara outros processos automáticos internos.