onEvent. The Widget calls onEvent for each event. Define the callback as follows:
onEvent definition example
function onEvent(eventName, metadata) {
// use eventName and metadata
}
eventName identifies the event that triggered the callback. metadata contains information about the emitted event. Check each metadata attribute for null before using it.
The following metadata attribute is documented:
| Attribute | Description |
|---|---|
timestamp | Unix timestamp in milliseconds indicating when the Widget emitted the event. |
The
metadata object can include undocumented fields. Ignore fields that your integration does not recognize.List of events
The Widget emits the following events, including events for Cobro Digital (CoDi) payments:| Event name | Description |
|---|---|
opened | The Widget emits this event when your user opens the Widget. |
on_terms_and_conditions | The Widget emits this event when your user visits the terms and conditions. |
codi_helper | The Widget emits this event when your user visits the CoDi Helper Guide. |
on_available_institutions | The Widget emits this event when your user opens the financial institution selection view. |
on_request_bank | The Widget emits this event when your user opens the view to request a new bank. |
on_authentication_form | The Widget emits this event when your user opens the financial institution authentication view. |
codi_username_required | The Widget emits this event when your user must enter their mobile phone number to receive a CoDi payment request. |
payment_in_progress | The Widget emits this event when your user must select the payment provider. |
creating_link | The Widget emits this event when the financial institution verifies the credentials and Fintoc connects the account. |
link_created | The Widget emits this event when the financial institution approves the credentials and Fintoc creates a Link. |
selecting_account | The Widget emits this event when your user opens the view to select an account. |
payment_intent_confirmation_required | The Widget emits this event when your user must authorize the payment. |
app_authentication_required | The Widget emits this event when the financial institution requires a second authentication factor through an app. |
creating_subscription | The Widget emits this event when your user starts creating a subscription. |
payment_direct_transfer | The Widget emits this event when your user views the direct transfer screen. |
device_authentication_required | The Widget emits this event when the financial institution requires a second authentication factor through a physical device. |
card_authentication_required | The Widget emits this event when the financial institution requires a second authentication factor through a coordinate card. |
sms_authentication_required | The Widget emits this event when the financial institution requires a second authentication factor by text message. |
email_authentication_required | The Widget emits this event when the financial institution requires a second authentication factor by email. |
captcha_authentication_required | The Widget emits this event when the financial institution requires a second authentication factor through a captcha. |
validating_second_factor | The Widget emits this event when the financial institution validates the second authentication factor your user entered. |
subscription_created | The Widget emits this event when Fintoc creates a subscription. |
subscription_aborted | The Widget emits this event when a constraint prevents Fintoc from completing the subscription. For example, your user may have already completed the same subscription. |
payment_created | The Widget emits this event when a payment succeeds. |
payment_error | The Widget emits this event when a payment fails. |
payment_selecting_auth | The Widget emits this event when your user selects a method for second-factor authentication. |
validating_payment | The Widget emits this event when Fintoc validates the payment. |
closed | The Widget emits this event when your user closes the Widget. |
on_error | The Widget emits this event when an error occurs in the Widget flow. |