Widget de Acción Siguiente
Continúe un pedido pendiente de DEUNA a través de 3DS u otra acción requerida del cliente en la Web, iOS, Android y React Native.
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#
order_token; do not create another order.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:
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(),
},
});await deunaSDK.initNextAction({
orderToken,
mode: 'modal',
callbacks: {
onSuccess: verifyOriginalOrder,
onError: recoverAfterVerification,
onClosed: recoverAfterVerification,
},
});let callbacks = NextActionCallbacks()
callbacks.onSuccess = { _ in verifyOriginalOrder() }
callbacks.onError = { error in recoverAfterVerification(error) }
callbacks.onClosed = { _ in recoverAfterVerification(nil) }
deunaSDK.initNextAction(
orderToken: orderToken,
callbacks: callbacks,
language: "en"
)val callbacks = NextActionCallbacks().apply {
onSuccess = { verifyOriginalOrder() }
onError = { error -> recoverAfterVerification(error) }
onClosed = { recoverAfterVerification(null) }
}
deunaSDK.initNextAction(
context = this,
orderToken = orderToken,
callbacks = callbacks,
language = "en"
)Parámetros#
| Parámetro | Plataformas | Requerido | Propósito |
|---|---|---|---|
orderToken | Todos | Sí | Token original del pedido pendiente de acción del cliente. |
callbacks | Todos | Sí | Soporte para los manejadores de éxito, error, cierre, evento y redimensionamiento según el contrato base de callback. |
language | Todos | No | Localiza la experiencia alojada. |
mode | Reaccionar nativo | Sí | Seleccionar la presentación modal o integrada compatible. |
fraudCredentials | Nativo + React Native | No | Solo para una integración de datos de dispositivo configurada. |
customUserAgent | iOS + Android | No | Override de agente de usuario de WebView aprobado. |
domain | Todos | No | Override del entorno controlado; omitir en el uso normal de producción. |
Manejar cada resultado#
| Resultado | Qué significa | Acción correcta |
|---|---|---|
onSuccess | Se ha completado el paso para el cliente. | Obtener el pedido original y renderizarlo desde su estado actual. |
onError | El 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. |
onClosed | El 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ón | No 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ón | Comportamiento | Callback / evento |
|---|---|---|
| El pago pasa a la vista 3DS | Se muestra la vista integrada 3DS, o el usuario es redirigido a otra pestaña. | evento paymentMethods3dsInitiated. |
| Carga del iframe | El desafío 3DS continúa normalmente | No se requiere acción adicional del comerciante |
| Cambiar método de pago | La experiencia actual se abandona después de la confirmación | evento apmCancelPayment. |
| Desafío completado | Continúa el flujo normal de Next Action | callback onSuccess / evento purchase / resultado correspondiente |
| Desafío denegado / expirado | Desafí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.