Saltar al contenido principal
Todos los sistemas operativosNovedadesv1
Iniciar sesión

enrutamiento APM

En esta página

APM Routing le permite dirigir transacciones automáticamente a la cuenta de método de pago alternativo (APM) correcta según reglas inteligentes.

Disponibilidad actual El enrutamiento APM está disponible para los flujos de pago de billetera y transferencia bancaria. Los flujos de voucher, BNPL, efectivo, POS y pago de referencia no se enrutan a través de esta capacidad. La disponibilidad aún depende de la conexión APM y de las reglas configuradas.

Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.
Producción
Estrategias de pago

Enrutamiento APM

Selecciona la credencial del proveedor que corresponda al contexto del pago.

Acme LATAM · Producción
ConfiguraciónEnrutamiento APM
Activa
Credencial del proveedor
EnrutamientoPayPal · USD primary

¿Qué es el enrutamiento APM?#

APM Routing es esencial para los comerciantes que operan con múltiples cuentas para el mismo proveedor de APM, que generalmente están segmentadas por moneda, país o monto de la transacción.

Si procesa transacciones de PayPal tanto en MXN como en USD, es probable que tenga credenciales de PayPal independientes para cada moneda. APM Routing garantiza que cada transacción utilice automáticamente la cuenta correcta sin intervención manual.

Cómo funciona#

Cuando un cliente inicia una transacción, el motor de enrutamiento de DEUNA evalúa sus reglas configuradas en tiempo real y selecciona la credencial APM adecuada según el contexto de la transacción (moneda, país, monto).

Esta selección ocurre automáticamente en todos los puntos de contacto críticos:

  • Recuperación del método de pago (GET /payment-methods) — Devuelve la credencial correcta para la inicialización del frontend
  • Flujo de consentimiento (/consent) — Garantiza la selección adecuada de la cuenta.
  • Procesamiento de pago final — Enruta la transacción a la cuenta coincidente

El sistema sigue una resolución basada en prioridades: las reglas específicas se evalúan primero, seguidas de su configuración predeterminada si ninguna regla coincide.

Configurar el enrutamiento APM#

Configurar el enrutamiento APM en DEUNA Admin es sencillo:

Paso 1: conecte sus credenciales de APM

  1. Inicie sesión en Deuna Admin.
  2. Navegue a Métodos de pago.
  3. Conecte su primera credencial APM.
    • Esto automáticamente se convierte en tu predeterminado credential.
    • Se crea automáticamente una estrategia de pago predeterminada.
  4. Agregue credenciales adicionales para el mismo APM según sea necesario.

Paso 2: crear reglas de enrutamiento

  1. Navegue a clasificadas.
  2. Haga clic en el APM tab.
  3. Clic Crear nueva regla.
  4. Defina sus condiciones de ruta:
    • Moneda: Enrutamiento en moneda de transacción.
    • País: País donde ocurre la transacción.
    • Monto: Ruta basada en el valor de la transacción.
  5. Seleccione qué credencial de APM debe manejar transacciones coincidentes.
  6. Nombra la regla de enrutamiento
  7. Establezca la prioridad de enrutamiento.
  8. guardar la regla

Condiciones de regla disponibles:

  • Moneda
  • País
  • Monto

Puede combinar varias condiciones en una sola regla utilizando la lógica AND. Por ejemplo: "Moneda = USD Y País = EE.UU. Y Importe > 100".

Paso 3: gestionar las prioridades de las reglas

Las reglas se evalúan en orden de prioridad de mayor a menor:

  1. En clasificadas, ve al APM section.
  2. Vea su tabla de reglas.
  3. Arrastre y suelte reglas para reordenar la prioridad.
  4. Las reglas en la parte superior se evalúan primero.
  5. Si no coincide ninguna regla específica, se utiliza la credencial predeterminada.

Evaluación antifraude para APM#

DEUNA apoya un paso de evaluación antifraude previo a APM que permite a los comerciantes evaluar las transacciones de APM en busca de riesgo de fraude antes el pago se envía al proveedor de APM. Esta capacidad brinda el mismo nivel de protección contra fraude disponible para los flujos de tarjetas basadas en PSP a métodos de pago alternativos.

¿Por qué antifraude para las APM?

Algunas APM, como PayPal, aún pueden generar pérdidas por fraude, disputas o devoluciones de cargo. Los comerciantes que quieran tener más control sobre estos flujos ahora pueden configurar un proveedor antifraude para evaluar la transacción antes de que llegue al APM. Esto garantiza que las transacciones riesgosas se bloqueen temprano, reduciendo la exposición a pérdidas relacionadas con el fraude.

Cómo funciona

