Events allow you to manage and respond to the various actions and states that occur while using the widgets.
Event handling is crucial for the proper functioning of DEUNA SDKs.
Events in Checkout and Payment widgets
| iOS, Android | Trigger | Metadata |
|---|---|---|
| purchaseRejected | Error after a click. | { metadata: { code: string, reason: string } } |
| paymentProcessing | When the payment is being processed and the corresponding view is displayed | |
| purchaseError | When an APM payment gets the states denied or canceled | |
| purchase | The payment was made successfully | |
| apmSuccess | When a transaction is completed with an APM. | |
| apmClickRedirect | When the button is clicked to manually redirect to the apm URL. | |
| checkoutFailed | When an error occurs on trying to open the widget. | |
| changeAddress | By clicking on Change delivery address. | |
| changeCart | Click Edit Cart. | |
| paymentMethods3dsInitiated | When paying, the 3DS challenge URL is generated. | |
| paymentClick | The user clicks the pay button in the Payment widget. | |
| paymentMethodsCardNumberInitiated | When the user clicks on the field to enter the card number. | |
| paymentMethodsEntered | When you select a payment method. | |
| paymentMethodsSelected | When the user selects a payment method. | { metadata: { method_type: string, processor_name: string } } |
| paymentMethodsShowMore | When the user clicks on more options (payment methods). | |
| linkStarted | When the payment link is initialized. | |
| paymentMethodsStarted | When the payment methods are mounted in the UI. | |
| adBlock | Verifies if an ad blocker is used. | |
| linkClose | Click on closing the payment link. | |
| linkFailed | Payment form loading fails. | |
| paymentMethodsAddCard | User clicks to add a new card. | |
| checkoutStarted | Payment widget is displayed. | |
| paymentMethodsCardExpirationDateInitiated | User presses on the field to enter the card expiration date. | |
| paymentMethodsCardNameInitiated | User positions himself at the card input to enter the name displayed on his credit card. | |
| paymentMethodsCardSecurityCodeInitiated | User positions himself at the CVV input. | |
| paymentMethodsCardNumberEntered | User has filled out the field with the card number. | |
| paymentMethodsCardExpirationDateEntered | User has entered the card expiration date. | |
| paymentMethodsCardSecurityCodeEntered | User has entered the CVV of the card. | |
| pointsToWinStarted | Accumulated points to show for the purchase. | |
| paymentMethodsShowMyCards | User clicks View saved cards. | |
| benefitsStarted | Benefits are available for purchase and the container to open benefits is displayed. | |
| donationsStarted | Option for donations is loaded and the different options are displayed in the UI. |
Card vault events
| iOS, Android | Trigger | Metadata |
|---|---|---|
| vaultProcessing | When the processing screen to save the card is displayed. It can be presented after clicking save or after returning from the bank's 3DS flow. | |
| vaultSaveClick | When the user clicks Save to store the card. | |
| checkoutStarted | When the widget was shown to the user | |
| vaultFailed | The widget cannot be displayed | { errorCode: string, errorMessage: string } |
| changeAddress | When you click on the map button to use the selected address. | |
| changeCart | Event triggered when clicking Edit Cart. | |
| vaultSaveError | When an error occurs while saving the card. | { errorCode: string, errorMessage: string } |
| vaultSaveSuccess | When the card is saved successfully | { creditCard: { bankName: string, cardId: string, company: string, firstSix: string, lastFour: string, userId: string, storedCard: boolean } } |
| vaultRedirect3DS | When the view is shown it generates a re-direction from the trunk to validate the card through 3DS. | { creditCard: { bankName: string, cardId: string, company: string, firstSix: string, lastFour: string, userId: string } } |
| vaultClickRedirect3DS | Event for Elements Vault that is triggered when a redirection to the 3DS challenge occurs. | |
| paymentMethodsCardIdentityNumberInitiated | When you start writing in the identity input of the card form. | |
| paymentMethodsCardIdentityNumberEntered | When onBlur occurs on exiting the card form identity input. | |
| paymentMethodsCardNameInitiated | When the user positions himself at the card input to enter the name displayed on his credit card | |
| paymentMethodsCardNameEntered | When the user has entered the name displayed on their credit card | |
| paymentMethodsCardSecurityCodeInitiated | When the user positions himself at the CVV input. | |
| paymentMethodsCardSecurityCodeEntered | When the user has entered the CVV of the card | |
| paymentMethodsCardExpirationDateEntered | When the user has entered the card expiration date | |
| paymentMethodsCardExpirationDateInitiated | When the user presses on the field to enter the card expiration date | |
| paymentMethodsCardNumberEntered | When the user has filled out the field with the card number | |
| paymentMethodsCardNumberInitiated | When the user clicks on the field to enter the card number |