Manejo de Eventos en los SDKs de DEUNA

El manejo de eventos es crucial para el correcto funcionamiento de los SDKs de DEUNA. Los eventos te permiten gestionar y responder a las distintas acciones y estados que ocurren durante el uso del Payment Widget o del Vault Widget. A continuación, se indican los eventos disponibles para cada tipo de widget.


Eventos del Checkout Widget

iOS, AndroidCuándo se dispara?Metadata
purchaseRejectedCuando al dar click en pagar ocurre un error.{ metadata: { code: string, reason: string } }
paymentProcessingCuando se esta procesando el pago y se esta mostrando la vista correspondiente
purchaseErrorCuando un APM termina en payment uno de estos estados: denied, cancelled.
purchaseEl pago se realizo de forma exitosa
apmSuccessCuando se logra completar una transaccion con un APM/
apmClickRedirectCuando se da click en el boton para redirigir manualmente a la URL del apm.
apmFailedCuando ocurre un error al intentar redirigir a APM.
changeAddressAl dar click en el botón de “Cambiar” dirección de entrega
changeCartEvento disparado al dar click en "Editar Carrito".
paymentMethods3dsInitiatedCuando al pagar se genera challenge URL de 3DS.
paymentClickEl usuario da click al botón de pagar en el widget de pagos
paymentMethodsCardNumberInitiatedCuando el usuario da clic en el campo para ingresar el número de la tarjeta
paymentMethodsEnteredCuando se selecciona un metodo de pago.
paymentMethodsSelectedCuando el usuario selecciona un método de pago{ metadata: { method_type: string, processor_name: string } }
paymentMethodsShowMoreCuando el usuario da clic en mas opciones (de métodos de pago)
linkStartedCuando se inicializa el link de pagos.
paymentMethodsStartedCuando se monta en la UI los metodos de pago.
adBlockCuando se verifica si el usuario está usando adblock
linkCloseCuando se da click en cierre de link de pagos.
linkFailedCuando falla la carga del formulario de pago
paymentMethodsAddCardCuando el usuario da clic en agregar una nueva tarjeta
checkoutStartedCuando se muestra el widget de pagos
paymentMethodsCardExpirationDateInitiatedCuando el usuario presiona en el campo para ingresar la fecha de vencimiento de la tarjeta
paymentMethodsCardNameInitiatedCuando el usuario se posiciona en el input de tarjeta para poner el nombre visualizado en su tarjeta de credito.
paymentMethodsCardSecurityCodeInitiatedCuando el usuario se posiciona en el input del CVV.
paymentMethodsCardNumberEnteredCuando el usuario ha llenado el campo con el número de la tarjeta
paymentMethodsCardExpirationDateEnteredCuando el usuario ha ingresado la fecha de vencimiento de la tarjeta
paymentMethodsCardSecurityCodeEnteredCuando el usuario ha ingresado el CVV de la tarjeta
pointsToWinStartedPuntos acumulados a mostrar para la compra.
paymentMethodsShowMyCardsCuando el usuario da click en "Ver tarjetas guardadas".
benefitsStartedCuando hay beneficios disponibles para la compra y se muestra el contenedor para abrir beneficios.
donationsStartedCuando se carga la opcion para donaciones y se muestran en la UI las diferentes opciones.

Eventos del Vault Widget

iOS, AndroidCuándo se dispara?Metadata
vaultProcessingCuando se muestra la pantalla de procesando para guardar la tarjeta. Se puede presentar después de hacer click en guardar o después de regresar del flujo de 3DS del banco.
vaultSaveClickCuando el usuario haga click en "Guardar” para almacenar la tarjeta.
checkoutStartedCuando el widget fue mostrado al usuario
vaultFailedEn caso de que el widget no se pueda mostrar{ errorCode: string, errorMessage: string }
changeAddressCuando se da click en el botón del mapa para usar la dirección seleccionada.
changeCartEvento disparado al dar click en "Editar Carrito".
vaultSaveErrorCuando se presenta un error al guardar la tarjeta.{ errorCode: string, errorMessage: string }
vaultSaveSuccessCuando la tarjeta se guarda exitosamente{ creditCard: { bankName: string, cardId: string, company: string, firstSix: string, lastFour: string, userId: string, storedCard: boolean } }
vaultRedirect3DSCuando se muestra la vista que genera una re-dirección desde el baúl para hacer la validación de la tarjeta a través de 3DS.{ creditCard: { bankName: string, cardId: string, company: string, firstSix: string, lastFour: string, userId: string } }
vaultClickRedirect3DSEvento para Elements Vault que se dispara cuando ocurre una redirección al challenge 3DS.
paymentMethodsCardIdentityNumberInitiatedCuando se empieza a escribir en el input de identidad del formulario de tarjetas.
paymentMethodsCardIdentityNumberEnteredCuando ocurre onBlur al salir del input de identidad del formulario de tarjetas.
paymentMethodsCardNameInitiatedCuando el usuario se posiciona en el input de tarjeta para poner el nombre visualizado en su tarjeta de crédito
paymentMethodsCardNameEnteredCuando el usuario ha ingresado el nombre visualizado en su tarjeta de crédito
paymentMethodsCardSecurityCodeInitiatedCuando el usuario se posiciona en el input del CVV.
paymentMethodsCardSecurityCodeEnteredCuando el usuario ha ingresado el CVV de la tarjeta
paymentMethodsCardExpirationDateEnteredCuando el usuario ha ingresado la fecha de vencimiento de la tarjeta
paymentMethodsCardExpirationDateInitiatedCuando el usuario presiona en el campo para ingresar la fecha de vencimiento de la tarjeta
paymentMethodsCardNumberEnteredCuando el usuario ha llenado el campo con el número de la tarjeta
paymentMethodsCardNumberInitiatedCuando el usuario da clic en el campo para ingresar el número de la tarjeta