Events Reference
Framework lifecycle events and custom component events
Event System
The SDK emits lifecycle events that allow you to track component state transitions, authentication flows, and errors.
VisaAcceptance.init({
onEvent: (type, payload) => {
switch (type) {
case 'component_ready':
console.log('Component loaded:', payload.componentName);
break;
case 'component_error':
console.error('Error:', payload.error);
break;
}
},
});Framework Events
| Event | Description | Payload |
|---|---|---|
sdk_loaded | SDK script initialized | — |
component_create | Component instance created | componentName, instanceId, version |
component_mount | Component iframe inserted into DOM | componentName, instanceId, containerElement |
component_ready | Component fully loaded and interactive | componentName, instanceId, loadTime |
component_unmount | Component destroyed | componentName, instanceId |
component_error | Component encountered an error | error, componentName, instanceId |
auth_required | Authentication needed | reason, componentName, instanceId |
auth_complete | Authentication succeeded | componentName, instanceId, authDuration |
auth_timeout | Authentication timed out | componentName, instanceId, timeout |
auth_token_refresh_start | Token refresh initiated | — |
auth_token_refresh_complete | Token refresh succeeded | — |
auth_token_refresh_failed | Token refresh failed after all attempts | — |
Event Payload Types
ComponentReadyEvent
Prop
Type
ComponentErrorEvent
Prop
Type
AuthRequiredEvent
Prop
Type
Error Handling
When a component_error event fires, the payload contains a ComponentError object. See the Error Codes reference for the full error code table and recovery patterns.