Log In


Emitted when an EBT Element’s value changes.

The change EBT Element event object contains an additional complete field. The complete value is a boolean that indicates whether the EBT element contains a valid input.

  type: 'change',
  usecase: 'collect_pin',
  complete: true,
  error: null

Listen for error

Listen for an error value on the change event object to display input validation errors to the user.


Display a message if there’s an event.error on change

balanceElement.on('change', (event) => {
  const explainErrorSpan = document.getElementById('explain-error')
  if (event.error) {
    // show validation error to customer
    explainErrorSpan.textContent = event.error.message
  } else {
    // hide validation error
    explainErrorSpan.textContent = ''

Listen for complete

Listen for the complete value on the change event object to change the UI when an input value is ready to submit.


Enable a submit button if event.complete on change is true

balanceElement.on('change', (event) => {
  const submitBalanceCheckBtn = document.getElementById('submit-balance-btn')
  if (event.complete) {
    // enable submit button