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 y Payment Widget
iOS, Android | Cuándo se dispara? | Metadata |
---|---|---|
purchaseRejected | Cuando al dar click en pagar ocurre un error. | { metadata: { code: string, reason: string } } |
paymentProcessing | Cuando se esta procesando el pago y se esta mostrando la vista correspondiente | |
purchaseError | Cuando un APM termina en payment uno de estos estados: denied, cancelled. | |
purchase | El pago se realizo de forma exitosa | |
apmSuccess | Cuando se logra completar una transaccion con un APM/ | |
apmClickRedirect | Cuando se da click en el boton para redirigir manualmente a la URL del apm. | |
checkoutFailed | Cuando ocurre un error al intentar abrir el widget | |
changeAddress | Al dar click en el botón de “Cambiar” dirección de entrega | |
changeCart | Evento disparado al dar click en "Editar Carrito". | |
paymentMethods3dsInitiated | Cuando al pagar se genera challenge URL de 3DS. | |
paymentClick | El usuario da click al botón de pagar en el widget de pagos | |
paymentMethodsCardNumberInitiated | Cuando el usuario da clic en el campo para ingresar el número de la tarjeta | |
paymentMethodsEntered | Cuando se selecciona un metodo de pago. | |
paymentMethodsSelected | Cuando el usuario selecciona un método de pago | { metadata: { method_type: string, processor_name: string } } |
paymentMethodsShowMore | Cuando el usuario da clic en mas opciones (de métodos de pago) | |
linkStarted | Cuando se inicializa el link de pagos. | |
paymentMethodsStarted | Cuando se monta en la UI los metodos de pago. | |
adBlock | Cuando se verifica si el usuario está usando adblock | |
linkClose | Cuando se da click en cierre de link de pagos. | |
linkFailed | Cuando falla la carga del formulario de pago | |
paymentMethodsAddCard | Cuando el usuario da clic en agregar una nueva tarjeta | |
checkoutStarted | Cuando se muestra el widget de pagos | |
paymentMethodsCardExpirationDateInitiated | Cuando el usuario presiona en el campo para ingresar la fecha de vencimiento de la tarjeta | |
paymentMethodsCardNameInitiated | Cuando el usuario se posiciona en el input de tarjeta para poner el nombre visualizado en su tarjeta de credito. | |
paymentMethodsCardSecurityCodeInitiated | Cuando el usuario se posiciona en el input del CVV. | |
paymentMethodsCardNumberEntered | Cuando el usuario ha llenado el campo con el número de la tarjeta | |
paymentMethodsCardExpirationDateEntered | Cuando el usuario ha ingresado la fecha de vencimiento de la tarjeta | |
paymentMethodsCardSecurityCodeEntered | Cuando el usuario ha ingresado el CVV de la tarjeta | |
pointsToWinStarted | Puntos acumulados a mostrar para la compra. | |
paymentMethodsShowMyCards | Cuando el usuario da click en "Ver tarjetas guardadas". | |
benefitsStarted | Cuando hay beneficios disponibles para la compra y se muestra el contenedor para abrir beneficios. | |
donationsStarted | Cuando se carga la opcion para donaciones y se muestran en la UI las diferentes opciones. |
Eventos del Vault Widget
iOS, Android | Cuándo se dispara? | Metadata |
---|---|---|
vaultProcessing | Cuando 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. | |
vaultSaveClick | Cuando el usuario haga click en "Guardar” para almacenar la tarjeta. | |
checkoutStarted | Cuando el widget fue mostrado al usuario | |
vaultFailed | En caso de que el widget no se pueda mostrar | { errorCode: string, errorMessage: string } |
changeAddress | Cuando se da click en el botón del mapa para usar la dirección seleccionada. | |
changeCart | Evento disparado al dar click en "Editar Carrito". | |
vaultSaveError | Cuando se presenta un error al guardar la tarjeta. | { errorCode: string, errorMessage: string } |
vaultSaveSuccess | Cuando la tarjeta se guarda exitosamente | { creditCard: { bankName: string, cardId: string, company: string, firstSix: string, lastFour: string, userId: string, storedCard: boolean } } |
vaultRedirect3DS | Cuando 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 } } |
vaultClickRedirect3DS | Evento para Elements Vault que se dispara cuando ocurre una redirección al challenge 3DS. | |
paymentMethodsCardIdentityNumberInitiated | Cuando se empieza a escribir en el input de identidad del formulario de tarjetas. | |
paymentMethodsCardIdentityNumberEntered | Cuando ocurre onBlur al salir del input de identidad del formulario de tarjetas. | |
paymentMethodsCardNameInitiated | Cuando el usuario se posiciona en el input de tarjeta para poner el nombre visualizado en su tarjeta de crédito | |
paymentMethodsCardNameEntered | Cuando el usuario ha ingresado el nombre visualizado en su tarjeta de crédito | |
paymentMethodsCardSecurityCodeInitiated | Cuando el usuario se posiciona en el input del CVV. | |
paymentMethodsCardSecurityCodeEntered | Cuando el usuario ha ingresado el CVV de la tarjeta | |
paymentMethodsCardExpirationDateEntered | Cuando el usuario ha ingresado la fecha de vencimiento de la tarjeta | |
paymentMethodsCardExpirationDateInitiated | Cuando el usuario presiona en el campo para ingresar la fecha de vencimiento de la tarjeta | |
paymentMethodsCardNumberEntered | Cuando el usuario ha llenado el campo con el número de la tarjeta | |
paymentMethodsCardNumberInitiated | Cuando el usuario da clic en el campo para ingresar el número de la tarjeta |
Updated about 2 months ago