Fala ai Radizeiro e Radizeira, tudo bem com vocês?
Atualmente encontramos em diversos estabelecimentos os pagamentos via QRCode.
Isso mesmo, a compra online e até mesmo fisicamente, tem usado muito no uso de pagamento com QRCode.
Nós que somos também consumidores, como a maioria de nossos usuários, sabe que as compras feitas podem ser recuperadas parte do dinheiro gasto.
E isso graças aos cashback.
E com o crescimento desta modalidade muitos sistemas têm adotado em seus sistemas de frente de caixa, dentre outros.
E hoje, você que possui um sistema e não possui o pagamento via QRCode implementado nos seus softwares, tem perdido não só clientes, mas a possibilidade de inovações.
E pensando nisso damos início hoje a uma série de post aqui no blog que iremos aprender a utilizar o PicPay dentro dos nossos softwares.
Nesse primeiro momento iremos preparar o ambiente, pois sem ele todo preparado como você irá poder já tê-lo em seu software.
Para darmos início, vamos criar um projeto simples, em FMX mesmo.
Primeiro é necessário realizar o seu cadastro dentro o picpay para obter os acessos a api.
Irei deixar aqui o link da documentação da api do picpay.
https://ecommerce.picpay.com/doc/
Dentro desse documento você consegue entender e utilizar.
Uma documentação bem intuitiva.
Nessa imagem, há uma amostra da requisição que a api do picpay solicita.
Os fluxos do picpay são muito fáceis.
Nós fizemos uma requisição de pagamento igual a imagem acima.
Nós passamos um id único.
{
"referenceId": "102030",
…
}
Uma url de callback, ou seja, é onde o picpay vai retornar para você o status da transação.
{
…
"callbackUrl": "http://www.sualoja.com.br/callback"
…
}
Em returnURL, é para onde o picpay irá redirecionar o usuário, depois que ele fizer o pagamento.
{
…
"returnUrl": "http://www.sualoja.com.br/cliente/pedido/102030",
…
}
O valor da compra, a data de expiração, onde podemos informar quanto tempo vale essa transação.
{
…
"value": 20.51,
"expireAt": "2022-05-01T16:00:00-03:00",
…
}
E os dados de usuário dentro de buyer.
{
…
"buyer": {
"firstName": "João",
"lastName": "Da Silva",
"document": "123.456.789-10",
"email": "teste@picpay.com",
"phone": "+55 27 12345-6789"
}
…
}
Esse último você é obrigado mandar para a api.
Mas você não precisa mandar os dados do usuário que irá realizar o pagamento.
Qualquer usuário pode fazer o pagamento.
Podendo passar os dados do estabelecimento que está utilizando o seu software.
O que acontece ao passar os dados do usuário nessa requisição, é que ele já irá receber um push notification, sem a necessidade de escancear o QRCode.
É somente isso que precisamos para realizar a requisição.
E se você estiver verificando a documentação, você consegue ver que temos a requisição de cancelamento.
Na imagem acima você consegue observar que é necessário passar o id por referencia na url de cancelamento para cancelar essa transação.
Na imagem acima podemos ver as requisições para que possamos ver o status da transação, onde passamos somente o referenciID para a autorização.
E temos a notificação.
Quando o picpay recebe o pagamento, ele notifica a url de callback que é passado, enviando os parâmetros, referenceID e autorizacaoID.
O fluxo é mais ou menos assim.
Você faz uma solicitação de pagamento, e você terá o retorno.
Ao fazer a requisição de pagamento temos essa imagem de retorno.
Onde temo a referenceID, uma URL de pagamento, a data de expiração e o QRCode, tanto o link quanto a base64 do QRCode.
Aí você pode pegar e transformar esse base64 e exibir o QRCode para o seu usuário.
Nesta url de callback que o picpay disponibiliza, você irá precisar montar um servidor de aplicação que fique escutando, onde quando a transação for paga, retornar a notificação de pagamento.
Que seria a url de callback de Notification Request da documentação do picpay.
Ao fazer esse processo, fazendo a requisição gera o QRCode, e o cliente realiza o pagamento, com o retorno da notificação de uma ação, basta consultar o status dessa notificação e verificar se foi realizado o pagamento ou não.
Para que possa realizar todas as transações dentro do picpay, é necessário que com sua conta já criada entrar no portal do lojista e gerar seu token, como a imagem abaixo.
Para que possamos descompactar as informações de QRCode retornados pelo picpay, iremos utilizar uma alternativa feita em php.
Isso mesmo, o picpay retorna as informações compactadas, e para resolver isso eu utilizado um arquivo escrito em php que fica hospedado em um servidor de para que possa pegar as requisições e descompactar e assim poder repassar essa informações para o Delphi.
Com minha comunicação pronta, já é possível realizar as requisições.
Os arquivos podem ser encontrados no meu [https://github.com/bittencourtthulio].
Dentro do repositório BlogFontes.
Com essas alterações já podemos ir para o Delphi e começarmos a integrar com o PicPay.
E caso você tenha interesse de conhecer mais sobre PicPay com Delphi acessa o nosso portal do CLUBE DE PROGRAMADORES EM DELPHI, onde você não terá só conteúdos relacionados ao PicPay, mas uma quantidade enorme de conteúdos que poderá lhe ajudar muito no seu dia a dia, é uma verdadeira NETFLIX para os programadores Delphi.
CLIQUE AQUI E SAIBA MAIS SOBRE O CLUBE DOS PROGRAMADORES DELPHI
