Pular para o conteúdo principal
Nesta página

As funcionalidades de pagamento estendem o ciclo de vida de pagamento. Utilize este guia para escolher a funcionalidade necessária, entender onde ela é aplicada e acessar a documentação de implementação baseada em código, sem considerar que uma funcionalidade documentada globalmente é automaticamente habilitada para todos os provedores.

01 · qualify
Confirmar elegibilidade
Verificar o provedor, método de pagamento, mercado, moeda, canal, operação e configuração do comerciante.
02 · configure
Ativar a funcionalidade
Aplicar a conexão, campanha, estratégia ou configuração de conta aprovada na DEUNA.
03 · integrate
Enviar o contrato
Utilize os campos da API ou SDK documentados e preserve os identificadores e as próximas ações retornadas.
04 · verify
Testar todos os resultados
Exercitar os caminhos de sucesso, rejeição, timeout, duplicação, assíncrono e recuperação.
05 · operate
Reconciliar continuamente
Utilize os estados autoritativos e webhooks verificados antes das operações de conclusão ou acompanhamento.

Encontrar uma funcionalidade#

Autenticação e gerenciamento de risco

Gerenciamento de cartões e credenciais

Parcelamento e ciclo de vida do valor

Implemente a funcionalidade no ciclo de vida do pagamento#

Diagrama de fluxo
NoYes1Create order2Normalize and enrich3Risk andauthentication4Purchase orauthorize5Final now?6Wait for webhook orretrieval7Authoritative state8Capture, void, orrefund9Reconcile amountsand status
Revisão ou pendenteResultado
PalcoExemplos de funcionalidadesO que é considerado autoritativo
Antes do processamentoNormalização de endereços, detecção de cartão, recomendações, prevenção de fraudesA ordem de fundo e a elegibilidade da conexão configurada
Autenticação3DS, autenticação dinâmica, consentimento de carteiraA próxima ação e o estado de pagamento posterior – não apenas o retorno do navegador
ProcessamentoCompra, autorização, parcelamento, conversãoO valor de pagamento DEUNA confirmado, moeda e status
Após a autorizaçãoCaptura, captura parcial, cancelamento automáticoValor autorizado restante e estado da operação confirmado pelo provedor
Após a coletaReembolso, reembolso parcial, reembolso assíncronoValor restante reembolsável e estado da operação confirmado pelo provedor

A compatibilidade é multidimensional#

Uma funcionalidade está disponível somente quando todas as dimensões exigidas concordam:

DimensãoVerificar
Provedor e credenciaisA conexão e o tipo de credencial suportam a operação
Mercado e moedaO país, a moeda e a forma de liquidação configurados são elegíveis
Método de pagamentoO método de pagamento selecionado (cartão, carteira, transferência bancária, voucher ou BNPL) expõe a funcionalidade
Canal e SDKWeb, iOS, Android, React Native ou API direta suportam a ação necessária do cliente
Configuração da contaA funcionalidade, estratégia, campanha, limites e janelas de tempo estão habilitadas para o comerciante
Gerenciamento de estadoA integração suporta todos os estados transitórios, de sucesso, de falha e de recuperação que recebe

Uso Recursos dos provedores Para disponibilidade publicada e Fluxo e status de pagamento Para o modelo de estado completo.

Lista de verificação de lançamento#

  1. Documente o resultado de negócios e a condição exata que permite a funcionalidade.
  2. Verifique os campos da API ou SDK pública em relação ao guia vinculado; não infira campos a partir das etiquetas do Admin.
  3. Teste a funcionalidade com a combinação real do provedor, mercado, moeda e método de pagamento.
  4. Inclua casos de rejeição, pendência, timeout, duplicidade, parcialmente concluído e indisponível.
  5. Garanta que as ações no backend sejam idempotentes e mantenha as credenciais privadas fora das aplicações do cliente.
  6. Realize ou reverta fundos apenas a partir de um estado autorizado da DEUNA.
  7. Monitore tanto as métricas de experiência do cliente quanto a reconciliação financeira após o lançamento.

Nesta seção