Gerenciar credenciais

Sobre este guia

Este guia explica como gerenciar credenciais para uso no serviço 1-Click através do Painel do Lojista.

Pré-requisitos

Antes de começar, é necessário possuir um cadastro no PicPay para integrar-se ao produto 1-Click. Com isso você consiguirá realizar o login no painel do lojista e gerar ou atualizar seus tokens.

Informação

Para criar uma credencial no painel pela primeira vez, é preciso configurar algumas informações essenciais, conforme descrito abaixo. Após a criação, esses dados poderão ser atualizados sempre que necessário.

Tipos de Fluxo

Ao integrar sua aplicação ao serviço 1-Click no Painel do Lojista, você deve optar entre dois tipos de fluxo: Web ou App. Esta escolha é definitiva e será aplicada a todo o cadastro, não sendo possível alternar entre os dois fluxos após a definição inicial.

Atenção

Se sua aplicação inclui qualquer etapa do processo de autorização ou consentimento realizada em uma página web, você deve obrigatoriamente optar pelo Fluxo Web. O Fluxo App não é compatível com experiências que envolvam interfaces web.

Fluxo App

Neste fluxo, o usuário realiza a autenticação e o consentimento diretamente no aplicativo PicPay.

• Utiliza biometria sempre que possível, eliminando a necessidade de um segundo fator de autenticação;
• Permite ao usuário selecionar o método de pagamento desejado no momento da autorização.

Fluxo Web

Neste fluxo, o usuário realiza a autenticação e o consentimento em uma página web, informando os dados de login da conta PicPay.

• Requer autenticação por segundo fator, garantindo maior segurança;
• Não suporta biometria;
• O usuário não pode selecionar o método de pagamento durante o processo.

Redirecionamento

Após escolher o fluxo, será necessário configurar as URLs de redirecionamento.

As URLs de redirecionamento definidas durante o cadastro devem corresponder àquelas utilizadas no parâmetro redirect_uri ao montar a URL para o fluxo de autenticação. Essa url será validada quando o usuário iniciar o processo de autenticação e consentimento. Esta validação assegura que o authorization_code gerado será enviado para um destino seguro e confiável, protegendo os dados do cliente e prevenindo fraudes.

Configurações adicionais

Nesta etapa, você precisará definir algumas configurações adicionais importantes para a criação das suas credenciais. Para ajudá-lo, detalhamos abaixo cada uma dessas configurações e sua finalidade.

• URL para conexão

  Essa URL é utilizada para direcionar o cliente que, ao acessar o aplicativo do PicPay e explorar a listagem de parceiros, deseja iniciar a conexão com sua aplicação. Ao configurá-la, você define o destino para onde o cliente será redirecionado, dando início ao processo de autorização e consentimento.

• Timeout

  O timeout define o tempo que sua aplicação aguardará por uma resposta do serviço 1-Click durante o processo de cobrança. Por padrão, este valor é configurado para 30 segundos, mas pode ser personalizado conforme a necessidade.

Atenção

Importante: Configurar um timeout adequado é essencial para garantir a experiência do cliente e a aprovação das transações dentro do tempo esperado. Caso a transação seja aprovada após o tempo de espera configurado, ela será reembolsada de forma automática. Confira mais detalhes aqui

• URL de redirecionamento para o aplicativo PicPay

  Essa URL é um deeplink específico para o aplicativo PicPay, que pode ser copiado e utilizado para redirecionar o usuário diretamente à página de detalhes do parceiro no aplicativo. Nessa página, o usuário pode gerenciar seus métodos de pagamento e revogar o consentimento de maneira prática e segura diretamente pelo aplicativo do PicPay.

Atualização de dados

Após gerar suas credenciais pela primeira vez, você poderá atualizá-las sempre que necessário utilizando o botão Atualizar Dados.

Ao clicar em Atualizar Dados, você poderá alterar as informações atuais e poderá habilitar a opção de aparecer na listagem do usuário.

Visibilidade no Aplicativo PicPay

Assim que sua integração estiver pronta para aceitar conexões de novos clientes, você pode optar por exibir sua aplicação na lista de parceiros no aplicativo PicPay através da opção aparecer na listagem do usuário.

Dessa forma, quando um cliente acessar a lista de parceiros no aplicativo PicPay, poderá iniciar a autenticação e o consentimento com sua aplicação.

Informação

Os clientes que já estiverem conectados sempre visualizarão sua aplicação na seção de parceiros conectados no aplicativo PicPay, mesmo que ela não esteja visível na listagem pública.

Exemplo da visão que o usuário possui ao acessar a listagem de parceiros no aplicativo PicPay

Informação

Através da listagem de parceiros no aplicativo PicPay, o cliente pode visualizar e gerenciar as conexões com aplicativos parceiros, bem como revogar o consentimento e atualizar os métodos de pagamento a qualquer momento.

Próximos passos

Com um client_id e client_secret válidos, seu aplicativo poderá gerar um access_token válido. Confira abaixo os próximos passos:

• Gerando access_token;

Obtendo ajuda

Esperamos ter ajudado com este artigo! Caso tenha restado alguma dúvida, você pode consultar a nossa FAQ ou entrar em contato através do e-mail negocios@atendimento.picpay.com.