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:

Criando uma transação com QR Code Pix

Para gerar um QR code Pix através da API Gateway de Pagamento, 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:

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 e nem da API, como demonstrado abaixo:

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.