EWA Eligibility Update

earned-wage-access.customer-eligibility-updated

This event occurs when a Customer’s Earned Wage Access (EWA) eligibility status is updated.

Payload Object

string (UUID)

Event ID.

type

string

Event type. Value is earned-wage-access.customer-eligibility-updated.

createdAt

string (date-time)

Date and time the event occurred.

data

object

Data related to the event.

eventId

string (UUID)

ID of the event.

createdAt

string (date-time)

Date and time the event was created.

externalCustomerId

string

Your organization’s Earned Wage Access (EWA) reference number for the employee.

status

string enum, values: NEW, ELIGIBLE, INELIGIBLE, ARREARS, BAD_DEBT, DISABLED

Customer’s current eligibility status for the Earned Wage Access (EWA) program. The following values are supported:

NEW An EWA Customer Profile has been created for the Customer. This is the default value when a Customer is created or onboarded to an EWA Program.
ELIGIBLE The EWA Customer Profile has access to an EWA Program and can be used to disburse funds.
INELIGIBLE The EWA Customer Profile is no longer able to access the EWA Program. Funds will not be disbursed but recovery will still be attempted.
ARREARS The latest recovery attempt for the EWA Customer Profile was not processed successfully. Funds will not be disbursed.
BAD_DEBT Several recovery attempts for the EWA Customer Profile have failed and funds are no longer expected to be recovered. Funds will not be disbursed or recovered.
DISABLED The EWA Customer Profile is no longer valid for the EWA Program.

eligibilityUpdateReason

string

Reason the Customer’s status has been updated.

Sample Payload Object

				
					{
  "id": "8e26fb88-9321-4a45-9e71-281e985d2523",
  "type": "earned-wage-access.customer-eligibility-updated",
  "createdAt": "2025-04-10T21:10:53.857Z",
  "data": {
    "eventId": "02cdd87b-fea3-42b5-b90d-c9fd9acb6a55",
    "createdAt": "2025-04-09T00:34:02.823Z",
    "externalCustomerId": "ABC-100",
    "status": "NEW",
    "eligibilityUpdateReason": "New application"
  }
}