Pular para o conteúdo principal
Todos os sistemas operacionaisNovidadesv1
Entrar

Roteamento APM

Nesta página

O APM Routing permite que você direcione automaticamente as transações para a conta correta de Método de Pagamento Alternativo (APM) com base em regras inteligentes.

Disponibilidade atual O roteamento APM está disponível para fluxos de carteira e transferência bancária suportados. Os fluxos de voucher, BNPL, dinheiro, POS e pagamento de referência não são roteados por esta capacidade. A disponibilidade ainda depende da conexão APM e das regras configuradas.

Exemplo interativoUsa dados de exemplo e não faz solicitações à API.
Produção
Estratégias de pagamento

Roteamento de APM

Selecione a credencial do provedor correspondente ao contexto do pagamento.

Acme LATAM · Produção
ConfiguraçãoRoteamento de APM
Ativa
Credencial do provedor
RoteamentoPayPal · USD primary

O que é roteamento APM?#

O APM Routing é essencial para comerciantes que operam com múltiplas contas para o mesmo provedor de APM, que normalmente são segmentadas por moeda, país ou valor da transação.

Se você processa transações do PayPal em MXN e USD, provavelmente terá credenciais do PayPal separadas para cada moeda. O APM Routing garante que cada transação use automaticamente a conta correta sem intervenção manual.

Como funciona#

Quando um cliente inicia uma transação, o mecanismo de roteamento da DEUNA avalia as regras configuradas em tempo real e seleciona a credencial APM apropriada com base no contexto da transação (moeda, país, valor).

Essa seleção acontece automaticamente em todos os pontos de contato críticos:

  • Recuperação de forma de pagamento (GET /payment-methods) — Retorna a credencial correta para inicialização do frontend
  • Fluxo de consentimento (/consent) — Garante a seleção adequada da conta
  • Processamento de pagamento final — Encaminha a transação para a conta correspondente

O sistema segue uma resolução baseada em prioridade: regras específicas são avaliadas primeiro, seguidas pela sua configuração padrão se nenhuma regra corresponder.

Configurar o roteamento APM#

Configurar o roteamento APM no DEUNA Admin é simples:

Etapa 1: conecte suas credenciais do APM

  1. Faça login no administrador DEUNA.
  2. Navegue até Métodos de pagamento.
  3. Conecte sua primeira credencial APM.
    • Isso automaticamente se torna seu padrão credential.
    • Uma estratégia de pagamento padrão é criada automaticamente.
  4. Adicione credenciais adicionais para o mesmo APM conforme necessário.

Etapa 2: criar regras de roteamento

  1. Navegue até Estratégias.
  2. Clique no APMs tab.
  3. Clique Criar nova regra.
  4. Defina suas condições de roteamento:
    • Moeda: Roteamento na moeda da transação.
    • País: País onde ocorre a transação.
    • Quantidade: Roteamento baseado no valor da transação.
  5. Selecione qual credencial APM deve lidar com transações correspondentes.
  6. Nomeie a regra de roteamento
  7. Defina a prioridade de roteamento.
  8. Salve a regra

Condições de regra disponíveis:

  • Moeda
  • País
  • Quantidade

Você pode combinar diversas condições em uma única regra usando a lógica AND. Por exemplo: "Moeda = USD AND País = EUA AND Valor > 100".

Etapa 3: gerenciar prioridades de regras

As regras são avaliadas em ordem de prioridade, da mais alta para a mais baixa:

  1. Em Estratégias, vá para o APMs section.
  2. Veja sua tabela de regras.
  3. Arraste e solte regras para reordenar a prioridade.
  4. As regras no topo são avaliadas primeiro.
  5. Se nenhuma regra específica corresponder, a credencial padrão será usada.

Avaliação antifraude para APMs#

DEUNA apoia uma etapa de avaliação antifraude pré-APM que permite aos comerciantes avaliar as transações APM quanto ao risco de fraude antes o pagamento é enviado ao provedor APM. Esta capacidade traz o mesmo nível de proteção contra fraude disponível para fluxos de cartões baseados em PSP para métodos de pagamento alternativos.

Por que antifraude para APMs?

Alguns APMs – como o PayPal – ainda podem gerar perdas por fraude, disputas ou estornos. Os comerciantes que desejam ter mais controle sobre esses fluxos agora podem configurar um provedor antifraude para avaliar a transação antes que ela chegue ao APM. Isto garante que as transações arriscadas sejam bloqueadas antecipadamente, reduzindo a exposição a perdas relacionadas com fraudes.

Como funciona

