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ÊNCIA | RESPONSÁVEL | DESCRIÇÃO | STATUS DA TRANSAÇÃO |
---|---|---|---|
1 | Loja | Geração do QR code. | 12 - Pendente |
2 | Comprador | Pagamento do QR code. | 2 - Pago |
3 | Loja | Recebimento da notificação de confirmação do pagamento. | 2 - Pago |
4 | Loja | Consulta ao status da transação. | 2 - Pago |
5 | Loja | Liberação do pedido. | 2 - Pago |
6 | Loja | Caso necessário, solicitação da devolução da transação Pix (semelhante ao estorno do cartão). | 2 - Pago |
7 | Loja | Recebimento da notificação de confirmação de devolução. | 11 - Estornado |
8 | Loja | Consulta 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:
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:
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.
Updated about 23 hours ago