Pix

O Pix é o sistema de pagamentos instantâneos do Banco Central que revolucionou o mercado brasileiro. Este guia orienta a integração do Pix em sua aplicação, permitindo que seu negócio receba pagamentos 24/7 com liquidação imediata. A Pinbank oferece soluções completas para geração de QR Codes (Estáticos e Dinâmicos), gestão de recebimentos e um fluxo padronizado de devoluções (estornos), garantindo agilidade e segurança tanto para o lojista quanto para o cliente final.

Fluxo

O ciclo de vida de uma transação Pix no Gateway da Pinbank segue estas etapas fundamentais:

Geração da cobrança: Sua aplicação solicita a criação de uma cobrança Pix, definindo se será um QR Code reutilizável (Estático) ou exclusivo para uma venda (Dinâmico).

Pagamento pelo cliente: O pagador utiliza o aplicativo de sua instituição financeira para escanear o QR Code ou utilizar o código "Copia e Cola".

Processamento instantâneo: A rede do Banco Central liquida a transação em poucos segundos.

Notificação e automação: Assim que o pagamento é confirmado, a Pinbank dispara um Webhook para o seu sistema. Esta notificação é o gatilho para a liberação imediata do produto ou serviço.

Vantagens e diferenciais

Disponibilidade total: Recebimentos em tempo real, inclusive em fins de semana e feriados.

Liquidez imediata: O recurso fica disponível na conta logo após a confirmação do pagamento.

Conciliação automatizada: Com o uso de QR Codes Dinâmicos, cada venda possui um ID exclusivo, facilitando a baixa automática no seu sistema.

Segurança no reembolso: Fluxo de devolução integrado que respeita as normas do Banco Central (Mecanismo Especial de Devolução).

Jornada de integração

Abaixo, detalhamos as APIs utilizadas para orquestrar os cenários de recebimento e estorno via Pix:

1. Cenários de recebimento (Cash-in)

Gerar QR Code estático para venda única: Cria um código fixo para múltiplas transações. Ideal para doações ou PDVs onde o cliente digita o valor.

Gerar QR Code dinâmico para venda única: Gera um código único com valor e vencimento específicos. Recomendado para E-commerce e automação de conciliação.

Invalidar QR Code dinâmico de cobrança Pix pendente: Cancela uma cobrança Pix pendente, impedindo que o cliente realize o pagamento após o vencimento ou cancelamento do pedido.

Consultar status e dados de um QR Code dinâmico: Verifica em tempo real a situação de uma cobrança específica.

2. Cenários de devolução (Estorno)

Solicitar estorno parcial ou integral de um Pix: Inicia o processo de retorno do valor ao pagador. Exige o ID da transação original e permite estornos totais ou de apenas uma fração do valor.

Verificar status do estorno de um Pix (Assíncrono): Verifica o status da solicitação de estorno utilizando o endToEndId. Essencial para garantir que o reembolso foi processado com sucesso pelo Banco Central.

3. Notificação ativa

Webhook de recebimento Pix: Endpoint configurado para receber notificações automáticas de confirmação de pagamento.

Fluxo#

Vantagens e diferenciais#

Jornada de integração#

1. Cenários de recebimento (Cash-in)#