Pix

ℹ️

Vá para a Referência da API para acessar os exemplos completos de requisição e resposta.

No Pix, a transmissão da ordem de pagamento e a disponibilidade de fundos para o usuário recebedor ocorrem em tempo real, 24 horas por dia e sem a necessidade de intermediários. Sendo assim, é um meio que viabiliza pagamentos rápidos e com menores custos de transação.

⚠️

Atenção

No momento, a habilitação do Pix está disponível para as adquirentes Cielo 3.0 e Bradesco. É necessário entrar em contato primeiramente com esses fornecedores para a liberação do meio de pagamento.

Conheça o ciclo de vida de uma transação Pix:

SEQUÊNCIARESPONSÁVELDESCRIÇÃOSTATUS DA TRANSAÇÃO
1LojaGeração do QR code.12 - Pendente
2CompradorPagamento do QR code.2 - Pago
3LojaRecebimento da notificação de confirmação do pagamento.2 - Pago
4LojaConsulta ao status da transação.2 - Pago
5LojaLiberação do pedido.2 - Pago
6LojaCaso necessário, solicitação da devolução da transação Pix (semelhante ao estorno do cartão).2 - Pago
7LojaRecebimento da notificação de confirmação de devolução.11 - Estornado
8LojaConsulta ao status da transação.11 - Estornado

Criando uma transação com QR Code Pix

Para gerar um QR code Pix através da API Gateway de pagamentos, basta realizar a integração conforme a especificação abaixo.

Entre os campos de envio obrigatório, destacam-se dois: Type, que deve ser enviado como "Pix"; e Provider, que deve ser "Cielo30" ou "Bradesco2". Na resposta da requisição será retornado o código base64 da imagem do QR code Pix, que deve ser disponibilizado ao comprador.

Veja abaixo a representação do fluxo transacional na geração do QR code Pix:

Fluxo Geração QR Code Pix

O comprador então realiza a leitura do QR code através de um dos aplicativos habilitados para o pagamento Pix e efetiva o pagamento. Nesta etapa não há participação da loja nem da Braspag, como demonstrado abaixo:

Fluxo Pagamento QR Code Pix

Solicitando uma devolução Pix

Caso o lojista precise cancelar uma transferência Pix, é possível realizar uma operação chamada de devolução. É importante ressaltar que a devolução não é uma operação instantânea, podendo ser acatada ou não pelo provedor Pix. Quando uma devolução é acatada, uma notificação é recebida pela loja.

Fluxo devolução Pix