Configuração do Deuna (Banco Pichincha)
Configure a conexão da carteira Deuna apoiada pelo Banco Pichincha no DEUNA Admin.
Nesta página
Visão geral#
Este guia aborda a configuração do lado do comerciante do Deuna (Banco Pichincha) no painel de administração DEUNA. A configuração é uma configuração única que determina qual modo de pagamento seus clientes usarão.
Acessando a configuração#
Etapa 1: Faça login no DEUNA Admin
- Navegue até o administrador da DEUNA
- Insira suas credenciais de comerciante
- Clique Faça login
Etapa 2: navegue até métodos de pagamento
- Na barra lateral esquerda, vá para Conexões
- Clique em Métodos de pagamento
- Procure Carteira Deuna na lista. Este identificador de administrador refere-se à carteira Deuna apoiada pelo Banco Pichincha.
Configuração inicial#
Habilitando Deuna (Banco Pichincha)
Se Deuna (Banco Pichincha) ainda não está ativado:
- Encontrar Carteira Deuna na lista Métodos de pagamento. Este é o rótulo Admin para a conexão Deuna (Banco Pichincha).
- Clique Habilitar ou Adicionar
- Um painel de configuração será aberto com um formulário para adicionar o processador
- Preencha tudo quatro campos de credenciais obrigatórios (veja a seção abaixo)
- Selecione o seu preferido modo de pagamento (veja a seção abaixo)
- Clique Salvar
A forma de pagamento já está ativa e aparecerá como opção para seus clientes na finalização da compra.
Adicionando o Processador Deuna (Banco Pichincha)
Quando você habilita Deuna (Banco Pichincha), você deve adicionar o processador com credenciais da sua conta Deuna (Banco Pichincha).
Para adicionar o processador:
- No painel de configuração do Deuna (Banco Pichincha)
- Clique Adicionar processador ou Configurar credenciais
- Preencha todos os quatro campos obrigatórios:
Campos obrigatórios
| Campo | Descrição | Exemplo | Notas |
|---|---|---|---|
| Public API Key | Chamada de "chave API" em Deuna (Banco Pichincha) | pub_abc123xyz789 | Mapeia para o cabeçalho x-api-key |
| Private API Key | Chamado de "API Secret" em Deuna (Banco Pichincha) | sec_abc123xyz789 | Mapeia para o cabeçalhox-api-secret |
| Ponto de Venda (CAJA) | Chamado "CAJA" em Deuna (Banco Pichincha) | 4200069 | Identificador de string do seu ponto de venda |
| Formato | Tipo de código de pagamento | QR ou CODIGO_6_DIGITOS | Determina se os clientes recebem QR ou código de 6 dígitos |
Formulário passo a passo
Importante:
- Todos os quatro campos são obrigatório
- Suas credenciais vêm de sua conta comercial Deuna (Banco Pichincha)
- A seleção do formato aqui determina o modo de pagamento para todos os pedidos
- Depois de salvar, as credenciais são criptografadas e armazenadas com segurança
Escolhendo seu formato de pagamento#
Ao preencher o formulário do processador, você deve selecionar seu formato de pagamento. Essa escolha é feita no momento da adição de credenciais e determina como seus clientes irão interagir com o fluxo de pagamento.
Guia de seleção de formato
| Aspecto | Código Numérico (CODIGO_6_DIGITOS) | Código QR |
|---|---|---|
| O cliente vê | Código de 6 dígitos | Código QR dinâmico |
| Janela de tempo | 3 minutos | 15 minutos |
| Como pagar | Digite no aplicativo | Digitalize ou clique |
| Melhor para | Check-out em desktop/tablet | Check-out que prioriza o celular |
| Experiência do usuário | Entrada manual necessária | Rápido, um toque/digitalização |
| Valor do campo | CODIGO_6_DIGITOS | QR |
Formato 1: Código Numérico (CODIGO_6_DIGITOS, 3 Minutos)
Escolha isto se:
- Seus clientes usam principalmente desktop/tablet
- Você quer uma janela de transação rápida
- Seu fluxo de checkout é executado em vários tipos de dispositivos
- Você prefere simplicidade e dependências mínimas
Como funciona:
- O cliente vê um código grande de 6 dígitos
- O código expira em exatamente 3 minutos
- O cliente deve abrir o aplicativo Deuna e inserir o código manualmente
- Após entrar, o cliente confirma no app
- DEUNA processa o estado do pagamento final de forma assíncrona
Para selecionar este formato:
- Na forma de processador
- Abaixo Formato, selecione Código Numérico (CODIGO_6_DIGITOS)
- Preencha o formulário e clique Salvar processador
Verificação:
- Depois de salvo, você verá uma mensagem de confirmação
- Todos os pedidos subsequentes usarão códigos numéricos de 6 dígitos
Formato 2: Código QR (15 minutos)
Escolha isto se:
- Seus clientes são principalmente usuários móveis
- Você deseja uma janela de transação mais longa para flexibilidade
- Você prefere uma experiência moderna com um toque
- A digitalização QR é comum em seu mercado-alvo
Como funciona:
- O cliente vê um código QR dinâmico
- O código QR é válido por exatamente 15 minutos
- O cliente pode:
- Digitalizar com a câmera do aplicativo Deuna
- Clique para abrir o aplicativo diretamente
- DEUNA processa o estado do pagamento final de forma assíncrona
Para selecionar este formato:
- Na forma de processador
- Abaixo Formato, selecione Código QR
- Preencha o formulário e clique Salvar processador
Verificação:
- Depois de salvo, você verá uma mensagem de confirmação
- Todos os pedidos subsequentes usarão códigos QR
Painel de configuração#
Solução de problemas de configuração
Problema: não é possível encontrar a carteira Deuna na lista de métodos de pagamento
Solução:
- Atualize a página
- Verifique se você tem permissão para "Pagamentos" na sua função de usuário
- Entre em contato com o suporte da DEUNA para garantir que o Deuna (Banco Pichincha) seja provisionado para sua conta
Problema: o processador não salva ou mostra erro
Solução:
- Verifique se todos os quatro campos de credenciais estão preenchidos:
- Chave de API pública (não vazia)
- Chave de API privada (não vazia)
- Ponto de Venda / CAJA (não vazio, sequência numérica)
- Formato selecionado (QR ou código numérico)
- Verifique se as credenciais da sua conta Deuna (Banco Pichincha) estão corretas
- Teste primeiro suas credenciais no painel do Deuna (Banco Pichincha)
- Tente novamente em um navegador diferente
- Entre em contato com o suporte da DEUNA se o problema persistir
Problema: os clientes não conseguem ver o Deuna (Banco Pichincha) no checkout
Verifique:
- Carteira Deuna é Habilitado (não desativado) no DEUNA Admin
- O processador está configurado corretamente (todos os quatro campos preenchidos)
- O pedido do cliente está em USD moeda
- O cliente está em Equador (ou usando o endereço de cobrança do Equador)
- O widget de pagamento inclui
deuna_walletprocessador - O token do pedido foi gerado com sucesso
Se tudo verificado:
- Entre em contato com o suporte da DEUNA
Permissões e acesso#
Funções administrativas necessárias
Para configurar o Deuna (Banco Pichincha), sua conta de usuário deve ter:
- Conexões - Permissão de leitura/gravação
- Métodos de pagamento - Permissão de leitura/gravação
Se você não tiver permissões:
- Pergunte ao proprietário ou administrador da sua conta
- Eles podem conceder permissões em Funções e permissões do usuário seção
Configuração de vários administradores
Se vários administradores gerenciarem pagamentos:
- Todas as alterações de configuração ficam visíveis para todos os administradores
- Qualquer administrador pode alterar o modo de pagamento (não recomendado sem comunicação)
- Ative os registros de auditoria para rastrear alterações:
- Vá para Funções e permissões do usuário
- Habilitar Registro de atividades
Melhores Práticas#
Configuração
✅ Faça:
- Teste a conclusão do pagamento assíncrono após a configuração
- Escolha a forma de pagamento com base na sua base de clientes
- Revise as limitações de reembolso antes de ativar
- Documente sua escolha de modo para sua equipe
❌ Não:
- Desative o Deuna (Banco Pichincha) sem avisar sua equipe
- Mude frequentemente os modos de pagamento sem motivo
- Suponha que a seleção do modo possa ser substituída por pedido (não pode)
Monitoramento
✅ Faça:
- Verifique as métricas de pagamento semanalmente
- Revise regularmente os estados de pagamento não resolvidos
- Monitore solicitações de reembolso em busca de tendências
- Teste a conclusão do pagamento assíncrono regularmente
❌ Não:
- Ignore estados de pagamento não resolvidos por longos períodos
- Ignorar o teste de integração do comerciante