Quando o antifraude está habilitado para um fluxo APM compatível, a DEUNA adiciona um etapa de orquestração pré-APM para o fluxo de pagamento:

  1. O cliente inicia um pagamento usando um APM compatível (por exemplo, PayPal).
  2. DEUNA avalia a transação através do provedor antifraude configurado antes enviando para a APM.
  3. O provedor antifraude retorna uma avaliação de risco.
  4. A DEUNA normaliza a resposta num resultado de risco padronizado: Baixo risco, Risco Médio, ou Alto risco.
  5. A DEUNA aplica a ação configurada pelo comerciante para esse nível de risco:
    • Permitir (rota): A transação continua para o APM para processamento do pagamento.
    • Recusar (Bloquear): DEUNA interrompe a transação antes que ela chegue ao APM.
  6. Se a ação for Permitir, o pagamento prosseguirá para o APM com a carga correta específica do APM preservada.

Configurar antifraude para APMs#

Etapa 1: Conecte seu provedor antifraude

  1. Faça login no Administrador DEUNA.
  2. Navegue até Conexões.
  3. Selecione e configure o provedor antifraude que deseja usar para avaliação de APM (por exemplo, Cybersource ou Riskified).
  4. Siga as instruções de configuração específicas do provedor no Mecanismos antifraude documentation.

Passo 2: Configurar a regra APM + antifraude em Estratégias

  1. No DEUNA Admin, navegue até Estratégias.
  2. Vá para o APMs tab.
  3. Crie ou edite uma regra de roteamento para o APM compatível (por exemplo, PayPal).
  4. Ative a avaliação antifraude para a regra e selecione o provedor antifraude.
  5. Configure a ação para cada resultado de risco normalizado:
    • Baixo risco: Permitir ou bloquear
    • Risco Médio: Permitir ou bloquear
    • Alto risco: Permitir ou bloquear
  6. Salve a regra.

Etapa 3: verifique os detalhes do pedido

Após processar as transações, verifique se a avaliação antifraude está funcionando corretamente:

  1. Navegue até Transações > Detalhes do pedido.
  2. Confirme se as seguintes informações estão visíveis:
    • Se o antifraude foi executado antes da APM.
    • Qual provedor antifraude foi usado.
    • O resultado de risco normalizado (Baixo/Médio/Alto).
    • A ação aplicada pela DEUNA (Permitir ou Bloquear).
    • O tempo de execução da etapa antifraude.

As transações bloqueadas pelo antifraude são claramente distinguíveis das transações rejeitadas ou que falharam na camada APM.

Visibilidade da transação#

Cada transação processada por meio de roteamento APM — com ou sem antifraude — inclui rastreabilidade total.

Rastreabilidade de roteamento

  1. Em Transações, vá para Detalhes da transação.
  2. Veja a solicitação e resposta JSON.
  3. Veja qual regra de roteamento foi aplicada.
  4. Identifique o nome específico do processador de pagamentos do comerciante usado.

Rastreabilidade antifraude

Quando o antifraude está habilitado para um fluxo APM, os detalhes do pedido incluem:

  • Provedor antifraude utilizado para a avaliação.
  • Resultado de risco normalizado (Baixo Risco, Médio Risco ou Alto Risco).
  • Ação aplicada por DEUNA (Permitir ou Bloquear).

Eventos de visibilidade de transação

DEUNA gera os seguintes eventos de visibilidade de transação para fluxos antifraude APM:

EventoDescrição
tv_fraud_analysisGerado quando a avaliação antifraude é concluída. O response_data a carga útil inclui o identificador do APM e o nome do APM associado à transação, indicando claramente qual método de pagamento alternativo foi avaliado.
tv_antifraud_unavailableGerado quando o provedor antifraude não retorna nenhuma resposta, atinge o tempo limite ou falha devido a um erro técnico. Inclui o motivo da falha.

Gerenciando credenciais do APM#

Gerencie credenciais APM no DEUNA.

Alterar o APM padrão

  1. Em Estratégias, vá para o APMs section.
  2. Localize a credencial que deseja definir como credencial padrão.
  3. Clique Definir como padrão.

Excluir uma credencial

Ao excluir uma credencial APM:

  • Se for o padrão: Selecione uma nova credencial padrão
  • Se for usado em regras ativas:
    • Desative as regras associadas.
    • Reatribua as regras a uma credencial diferente.

Isso evita interrupções acidentais no seu roteamento de pagamento.

Gerenciamento de regras#

DEUNA Admin fornece controle completo sobre suas regras de roteamento:

Ações de regras:

  • Criar: Definir novas regras de roteamento
  • Editar: modificar condições ou atribuições de regras existentes
  • Inativar: Desative temporariamente as regras sem excluí-las
  • Salvar como rascunho: Prepare regras antes de ativá-las