Cuando el antifraude está habilitado para un flujo APM compatible, DEUNA agrega un paso de orquestación previo a APM al flujo de pago:

  1. El cliente inicia un pago utilizando un APM compatible (por ejemplo, PayPal).
  2. DEUNA evalúa la transacción a través del proveedor antifraude configurado antes enviándolo a la APM.
  3. El proveedor antifraude devuelve una evaluación de riesgos.
  4. DEUNA normaliza la respuesta en un resultado de riesgo estandarizado: Bajo riesgo, Riesgo medioo Alto riesgo.
  5. DEUNA aplica la acción configurada por el comerciante para ese nivel de riesgo:
    • Permitir (Ruta): La transacción continúa hasta el APM para el procesamiento del pago.
    • Rechazar (Bloquear): DEUNA detiene la transacción antes de que llegue al APM.
  6. Si la acción es Permitir, el pago se realiza al APM conservando la carga útil específica del APM correcta.

Configurar antifraude para APM#

Paso 1: conecte su proveedor antifraude

  1. Inicie sesión en Administrador DEUNA.
  2. Navegue a Conexiones.
  3. Seleccione y configure el proveedor antifraude que desea utilizar para la evaluación de APM (por ejemplo, Cybersource o Riskified).
  4. Siga las instrucciones de configuración específicas del proveedor en la Motores anti-fraude documentation.

Paso 2: Configurar la regla antifraude APM+ en Estrategias

  1. En el administrador de DEUNA, navegue hasta clasificadas.
  2. Ir al APM tab.
  3. Cree o edite una regla de enrutamiento para el APM admitido (por ejemplo, PayPal).
  4. Habilite la evaluación antifraude para la regla y seleccione el proveedor antifraude.
  5. Configure la acción para cada resultado de riesgo normalizado:
    • Bajo Riesgo: Permitir o bloquear
    • Riesgo Medio: Permitir o bloquear
    • Alto Riesgo: Permitir o bloquear
  6. Guarde la regla.

Paso 3: Verificar en los detalles del pedido

Después de procesar las transacciones, verifique que la evaluación antifraude esté funcionando correctamente:

  1. Navegue a Transacciones > Detalles del pedido.
  2. Confirme que la siguiente información esté visible:
    • Si la lucha contra el fraude se ejecutó antes de la APM.
    • Qué proveedor antifraude se utilizó.
    • El resultado del riesgo normalizado (Bajo / Medio / Alto).
    • La acción que DEUNA aplicó (Permitir o Bloquear).
    • El momento de ejecución de la medida antifraude.

Las transacciones bloqueadas por el sistema antifraude se distinguen claramente de las transacciones rechazadas o fallidas en la capa APM.

Visibilidad de las transacciones#

Cada transacción procesada a través del enrutamiento APM (con o sin antifraude) incluye trazabilidad completa.

Trazabilidad de ruta

  1. En Transacciones, ve a Detalles de la transacción.
  2. Vea la solicitud y respuesta JSON.
  3. Vea qué regla de enrutamiento se aplicó.
  4. Identifique el nombre específico del procesador de pagos del comerciante utilizado.

Trazabilidad antifraude

Cuando el antifraude está habilitado para un flujo de APM, el detalle del pedido incluye:

  • Proveedor antifraude utilizado para la evaluación.
  • Resultado de riesgo normalizado (Riesgo Bajo, Riesgo Medio o Riesgo Alto).
  • Acción aplicada por DEUNA (Permitir o Bloquear).

Eventos de visibilidad de transacciones

DEUNA genera los siguientes eventos de visibilidad de transacciones para los flujos antifraude de APM:

EventoDescripción
tv_fraud_analysisSe genera cuando se completa la evaluación antifraude. el response_data La carga útil incluye el identificador de APM y el nombre de APM asociados con la transacción, lo que indica claramente qué método de pago alternativo se evaluó.
tv_antifraud_unavailableSe genera cuando el proveedor antifraude no responde, se agota el tiempo de espera o falla con un error técnico. Incluye el motivo del fallo.

Administrar credenciales de APM#

Administrar credenciales APM en DEUNA.

Cambiar el APM predeterminado

  1. En clasificadas, ve al APM section.
  2. Localice la credencial que desea establecer como credencial predeterminada.
  3. Clic Establecer como predeterminado.

Eliminar una credencial

Al eliminar una credencial APM:

  • Si es el predeterminado: Seleccione una nueva credencial predeterminada
  • Si se usa en reglas activas:
    • Desactiva las reglas asociadas.
    • Reasigne las reglas a una credencial diferente.

Esto evita la interrupción accidental de su ruta de pago.

Gestión de reglas#

DEUNA Admin proporciona control total sobre sus reglas de enrutamiento:

Acciones de regla:

  • crear: Definir nuevas reglas de enrutamiento
  • Editar: Modificar condiciones o asignaciones de reglas existentes
  • Inactivar: Deshabilitar temporalmente las reglas sin eliminarlas
  • Guardar como borrador: Prepare reglas antes de activarlas

Visibilidad de la regla:

