Perguntas frequentes
Encontre o guia oficial da DEUNA para perguntas comuns sobre administração, APIs, checkout, SDKs, plugins, testes e webhooks.
Nesta página
Essas respostas apontam para a fonte de informação mais atual, em vez de duplicar configurações ou contratos de API que podem mudar. Se uma página não documenta uma funcionalidade, trate-a como não confirmada e consulte seu Gerente de Contas Técnicas da DEUNA (TAM) antes de implementar.
Administrador#
Como obter acesso ao DEUNA Admin?
Um operador autorizado da sua organização deve convidá-lo e atribuir a função necessária para sua tarefa. Comece com Gerenciar usuários e funções, e, em seguida, siga Autenticação de dois fatores se sua conta ou organização exigirem. As credenciais da API não criam uma sessão de Admin.
Onde posso configurar um processador ou método de pagamento?
Abra Conexões No painel de administração, seguindo as instruções específicas para aquele provedor. As credenciais e a disponibilidade são específicas para a conta e o ambiente. Utilize Conexões para entender o fluxo de trabalho e catálogo de provedores para confirmar a funcionalidade antes de configurá-la.
Posso personalizar a aparência do checkout?
Sim, dentro dos controles suportados pela sua experiência de checkout. Utilize Tema e controles compartilhados para configurar o tema da DEUNA e a página de personalização específica para a integração, quando um plugin ou SDK adiciona suas próprias restrições. Mantenha o contraste, a visibilidade do foco e os layouts responsivos utilizáveis após cada alteração.
Integração com a API#
É possível integrar diretamente através da API?
Sim. Execute o guia de início rápido da API a partir de um backend confiável, e então utilize a catálogo de endpoints Para o contrato público de requisição e resposta exato. Nunca coloque uma chave de API privada em um navegador ou aplicativo móvel.
Qual credencial devo usar?
A resposta depende de onde a requisição é executada e qual autoridade ela precisa. Um SDK para o lado do cliente utiliza o contexto de aplicação público documentado; operações seguras entre servidores utilizam uma chave de API privada; fluxos de clientes autenticados também podem utilizar um token Bearer do cliente. A tabela de decisão e os exemplos de cabeçalhos estão em Autenticação e chaves de API.
Como posso testar sem afetar o ambiente de produção?
Utilize credenciais de teste e a URL base do ambiente de teste, conforme documentado em Fundamentos de integração. Mantenha as chaves de teste, webhooks, contas de provedor e a configuração do comerciante separados entre os ambientes de teste e produção. Valide tanto os fluxos bem-sucedidos quanto os falidos antes de solicitar a ativação no ambiente de produção.
Onde estão documentados os códigos de resposta e erro?
O Erros e recuperação A referência detalha os códigos de status públicos e as opções de recuperação segura. A referência específica de cada endpoint é a fonte oficial para seus requisitos de solicitação, resposta, público e autorização.
Checkout, SDKs e plugins#
Qual integração de checkout devo escolher?
Escolha com base na experiência do usuário que você deseja controlar, na plataforma em que ela será executada e nos limites de confiança para dados de pagamento. Check-out on-line compara o caminho principal da web, enquanto o Visão geral do SDK Responsabilidades para Web, iOS, Android e React Native.
Onde estão os métodos e callbacks do SDK?
Inicie o processo Visão geral do SDK, selecione sua plataforma e utilize a plataforma compartilhada. evento e resposta Referências, quando aplicável. Não assuma que funcionalidades com nomes semelhantes utilizam métodos idênticos em todas as plataformas.
Quais métodos de pagamento posso exibir?
A disponibilidade dos métodos de pagamento depende do país, da moeda, do canal, da conexão com o provedor e da configuração da conta. Filtre os resultados gerados. catálogo de provedores, e siga então as instruções do provedor ou do método de pagamento escolhido. Não assuma a disponibilidade com base em uma captura de tela ou no processo de checkout de outro comerciante.
É possível integrar através de um plugin de comércio eletrônico?
Uso Plug-ins Para verificar integrações com plataformas de comércio eletrônico suportadas, consulte a documentação para a VTEX. Visão geral da VTEX, complete as guias de instalação e configuração, e realize um teste de compra no ambiente de sandbox antes da implantação em produção.
Como cupons, impostos, frete ou gorjetas afetam o processo de pagamento?
Você pode usar callbacks assíncronos específicos do comerciante, quando essa funcionalidade estiver configurada para sua conta. Webhook de checkout dinâmico Este guia explica os limites de execução, o mapeamento de solicitações e respostas, a validação e o tratamento de falhas. Não crie um evento de callback ou campo mutável que não tenha sido certificado para o seu comerciante.
Webhooks e resultados de pagamento#
Preciso de um webhook?
Utilize webhooks de status quando seu backend precisa reagir a alterações de pagamento assíncronas sem depender do navegador, de um redirecionamento ou de um callback de SDK. Alguns métodos de pagamento atingem seu estado final após o cliente deixar o checkout. Implemente o fluxo de notificação assinado e valide o estado da ordem oficial antes de qualquer ação irreversível, como a entrega.
E se um webhook for atrasado, duplicado ou chegar fora de ordem?
Verifique a assinatura, aceite permanentemente a notificação, deduplique-a e impeça que um evento mais antigo mova seu registro local para trás. A entrega não é prova de "exatamente uma vez" ou de ordem de ciclo de vida. Siga as Reconheça e reconcilie e utilize um processo de reconciliação separado para pagamentos não resolvidos.
Um callback do SDK ou redirecionamento no navegador comprovam o pagamento?
Não. A conclusão no lado do cliente é útil para a experiência do cliente, mas seu backend deve usar o resultado e o fluxo de status do servidor documentado antes de qualquer ação. Mantenha o estado da interface, o estado do pagamento e o estado de liquidação como preocupações separadas.
Documentação e ferramentas de IA#
Um agente de programação baseado em IA pode pesquisar estas documentações?
Sim. Conecte um cliente compatível ao acesso somente leitura. Documentação MCP do DEUNA. Pesquisa a mesma documentação pública, inventário de endpoints e catálogo de provedores publicados neste site, e não requer nem aceita suas credenciais da DEUNA.
Esta funcionalidade não está documentada. Devo presumir que funciona?
Não. Confirme com a DEUNA TAM ou com o proprietário do contrato público aplicável. Inclua o ambiente, o produto, o provedor, a operação pretendida e a página pública que consultou, mas remova as chaves de API, tokens, dados de cartão, chaves privadas e dados do cliente.