Visibilidade da regra:

Todas as regras são exibidas em uma tabela abrangente que mostra:

  • Prioridade
  • Nome da regra
  • Data de criação
  • Provedor de APM
  • Status (Ativo/Inativo/Rascunho)

Casos de uso comuns#

Aprenda sobre casos de uso comuns para roteamento APM no DEUNA.

Caso de uso 1: roteamento baseado em moeda

Cenário: Você processa transações do PayPal em MXN e USD com contas separadas.

Configuração:

  1. Conecte a credencial MXN do PayPal (definida como padrão).
  2. Conecte a credencial PayPal USD.
  3. Criar regra:
    1. "Moeda = USD"
    2. Rota para PayPal USD
  4. A regra padrão lida automaticamente com transações MXN.

As transações em USD usam automaticamente credenciais do PayPal USD, enquanto as transações em MXN usam credenciais do PayPal MXN.

Caso de uso 2: roteamento específico do país

Cenário: Você tem contas PayPal diferentes no México e nos Estados Unidos.

Configuração:

  1. Criar regra: "Country = US" para encaminhar para o PayPal US
  2. Criar regra: rota "Country = MX" para PayPal MX
  3. Defina um como padrão para outros países

Resultado: As transações de cada país são encaminhadas para a conta regional apropriada.

Caso de uso 3: recusar transações específicas

Cenário: Você deseja recusar pedidos em dólares americanos sem processá-los.

Configuração:

  1. Crie uma regra: "Moeda = USD" para definir como Recusar.
  2. A regra padrão trata todas as outras moedas normalmente.

Resultado: As transações em dólares americanos são automaticamente recusadas antes do processamento, enquanto outras moedas prosseguem normalmente.

Caso de uso 4: avaliação antifraude pré-APM

Cenário: Você deseja avaliar as transações do PayPal por meio de um provedor antifraude (por exemplo, Cybersource) antes de enviá-las ao PayPal, para que as transações de alto risco sejam bloqueadas antes da execução do pagamento.

Configuração:

  1. Conecte suas credenciais antifraude em Conexões.
  2. Navegue até Estratégias > APMs.
  3. Crie uma regra de roteamento.
  4. Habilite a avaliação antifraude e selecione antifraude (Ex. Cybersource) como fornecedor.
  5. Configure ações de risco:
    • Baixo risco: Permitir Ex. Carteira PayPal
    • Risco Médio: Permitir -> Ex. Carteira PayPal
    • Alto risco: Bloquear
  6. Salve a regra.

Resultado: Cada transação do PayPal é avaliada pela Cybersource antes de chegar ao PayPal. As transações de baixo e médio risco ocorrem normalmente, enquanto as transações de alto risco são bloqueadas. O detalhe do pedido mostra o resultado da avaliação antifraude e a ação aplicada.

Melhores práticas e limitações#

  1. Sempre configure um padrão: Certifique-se de que cada APM tenha uma credencial padrão para lidar com transações que não correspondam a regras específicas.
  2. Monitore logs de transações: Revise regularmente os detalhes da transação para garantir que o roteamento se comporte conforme o esperado e identifique qualquer uso de fallback.
  3. Documente sua estratégia: Mantenha documentação interna explicando por que cada regra existe e a que lógica de negócios ela serve.
  4. Comece simples: Comece com o roteamento básico baseado em moeda antes de adicionar regras complexas de múltiplas condições.
  5. Revise os resultados antifraude: Quando o antifraude estiver ativado para um APM, revise regularmente os detalhes do pedido para verificar se os resultados e ações de risco estão alinhados com suas metas de prevenção de fraude.

Leve em consideração as seguintes limitações:

  • Sem cascata de APM: As transações não podem ser propagadas entre diferentes contas do APM. Cada transação é encaminhada para exatamente uma credencial.
  • Sem roteamento entre APM: Não é possível encaminhar uma ordem entre diferentes APMs.
  • E apenas lógica: Várias condições em uma regra são combinadas com AND (não OR)
  • Ordem de avaliação de regras: As regras são avaliadas por prioridade, não por data de criação
  • Efeito imediato: As alterações nas regras entram em vigor imediatamente para novas transações
  • Apenas combinações suportadas: O antifraude para APMs está disponível apenas para combinações explicitamente suportadas de APM + provedor antifraude. O administrador evita configurações não suportadas.
  • Requisito de reembolso para revisão manual: Os fluxos antifraude baseados em revisão manual exigem que o APM apoie reembolsos. Se o APM não suportar reembolsos, os fluxos de revisão manual não estarão disponíveis.