Configuración general de widgets

Las siguientes configuraciones le permiten personalizar el comportamiento y la apariencia del pago para satisfacer las necesidades específicas de cada comerciante.

Idioma#

El idioma de la interfaz de pago se configura automáticamente según el país en el que opera su empresa.

Esta configuración tiene como objetivo garantizar una experiencia localizada para los compradores, reduciendo la fricción y mejorando las tasas de conversión.

• El lenguaje se define mediante la tokenización de órdenes.
• El idioma se puede especificar dinámicamente para cada pedido.

URL base#

Si desea personalizar una URL base específica para sus enlaces de pago, puede solicitarla a nuestro equipo de soporte. Esta personalización le permite adaptar la experiencia a la identidad de su marca.

Ejemplo: https://payhere.yourbrand.deuna.com

Habilitar la autenticación de usuario#

DEUNA te permite configurar si tus compradores completan el pago como invitados o como usuarios autenticados, con acceso a sus tarjetas guardadas y datos de compras anteriores. Este comportamiento está controlado por dos variables:

Ambas variables se configuran dentro widgets_general_config.user_experience al crear o actualizar su configuración de comerciante:

{
  "widgets_general_config": {
    "user_experience": {
      "user_authentication_flow": true,
      "init_with_guest_user": false
    }
  }
}

¿Cómo se decide si un usuario ve el flujo autenticado?

si estableces user_authentication_flow: true, DEUNA determina qué usuario mostrar (y por tanto, qué tarjetas guardadas) siguiendo un orden de prioridad. Un valor definido en un nivel superior. siempre anula los niveles debajo de él:

Ejemplo: inicialización con un userToken:

deunaSDK.initElements({
  orderToken: "YOUR_ORDER_TOKEN",
  userToken: "YOUR_USER_TOKEN", // overrides merchant config and order email
  // ...other initialization parameters
});

Anulación en la inicialización: onlyCardEnrollment

Parámetros enviados al interior. behavior al inicializar el WebSDK le permite anular ciertos flujos definidos en la configuración de su comerciante, sin cambiar esa configuración en sí.

onlyCardEnrollment Oculta las tarjetas guardadas de un usuario autenticado, permitiendo sólo el registro de una nueva tarjeta. Esto se recomienda cuando el comerciante gestiona la visualización de las tarjetas guardadas del usuario desde su propia interfaz de usuario y solo necesita que DEUNA maneje el formulario de inscripción de la tarjeta.

onlyCardEnrollment anula el resultado de la tabla de prioridades anterior: incluso si un userToken o un activo user_authentication_flow normalmente mostraría tarjetas guardadas, esta bandera las obliga a permanecer ocultas durante esa sesión.

Ejemplo: configuración del WebSDK del widget de Vault:

await DeunaSDK.initElements({
  orderToken: "<ORDER_TOKEN>",
  userToken: "<AUTHENTICATION_TOKEN>",
  userInfo: { /* ... */ },
  behavior: {
    onlyCardEnrollment: true,
    // ...other behavior overrides
  },
  callbacks: { /* ... */ },
  },
});

Habilitar ahorro de tarjeta#

Además de decidir si un usuario realiza el pago como invitado o como usuario autenticado, puede configurar cómo se comporta el ahorro de tarjeta durante el pago.

Ambas variables también se configuran dentro widgets_general_config.user_experience:

{
  "widgets_general_config": {
    "user_experience": {
      "show_saved_cards_flow": true,
      "default_card_flow": true
    }
  }
}

Habilitar ahorro de tarjeta#

Es posible mostrar una casilla de verificación que permite al comprador decidir si desea guardar su tarjeta al momento de pagar. Esta opción es útil en flujos de invitados.

El comportamiento predeterminado es no mostrar la casilla de verificación y guardar automáticamente la tarjeta para mejorar la conversión.

Ampliar

Permitir eliminación de tarjeta#

Controla si los compradores pueden eliminar tarjetas guardadas en el Widget de bóveda. Recomendado para modelos de suscripción y facturación recurrente para evitar la eliminación accidental de métodos de pago y la cancelación involuntaria.

Configurar dentro widgets_general_config.user_experience:

{
  "widgets_general_config": {
    "user_experience": {
      "allow_card_deletion": false
    }
  }
}

Comportamiento de la interfaz de usuario

Estilos visuales#

Personaliza tu widget usando CustomStyle.

Adapta la experiencia visual de tus clientes a las directrices de tu marca.