Saltar al contenido principal
En esta página

Utilice el Widget de Acción Siguiente cuando un pedido existente requiere que el cliente complete un paso adicional, como un desafío 3DS o una redirección. Reutilice el token de pedido original.

Para 3DS, la experiencia devuelta puede recopilar primero señales del navegador y del dispositivo y luego continuar sin un desafío o mostrar el desafío del emisor. Una pantalla de carga no significa que el cliente deba autenticarse manualmente. Mantén el widget montado mientras gestiona el flujo y verifica el pedido original después de un callback o retorno. Consulta el Flujo de compra de 3DS para conocer las etapas y los resultados del pago.

Flujo de decisión#

Diagrama de flujo
NoSíÉxitoError o cierre1Crea o envía el pago2¿Se devolvió unasiguiente acción?3Gestiona el estadoactual del pedido4Abre Next Action conel mismo token depedido5Resultado del widget6Concilia el pedidoen el backend7Consulta el estadoantes de reintentar8Completa la entregasolo desde un estadofinal verificado
ResultadoRevisión o pendiente
01 · response
Detecte la acción requerida
Utilice la respuesta de pago o el estado del pedido documentado.
02 · SDK
Abra el Widget de Acción Siguiente
Pase el original order_token; do not create another order.
03 · customer
Continuar la autenticación
Permite que terminen las comprobaciones del navegador y presenta un desafío del emisor solo cuando sea necesario. Conserva el funcionamiento de redirecciones, ventanas emergentes y el retorno a la aplicación.
04 · backend
Verifica el resultado
Obtener el pedido o consumir un webhook verificado.

Ver la experiencia del cliente#

Next Action funciona tanto con los widgets de pago de DEUNA como con formularios de pago propios del comercio. Después de que tu backend envíe el pago, abre Next Action solo cuando la respuesta indique que el cliente debe completar otro paso. El widget presenta el desafío 3DS compatible o la redirección a un método de pago alternativo (APM), y comunica el resultado mediante sus callbacks.

El siguiente recorrido muestra cómo continúa la experiencia desde el checkout del comercio hasta la acción posterior al pago requerida:

Next Action presenta el paso que el cliente debe completar después de iniciar el pago. Ver el video directamente en YouTube si el reproductor integrado no está disponible.

El video muestra la transición que experimenta el cliente. Tu integración debe seguir usando la respuesta del pago, los callbacks y la conciliación del backend que se describen a continuación; no deduzcas el estado final del pago a partir de lo que el cliente ve en el widget.

Abra el Widget de Acción Siguiente#

await DeunaSDK.initNextAction({
  orderToken,
  callbacks: {
    onSuccess: () => verifyOriginalOrder(),
    onError: (error) => recoverAfterVerification(error),
    onClosed: () => recoverAfterVerification(),
  },
});

Parámetros#

ParámetroPlataformasRequeridoPropósito
orderTokenTodosSíToken original del pedido pendiente de acción del cliente.
callbacksTodosSíSoporte para los manejadores de éxito, error, cierre, evento y redimensionamiento según el contrato base de callback.
languageTodosNoLocaliza la experiencia alojada.
modeReaccionar nativoSíSeleccionar la presentación modal o integrada compatible.
fraudCredentialsNativo + React NativeNoSolo para una integración de datos de dispositivo configurada.
customUserAgentiOS + AndroidNoOverride de agente de usuario de WebView aprobado.
domainTodosNoOverride del entorno controlado; omitir en el uso normal de producción.

Manejar cada resultado#

ResultadoQué significaAcción correcta
onSuccessSe ha completado el paso para el cliente.Obtener el pedido original y renderizarlo desde su estado actual.
onErrorEl SDK o el desafío informan de un error normalizado.Registrar metadatos seguros, obtener el estado y, a continuación, ofrecer un reintento válido.
onClosedEl cliente o el SDK han cerrado la experiencia.Considerar como ambiguo hasta que se conozca el estado del backend.
Tiempo de espera o interrupción de la aplicaciónNo se ha alcanzado un resultado fiable del cliente.Reconciliar desde el backend; no volver a enviar automáticamente.

Requisitos de redireccionamiento y ventanas emergentes#

  • Permitir que el SDK abra la superficie de autenticación externa compatible.
  • Mantener el estado del ciclo de vida de la aplicación mientras el cliente abandona y regresa.
  • En Web, abrir desde una acción del cliente y no "sandboxear" el widget de forma que bloquee ventanas emergentes o la navegación de nivel superior.
  • En React Native, mantener el renderizador del SDK montado mientras está activa su control de redirección externo.
  • En iOS y Android, utilizar el modal o componente integrado del SDK en lugar de recrear el puente de WebView interno.
  • Probar desafíos exitosos, rechazo, cancelación del cliente, tiempo de espera del emisor, pérdida de red y retorno desde el fondo.

Presentación integrada#

El SDK de Web soporta mode: 'target' más target; iOS y Android exponen componentes de widget integrados; React Native utiliza su DeunaWidget renderizador. Reservar suficiente altura inicial, responder a los cambios de tamaño y asegurarse de que el host no oculte los controles del desafío detrás de un pie de página pegado o un teclado en pantalla.

Respaldo de carga del iframe 3DS#

Cuando DEUNA presenta un desafío 3DS dentro de un iframe, Next Action monitorea el estado de carga de la vista del emisor.

  • Si el iframe se carga correctamente dentro de los primeros 5 segundos, el flujo continúa normalmente y no se muestran acciones de recuperación adicionales.
  • Si la vista no termina de cargar después de 5 segundos, el ¿Falló la carga de la vista? aparece la opción.

Al expandirse, el comprador puede:

  • Recargar vista: reintenta cargar el desafío 3DS.
  • Cambiar método de pago: permite al comprador abandonar el desafío actual y seleccionar otro método de pago, después de confirmar la acción.

Si el iframe termina de cargar mientras el respaldo es visible, las opciones de recuperación se ocultan automáticamente y el comprador puede continuar con el desafío.

Comportamiento de integración

acciónComportamientoCallback / evento
El pago pasa a la vista 3DSSe muestra la vista integrada 3DS, o el usuario es redirigido a otra pestaña.evento paymentMethods3dsInitiated.
Carga del iframeEl desafío 3DS continúa normalmenteNo se requiere acción adicional del comerciante
Cambiar método de pagoLa experiencia actual se abandona después de la confirmaciónevento apmCancelPayment.
Desafío completadoContinúa el flujo normal de Next Actioncallback onSuccess / evento purchase / resultado correspondiente
Desafío denegado / expiradoDesafío denegado en la redirección, el flujo termina aquí.evento purchaseError / callback onError

El comerciante debe continuar usando los callbacks de Next Action y el estado autoritativo del pedido para determinar el resultado final del pago.