PIX e OpenFinance

PayBrokers oferece duas formas muito eficazes de executar pagamentos no Brasil, o PIX e a Iniciação de Pagamento via OpenFinance. Se você não está acostumado com esses métodos de pagamento, fornecemos um guia completo a seguir.

Como gateway de pagamento, o PayBrokers media as transações entre o usuário final e a entidade bancária que cria e processa as transações como, por exemplo, o Banco de Emissão e Banco de Pagamento.

Esses e outros atores do sistema financeiro brasileiro, como o Banco Central do Brasil, são deliberadamente excluídos da explicação abaixo, para simplificar o entendimento.

1. Pagamento com PIX

PIX é o método de pagamento mais popular no Brasil. Esta seção é uma visão geral do que um integrador deve esperar ao integrá-lo.
Se você estiver familiarizado com ele, considere pular esta seção, mas se não estiver, vamos começar com o fluxo de Depósitos (Cash In).

Depósitos PIX (Cash Ins)

1. O primeiro passo é uma solicitação de pagamento (saque ou saque) ao PayBrokers. Deve incluir informações do pagador e do destinatário, bem como informações básicas sobre valor.
   • Nesta solicitação o integrador também deverá fornecer uma URL de notificação do webhook, que será utilizada para informar cada mudança de status da transação.
2. PayBrokers cria uma transação e fornece códigos de pagamento para o usuário final em dois formatos: um QRCode e uma string chamada PIX Copia e Cola. Ambos podem ser usados pelo usuário final para executar o pagamento.
   • Se a transação não puder ser criada por algum motivo, o pagamento será rejeitado.
3. O integrador fornece a string QRCode e PIX Copia e Cola ao usuário final.
   • A partir deste momento, o integrador deverá apenas aguardar que o pagamento chegue ao estado final.
4. Em algum momento, o usuário prossegue com seu fluxo de pagamento, executando-o ou abandonando-o.

• De forma assíncrona, PayBrokers enviará notificações de webhook ao integrador, atualizando-o sobre qualquer alteração no status da transação, incluindo conclusão, erro, cancelamento etc.

Saques PIX (Cash Outs)

Para saques, o processo é mais simples. Basta informar a conta de destino usando uma Chave PIX como referência.

As Chaves PIX estão no núcleo do sistema de pagamento PIX e funcionam como ponteiros para uma conta bancária do mundo real. Os usuários finais criam chaves PIX usando qualquer um de seus aplicativos bancários e podem compartilhar essas chaves com qualquer pessoa. Portanto, qualquer pagamento feito com essa chave será endereçado à conta bancária de destino para a qual ela aponta.

As chaves PIX podem ter seu formato validado com base no seu tipo. Do seguinte modo:

• CNPJ – número de identificação único para empresas no Brasil, utilizado para fins fiscais e regulatórios.
  • Expressão regular: ^[0-9]{14}$
  • Exemplo: 46261360000148
• CPF - número de identificação único para pessoas físicas no Brasil, utilizado para diversos fins, incluindo transações financeiras e governamentais.
  • Expressão regular: ^[0-9]{11}$
  • Exemplo: 10777438666
  • Observação: PayBrokers valida o CPF e nega solicitações de CPFs falsos. Durante a integração, use um destes CPFs do mundo real para teste: 14435549603, 13600642650, 10777438666.
• PHONE: um número de telefone válido no Brasil.
  • Expressão regular: ^+[1-9][0-9]\d{1,14}$
  • Exemplo: +5583986182244
  • Observação: O número de telefone brasileiro deve começar com +55, conforme mostrado no exemplo acima.
• EMAIL - um e-mail válido.
  • Expressão regular: ^[a-z0-9.!#$&'*+/=?^_`{|}~-]+@[a-z0-9](?:[a-z0-9- ]{0,61}[a-z0-9])?(?:.a-z0-9 ?)*$
  • Exemplo: joã[email protected]
• EVP - um tipo de chave PIX gerada usando a biblioteca OpenSSL EVP (Encryption Variable Provider).
  • Expressão regular: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a- f]{12}
  • Exemplo: b5195ee1-f054-47d1-9e90-ee57b74f60d9

Na nossa seção de API, você conhecerá os endpoints de PIX Cash In e PIX Cash Out, onde você exercitará esses conceitos.

Iniciação de pagamento vai Open Finance

Do ponto de vista do usuário final, o pagamento PIX depende da familiaridade com os aplicativos do banco e sua típica área PIX.

Apresentamos aqui o processo de iniciação de pagamento do Open Finance, método que auxilia o usuário a não perder o contexto na hora de efetuar o pagamento, fazendo redirecionamentos automáticos entre o site do estabelecimento comercial e as telas de pagamento.

Para familiarizá-lo com este meio de pagamento, apresentamos a seguir uma breve explicação dos passos envolvidos na sua integração e utilização:

1. O primeiro passo é solicitar uma URL de pagamento ao PayBrokers, que será fornecida ao usuário pagador.
   Nesta solicitação, o integrador deverá fornecer à PayBrokers a URL de callback, para a qual o usuário será redirecionado após finalizar ou cancelar o pagamento.
   • Os integradores também devem fornecer uma URL de notificação de webhook, que será chamada para informar alterações no status da transação.
2. PayBrokers retorna a URL de pagamento ao integrador.
3. O integrador decide como exibir o URL fornecido ao usuário final (por exemplo: um modal na página atual do merchant). A partir deste ponto, o integrador deverá apenas aguardar a ação do usuário final.
4. Em caso de conclusão ou falha no pagamento, a interação é finalizada e o usuário final é redirecionado pela PayBrokers para a URL de callback fornecida pelo integrador.

• De forma assíncrona, PayBrokers enviará notificações de webhook ao integrador, atualizando-o sobre qualquer alteração no status da transação, incluindo erro, cancelamento etc.

⏱️

Tempo de processamento

O tempo médio que o sistema financeiro leva para processar saques OpenFinance ou PIX é de cerca de 3 segundos, enquanto os saques normalmente levam de 10 a 20 segundos.

Ambiente de teste OpenFinance

PayBrokers fornece uma interface gráfica de usuário para simular o pagamento do usuário final do OpenFinance. Apresentamos abaixo alguns detalhes do pagamento:

• Quando o integrador receber a URL de Pagamento e redirecionar o usuário, será exibida uma tela de carregamento para iniciar a interação bancária por parte do usuário.

• Em nosso ambiente, permitimos simular a ação do pagador (usuário), confirmando o pagamento ou forçando o seu erro, conforme imagem abaixo.

• Durante o fluxo de simulação, o integrador deverá receber alterações no status da transação via webhook, e o pagador será redirecionado para a URL de callback fornecida na solicitação de origem.

Tanto para o PIX quanto para o Open Finance, qualquer transação criada e seu status ficam visíveis no Portal Administrativo, na página Vendas (Cash In) e na _ Menus _Retiradas** (Saque).

📘

Quer entender mais?

• Para o PIX, leia o Perguntas Frequentes do PIX - BACEN (10 mins read).
• Para OpenFinance, leia a Visão Geral do Open Finance - BACEN (7 mins read)