Configuração da carteira de aplicativos DEUNA

Visão geral#

Este guia aborda a configuração do lado do comerciante do Carteira do aplicativo Deuna 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

1. Navegue até o administrador da DEUNA
2. Insira suas credenciais de comerciante
3. Clique Faça login

Etapa 2: navegue até métodos de pagamento

1. Na barra lateral esquerda, vá para Conexões
2. Clique em Métodos de pagamento
3. Procure Carteira do aplicativo Deuna na lista

Configuração inicial#

Ativando a carteira do aplicativo Deuna

Se Carteira do aplicativo Deuna ainda não está ativado:

1. Encontrar Carteira do aplicativo Deuna na lista Métodos de pagamento
2. Clique Habilitar ou Adicionar
3. Um painel de configuração será aberto com um formulário para adicionar o processador
4. Preencha tudo quatro campos de credenciais obrigatórios (veja a seção abaixo)
5. Selecione o seu preferido modo de pagamento (veja a seção abaixo)
6. 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 App Wallet

Quando você habilita Carteira do aplicativo Deuna, você deve adicionar o processador com credenciais de sua conta Deuna App Wallet.

Para adicionar o processador:

1. No painel de configuração da Deuna App Wallet
2. Clique Adicionar processador ou Configurar credenciais
3. Preencha todos os quatro campos obrigatórios:

Campos obrigatórios

Formulário passo a passo

Ampliar

Importante:

• Todos os quatro campos são obrigatório
• Suas credenciais vêm de sua conta comercial Deuna App Wallet
• 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

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:

1. O cliente vê um código grande de 6 dígitos
2. O código expira em exatamente 3 minutos
3. O cliente deve abrir o Deuna App e inserir o código manualmente
4. Após entrar, o cliente confirma no app
5. Pagamento confirmado via webhook

Para selecionar este formato:

1. Na forma de processador
2. Abaixo Formato, selecione Código Numérico (CODIGO_6_DIGITOS)
3. 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:

1. O cliente vê um código QR dinâmico
2. O código QR é válido por exatamente 15 minutos
3. O cliente pode:
   • Digitalizar com a câmera Deuna App
   • Clique para abrir o aplicativo diretamente
4. Pagamento confirmado via webhook

Para selecionar este formato:

1. Na forma de processador
2. Abaixo Formato, selecione Código QR
3. 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 do aplicativo 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 a Deuna App Wallet seja provisionada para sua conta

Problema: o processador não salva ou mostra erro

Solução:

1. 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)
2. Verifique se as credenciais estão corretas na sua conta Deuna App Wallet
3. Teste suas credenciais primeiro no painel do Deuna App Wallet
4. Tente novamente em um navegador diferente
5. Entre em contato com o suporte da Deuna se o problema persistir

Problema: os clientes não conseguem ver a carteira do aplicativo Deuna na finalização da compra

Verifique:

1. A carteira do aplicativo Deuna é Ativado (não desativado)
2. O processador está configurado corretamente (todos os quatro campos preenchidos)
3. O pedido do cliente está em USD moeda
4. O cliente está em Equador (ou usando o endereço de cobrança do Equador)
5. O widget de pagamento inclui deuna_wallet processador
6. 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 a Deuna App Wallet, 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
• Webhooks - Permissão de leitura/gravação (para configuração de webhook)

Se você não tiver permissões:

1. Pergunte ao proprietário ou administrador da sua conta
2. 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:

1. Todas as alterações de configuração ficam visíveis para todos os administradores
2. Qualquer administrador pode alterar o modo de pagamento (não recomendado sem comunicação)
3. Ative os registros de auditoria para rastrear alterações:
   • Acessar Funções e permissões do usuário
   • Habilitar Registro de atividades

Melhores Práticas#

Configuração

✅ Faça:

• Testar a conectividade do webhook 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 a Deuna App Wallet sem notificar sua equipe
• Mude frequentemente os modos de pagamento sem motivo
• Compartilhe URLs de webhook em canais não seguros
• 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 os logs de entrega do webhook regularmente
• Monitore solicitações de reembolso em busca de tendências
• Teste a conectividade do webhook mensalmente

❌ Não:

• Ignore falhas de webhook por longos períodos
• Ignorar o teste de integração do comerciante
• Esqueça de atualizar o URL do webhook se o seu back-end mudar