Integração com Pinbank

Introdução

O Pinbank é um banco digital que oferece soluções financeiras para indivíduos e para empresas. Com serviços que vão desde contas digitais até maquininhas de pagamento, o Pinbank facilita a gestão financeira e a realização de transações de maneira simplificada. Através da sua API de pagamentos, o Pinbank permite a integração com sistemas PDV, possibilitando o recebimento de pagamentos via QR Code PIX diretamente na conta digital Pinbank dos lojistas.

Limitações da Integração

Para utilizar a integração com o Pinbank, é necessário possuir um servidor Uniplus Web Cloud. Esta é uma limitação importante, pois a API do Pinbank funciona através de WebHook com uso de certificado digital. Atualmente, o suporte para essa integração não está disponível em servidores Yoda/PDV, que não possuem o recurso necessário para gerenciar os certificados digitais.

Licenciamento

Para habilitar a integração, é necessário instalar a licença chamada “Integração Carteira Digital Pinbank.” Esta licença deve ser adquirida e instalada antes da configuração da integração.

Configurações

Para configurar a integração, acesse a tela “Parâmetros da Integração do Pinbank” disponível no Uniplus Web através do menu PDV → Parâmetros da Integração do Pinbank:

O usuário deverá preencher este formulário com as credenciais de acesso à API do Pinbank. Geralmente, a equipe do Pinbank envia para o cliente um documento PDF contendo todas essas informações:

• Usuário: usuário com permissão para acessar a API. Não é o número da conta bancária. Pode ser encontrado com o nome “UserName” no PDF fornecido pelo Pinbank;
• Senha: senha para acessar a API. Não é a senha da conta bancária. Pode ser encontrada com o nome “KeyValue” no PDF fornecido pelo Pinbank;
• Código do Canal PIX: pode ser encontrado na sessão “Para métodos PIX” no PDF fornecido pelo Pinbank;
• Código do Cliente PIX: pode ser encontrado na sessão “Para métodos PIX” no PDF fornecido pelo Pinbank;
• Chave da Loja PIX: pode ser encontrado com o nome “Key Loja” na sessão “Para métodos PIX” no PDF fornecido pelo Pinbank;
• Homologação: informe “Não” (exceto se estiver realizando testes).

Para referência, abaixo é fornecido um exemplo de documento PDF do Pinbank:

Configuração do WebHook

Na tela “Parâmetros da Integração do Pinbank” do Uniplus Web, é fornecida a URL de Webhook. Esta URL deve ser copiada e enviada para a equipe de suporte do Pinbank para cadastro na plataforma. A API do Pinbank chamará esta URL sempre que uma transação for aprovada. Realizar esta etapa é fundamental para que a integração funcione corretamente, caso contrário, as transações não serão aprovadas no PDV. Cada cliente terá a sua própria URL:

Configuração do meio de pagamento

No Uniplus Web, cadastre um novo meio de pagamento do tipo “Carteira digital/Pix com integração” e informe a conta corrente:

Venda no PDV

No PDV devidamente configurado para conectar ao servidor Web, inicie a venda e finalize utilizando o meio de pagamento configurado. Será exibido na tela o QR Code para pagamento PIX, conforme imagem abaixo:

Após o pagamento ser realizado, o PDV irá finalizar a venda normalmente e o valor será creditado na conta corrente do cliente.

Cancelamento de pagamento

Para cancelar um pagamento feito, o operador deverá acessar no PDV o menu Outros → Carteira Digital ADM, escolhendo a opção “1 – Cancelar Pagamento” e informando os dados do documento gerado pelo PDV. Note que, caso o saldo da conta Pinbank esteja negativo, o pagamento não será cancelado.

Conteúdo Relacionado

Os artigos listados abaixo estão relacionados ao que você acabou de ler:
• Integrações
• Obtendo suporte técnico e ajuda
• Antes de Falar com o Suporte Técnico