Todas las reglas se muestran en una tabla completa que muestra:

  • Prioridad
  • Nombre de la regla
  • Fecha de creación
  • Proveedor APM
  • Estado (activo/inactivo/borrador)

Casos de uso comunes#

Conozca los casos de uso comunes para el enrutamiento APM en DEUNA.

Caso de uso 1: enrutamiento basado en moneda

Escenario: Procesas transacciones de PayPal tanto en MXN como en USD con cuentas separadas.

Configuración:

  1. Conecte la credencial MXN de PayPal (establecida como predeterminada).
  2. Conecte la credencial USD de PayPal.
  3. Crear regla:
    1. "Moneda = USD"
    2. Ruta a PayPal USD
  4. La regla predeterminada maneja automáticamente las transacciones MXN.

Las transacciones en USD utilizan automáticamente las credenciales en USD de PayPal, mientras que las transacciones en MXN utilizan las credenciales MXN de PayPal.

Caso de uso 2: enrutamiento específico de un país

Escenario: Tienes diferentes cuentas de PayPal para México y Estados Unidos.

Configuración:

  1. Crear regla: "País = EE. UU." para enrutar a PayPal EE. UU.
  2. Crear regla: "País = MX" tp ruta a PayPal MX
  3. Establecer uno como predeterminado para otros países

Resultado: Las transacciones de cada país se dirigen a la cuenta regional correspondiente.

Caso de uso 3: rechazar transacciones específicas

Escenario: Quiere rechazar pedidos en USD sin procesarlos.

Configuración:

  1. Cree una regla: "Moneda = USD" para establecerla en Rechazar.
  2. La regla predeterminada maneja todas las demás monedas normalmente.

Resultado: Las transacciones en USD se rechazan automáticamente antes de procesarse, mientras que otras monedas proceden normalmente.

Caso de uso 4: Evaluación antifraude previa a APM

Escenario: Desea evaluar las transacciones de PayPal a través de un proveedor antifraude (por ejemplo, Cybersource) antes de enviarlas a PayPal, de modo que las transacciones de alto riesgo se bloqueen antes de la ejecución del pago.

Configuración:

  1. Conecte sus credenciales antifraude en Conexiones.
  2. Navegue a clasificadas > APM.
  3. Cree una regla de enrutamiento.
  4. Habilite la evaluación antifraude y seleccione antifraude (por ejemplo, Cybersource) como proveedor.
  5. Configurar acciones de riesgo:
    • Bajo Riesgo: Permitir ej. billetera paypal
    • Riesgo Medio: Permitir -> Ej. billetera paypal
    • Alto Riesgo: Bloquear
  6. Guarde la regla.

Resultado: Cybersource evalúa cada transacción de PayPal antes de llegar a PayPal. Las transacciones de riesgo bajo y medio se desarrollan normalmente, mientras que las transacciones de alto riesgo están bloqueadas. El detalle del pedido muestra el resultado de la evaluación antifraude y la acción aplicada.

Mejores prácticas y limitaciones#

  1. Configure siempre un valor predeterminado: Asegúrese de que cada APM tenga una credencial predeterminada para manejar transacciones que no coincidan con reglas específicas.
  2. Supervisar registros de transacciones: Revise periódicamente los detalles de la transacción para garantizar que el enrutamiento se comporte según lo esperado e identifique cualquier uso alternativo.
  3. Documente su estrategia: Mantenga documentación interna que explique por qué existe cada regla y para qué lógica empresarial sirve.
  4. Empiece de forma sencilla: Comience con enrutamiento básico basado en moneda antes de agregar reglas complejas de múltiples condiciones.
  5. Revisar los resultados antifraude: Cuando la función antifraude esté habilitada para un APM, revise periódicamente los detalles del pedido para verificar que los resultados y las acciones de riesgo estén alineados con sus objetivos de prevención de fraude.

Tenga en cuenta las siguientes limitaciones:

  • Sin cascada APM: Las transacciones no pueden realizarse en cascada entre diferentes cuentas de APM. Cada transacción se dirige a exactamente una credencial.
  • Sin enrutamiento cruzado APM: No es posible enrutar una orden entre diferentes APM.
  • Y solo lógica: Varias condiciones en una regla se combinan con AND (no OR)
  • Orden de evaluación de reglas: Las reglas se evalúan por prioridad, no por fecha de creación.
  • Efecto inmediato: Los cambios de reglas entran en vigor inmediatamente para nuevas transacciones
  • Combinaciones admitidas únicamente: El antifraude para APM solo está disponible para combinaciones de APM + proveedor antifraude admitidos explícitamente. El administrador evita configuraciones no compatibles.
  • Requisito de reembolso por revisión manual: Los flujos antifraude basados en revisión manual requieren que el APM admita reembolsos. Si el APM no admite reembolsos, los flujos de revisión manual no están disponibles.