accountsDeleted
Supported APIs:
- Generate V2 Connect Full
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when the specified accounts were deleted for the customer.
{
"customerId": "1008650161",
"eventType": "accountsDeleted",
"eventId": "1594221522744-83455a87160c45b897058b04",
"payload": {
"accounts": [
"1024371952"
]
}
} added
Supported APIs:
- Generate V2 Connect Full / Lite
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent after the customer lands on the eligible accounts page, and selects the accounts they want to submit for their loan. The accounts are saved in the account’s resource associated with the customer.
Note: If the institution is an OAuth connection, the ouath parameter value is true.
{
"customerId": "1017101354",
"eventType": "added",
"eventId": "1611877956869-28ebb24c66699bf3c77f04b1",
"payload": {
"accounts": [
{
"id": "1045121390",
"number": "1000001111",
"realAccountNumberLast4": "1111",
"accountNumberDisplay": "1111",
"name": "Checking",
"balance": 128.52,
"type": "checking",
"aggregationStatusCode": 0,
"status": "active",
"customerId": "1017101354",
"institutionId": "101732",
"balanceDate": 1611877952,
"aggregationSuccessDate": 1611877953,
"aggregationAttemptDate": 1611877953,
"createdDate": 1608197223,
"lastUpdatedDate": 1611877956,
"currency": "USD",
"lastTransactionDate": 1611357151,
"institutionLoginId": 1022599285,
"detail": {
"availableBalanceAmount": 122.12,
"periodInterestRate": "4.5"
},
"displayPosition": 5
},
{
"id": "1045121391",
"number": "1000002222",
"realAccountNumberLast4": "2222",
"accountNumberDisplay": "2222",
"name": "Savings",
"balance": 128.52,
"type": "savings",
"aggregationStatusCode": 0,
"status": "active",
"customerId": "1017101354",
"institutionId": "101732",
"balanceDate": 1611877952,
"aggregationSuccessDate": 1611877953,
"aggregationAttemptDate": 1611877953,
"createdDate": 1608197223,
"lastUpdatedDate": 1611877956,
"currency": "USD",
"lastTransactionDate": 1608197228,
"institutionLoginId": 1022599285,
"detail": {
"availableBalanceAmount": 1217.27,
"periodInterestRate": "4.5"
},
"displayPosition": 6
}
],
"institutionId": "101732"
}
} adding
Supported APIs:
- Generate V2 Connect Full / Lite
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when a customer enters their sign-in information at a financial institution and selects which accounts Connect can access to verify their financial information.
Note: If the institution is an OAuth connection, the oauth parameter value is true.
{
"customerId": "7065940",
"eventType": "adding",
"eventId": "1572413263805-b43cb6edb3254d4bebcfb4a0",
"payload": {
"institutionId": "102224",
"oauth": true
}
} credentialsUpdated
Supported APIs:
- Generate V2 Connect Fix
- OAuth not supported
Description: Sent when the customer updates their sign-in information for a selected institution. The mfa field indicates whether the credential challenge was followed by a sequential true or false MFA challenge question.
{
"customerId": "29272504",
"consumerId": "41d42ef0faef200e370208ad179a44cd",
"eventType": "credentialsUpdated",
"eventId": "1559073542901-f2d2ebd11cf852a8114b54dc",
"payload": {
"institutionId": "101732",
"mfa": false
}
} discovered
Supported APIs:
- Generate V2 Connect Full / Lite / Fix
- OAuth not supported
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent after the customer has successfully signed into an institution. All of the customer’s eligible accounts to permission are included in this event. The accounts in the payload of the subsequently added event are a subset of the accounts in the discovered event. If no accounts were discovered, then an empty array is sent.
{
"customerId": "29272504"
"consumerId": "41d42ef0faef200e370208ad179a44cd"
"eventType": "discovered",
"eventId": "1543509870615-7db10ceac8b2f5fa9b7b078c",
"payload": {
"accounts": [
"...",
"..."
]
}
} documentUpload
Supported APIs:
- Generate V2 Connect Full/ Lite / Send Email / Fix
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOIE – Paystub (with TXVerify)
Description: Sent after the user uploads a document in Connect.
{
"consumerId": "9a6f18zzz219a49d7f198a5ea6d959371",
"customerId": "52906923",
"eventType": "documentUpload",
"eventId": "157652800zzz-5a1zzzzdb38df8a07915863305",
"payload": {
"assets": [
{
"assetId": "257zzzac-7712-45a6-b895-8132fc88011d",
"label": "lastPayPeriod"
},
{
"assetId": "c36zzz0f-6519-4185-aa9e-768461a7c776",
"label": "lastPayPeriod"
}
]
}
} done
Supported APIs:
- Generate V2 Connect Full/ Lite / Send Email / Fix
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
- VOIE – Payroll
- VOIE – Paystub (with TXVerify)
Description: Sent after all pending reports are completed.
Aggregation
type = aggregation
Description: The done event is sent after the customer clicks Submit at the end of a Connect experience.
{
"customerId": "29272504",
"consumerId": "41d42ef0faef200e370208ad179a44cd",
"eventType": "done",
"payload": {}
} done (Reports)
Supported APIs:
- Generate V2 Connect Full / Lite / Send Email / Fix
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
- VOIE – Payroll
- VOIE – Paystub (with TXVerify)
Description: Sent after all pending reports are completed. If you request more than one report, the payload is an array of information for each report requested.
{
"customerId": "5019498180",
"consumerId": "093e1794ca8a646ce9901edcd43160a1",
"eventType": "done",
"eventId": "1639513582789-f1b8ba9bc325dfbe78aa09d4",
"payload": [
{
"portfolioId": "2z2ght9p54kt-1-port",
"consumerId": "093e1794ca8a646ce9901edcd43160a1",
"customerId": 5019498180,
"eventName": "done",
"id": "ue9s2g6je4j9",
"type": "voaHistory",
"consumerSsn": "6666",
"status": "success"
},
{
"portfolioId": "2z2ght9p54kt-3-port",
"consumerId": "093e1794ca8a646ce9901edcd43160a1",
"customerId": 5019498180,
"eventName": "done",
"id": "8tu59in6s3xy-voiepayroll",
"type": "voiePayroll",
"consumerSsn": "6666",
"status": "success"
},
{
"portfolioId": "2z2ght9p54kt-2-port",
"consumerId": "093e1794ca8a646ce9901edcd43160a1",
"customerId": 5019498180,
"eventName": "done",
"id": "bj0ru3yy55yz-voietxverify",
"type": "voieTxVerify",
"consumerSsn": "6666",
"status": "success"
}
]
} employerFound
Supported APIs:
- Generate V2 Connect Full /Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOIE – Payroll
Description: Sent when employment records matching the customer’s Social Security number (SSN) and date of birth (DOB) are found in the payroll providers.
{
"customerId": "1013916100",
"consumerId": "06a46d02b9851829ca53946be1da8200",
"eventType": "employerFound",
"eventId": "1602696485261-d299df6440556091e1d0531c",
"payload": {
"numEmployers": 1
}
} employerNotFound
Supported APIs:
- Generate V2 Connect Full / Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOIE – Payroll
Description: Sent when the customer’s SSN and DOB don’t match any employment records from the payroll provider.
{
"customerId": "1013916100",
"consumerId": "06a46d02b9851829ca53946be1da8200",
"eventType": "employerNotFound",
"eventId": "1602696889157-e6adbb438604041fc39ab3dd",
"payload": {
"error": 404,
"message": "Employment data not found"
}
} failed
Supported APIs:
- Generate V2 Connect Full / Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Prequalification VOA
- VOIE – Payroll
- VOIE – Paystub (with TXVerify)
Description: Sent after a report has failed to generate.
{
"id":"reportId",
"eventName": "failed",
"consumerId": "conId",
"consumerSsn": "conSSN",
"type": "reportType",
"status": "failure",
"customerId": 123,
"portfolioId": "asdf-1-port"
} generating
Supported APIs:
- Generate V2 Connect Full / Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Prequalification VOA
- VOIE – Payroll
- VOIE – Paystub (with TXVerify)
Description: Sent when the verification report starts generating. If you request more than one report, the payload is an array of information for each report.
{
"customerId": "5019498180",
"eventType": "generating",
"eventId": "1639513249775-192b6cf1aa025e1b5a1255c2",
"payload": [
{
"id": "ue9s2g6je4j9",
"portfolioId": "2z2ght9p54kt-1-port",
"customerType": "testing",
"customerId": 5019498180,
"requestId": "35fuuudwh8",
"requesterName": "Finicity (Layton Checketts - KEEP)",
"createdDate": 1639513248,
"title": "Finicity Verification of Asset and Income - Transactions",
"consumerId": "093e1794ca8a646ce9901edcd43160a1",
"consumerSsn": "6666",
"constraints": {},
"type": "voaHistory",
"status": "inProgress",
"reportId": "ue9s2g6je4j9"
},
{
"id": "8tu59in6s3xy-voiepayroll",
"portfolioId": "2z2ght9p54kt-3-port",
"customerType": "testing",
"customerId": 5019498180,
"requestId": "zvhz6sqfs9",
"requesterName": "Finicity",
"createdDate": 1639513248,
"title": "Finicity Verification of Income and Employment - Payroll",
"consumerId": "093e1794ca8a646ce9901edcd43160a1",
"consumerSsn": "6666",
"constraints": {
"payrollData": {
"payrollDataRetrievalId": "8vwg7tm44ib1",
"employerNames": [
"Enterprise One"
]
}
},
"type": "voiePayroll",
"status": "inProgress",
"source": "Finicity Connect",
"reportId": "8tu59in6s3xy-voiepayroll"
},
{
"id": "bj0ru3yy55yz-voietxverify",
"portfolioId": "2z2ght9p54kt-2-port",
"customerType": "testing",
"customerId": 5019498180,
"requestId": "1uv91guu71",
"requesterName": "Finicity",
"createdDate": 1639513248,
"title": "Verification of Income and Employment - Paystub (with TXVerify)",
"consumerId": "093e1794ca8a646ce9901edcd43160a1",
"consumerSsn": "6666",
"constraints": {
"voieWithInterviewData": {
"txVerifyInterview": [
{
"assetId": "8962b6e9-474f-4056-9151-1b5ba825a4e4-1094357070",
"accounts": []
}
],
"extractEarnings": true,
"extractDeductions": false,
"extractDirectDeposit": true
}
},
"type": "voieTxVerify",
"status": "inProgress",
"source": "Finicity Connect",
"reportId": "bj0ru3yy55yz-voietxverify"
}
]
} inProgress
Supported APIs:
- Generate V2 Connect Full / Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Prequalification VOA
- VOIE – Payroll
- VOIE – Paystub (with TXVerify)
Description: Sent when a report is being generated and has an inProgress status.
{
"id":"reportId",
"eventName": "inProgress",
"consumerId": "conId",
"consumerSsn": "conSSN",
"type": "reportType",
"status": "inProgress",
"customerId": 123,
"portfolioId": "asdf-1-port"
} institutionLoginDeleted
Supported APIs:
- Generate V2 Connect Full / Lite / Fix
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when all of the accounts under the specified institutionLoginId were deleted for the customer.
{
"customerId": "1008650161",
"eventType": "institutionLoginDeleted",
"eventId": "1594221557396-19ef569f7fbfa65488283b81",
"payload": {
"institutionLoginId": "1011648058"
}
} institutionNotFound
Supported APIs:
- Generate V2 Connect Full / Lite / Fix
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when the user searches for an institution that is not on our list. Connect provides the description for the query field.
{
"customerId": "29272504",
"eventType": "institutionNotFound",
"eventId": "1564677197519-4f47b664bd855275389e76c6",
"payload": {
"query": "not a real institution"
}
} institutionNotSupported
Supported APIs:
- Generate V2 Connect Full / Lite / Fix
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when the user selects an institution that isn’t certified. This applies to any call except for aggregation, lite, fix, and voi-pp.
{
"customerId": "29272504",
"consumerId": "41d42ef0faef200e370208ad179a44cd",
"eventType": "institutionNotSupported",
"eventId": "1543535415162-6d06cbeed93533d612b4e255",
"payload": {
"institutionId": "15880"
}
} institutionSupported
Supported APIs:
- Generate V2 Connect Full / Lite
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when a user selects a financial institution from a search query that is certified for the product.
{
"customerId": "29272504",
"consumerId": "41d42ef0faef200e370208ad179a44cd",
"eventType": "institutionSupported",
"eventId": "1557155470294-f5e5273c2354e09670647e18",
"payload": {
"institutionId": "101732"
}
} invalidCredentials
Supported APIs:
- Generate V2 Connect Full / Lite / Fix
- OAuth not supported
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when the user enters incorrect sign-in information for the selected institution.
{
"customerId": "29272504",
"consumerId": "41d42ef0faef200e370208ad179a44cd",
"eventType": "invalidCredentials",
"eventId": "1543535972345-805ba937fdc4c6d3889b261c",
"payload": {
"institutionId": "101732"
}
} mfa
Supported APIs:
- Generate V2 Connect Full / Lite
- OAuth not supported
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when the user enters correct sign-in information for an institution and a Multi-Factor Authorization (MFA) challenge question displays.
{
"customerId": "29272504",
"consumerId": "41d42ef0faef200e370208ad179a44cd",
"eventType": "mfa",
"eventId": "1543535689086-56219127a30d3f881436c0b2",
"payload": {
"institutionId": "101732"
}
} mfaUpdated
Supported APIs:
- Generate V2 Connect Fix
- OAuth not supported
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Description: Sent when the user completed the MFA challenge question for an institution.
{
"customerId": "29272504",
"eventType": "mfaUpdated",
"eventId": "1559073793752-914b6150eacc1d59fe444bf3",
"payload": {
"institutionId": "101732"
}
} payrollError
Supported APIs:
- Generate V2 Connect Full / Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOIE – Payroll
Description: Sent when an error occurs while making a request to the payroll connector service. The error code and message are included in the response payload.
Error Codes:
- 400: The consumer record doesn’t match the Social Security number (SSN) and date of birth (DOB) passed to Connect.
- 500: An unexpected error has occurred.
{
"customerId": "1013916100",
"consumerId": "06a46d02b9851829ca53946be1da8200",
"eventType": "payrollError”,
"eventId": "1602696010692-ac29d9e8e1dbeee869e1b46d",
"payload": {
"error": 400,
"message": "Please provide valid ssn and date of Birth for customer 1013916100"
}
} payrollSearch
Supported APIs:
- Generate V2 Connect Full / Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOIE – Payroll
Description: Sent when the customer enters their SSN and DOB to search for their payroll information.
{
"customerId": "1013916100",
"consumerId": "06a46d02b9851829ca53946be1da8200",
"eventType": "payrollSearch",
"eventId": "1602696009983-f18edc8d007efc7d4f87000e",
"payload": {
"ssn": "6789",
"dateOfBirth": "1980-01-01"
}
} ping
Supported APIs:
- Generate V2 Connect Full / Lite / Send Email / Fix
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
- VOIE – Payroll
- VOIE – Paystub (with TXVerify)
- VOE-Transactions
- VOAI-Transactions
Description: Sent when the Generate 2.0 Connect URL APIs are called to verify that the webhook URL is accessible. This endpoint must return a 200 series or the Generate Connect URL call fails.
{
"eventType":ping
"Payload": []
} processing
Supported APIs:
- Generate V2 Connect Full / Lite / Fix
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
Descriptions: Sent when a request to generate a report is in the process of generating the report.
OAuth: Sent after the user selects their accounts from an OAuth connection, and then gets redirected back to Connect.
{
"customerId": "7065940",
"eventType": "processing",
"eventId": "1567184715231-20b2b26125f0e7ada97395cb",
"Payload": {
"institutionId":"102224"
}
} started
Supported APIs:
- Generate V2 Connect Full / Lite / Send Email / Fix
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
- VOIE – Payroll
- VOIE – Paystub (with TXVerify)
Description Sent when the Connect application is loaded and the landing web page is displayed.
{
"customerId": "1013916100",
"consumerId": "06a46d02b9851829ca53946be1da8200",
"eventType": "started",
"eventId": "1602695997415-9acf8c53accecf433bc8b000",
"payload": {}
} unableToConnect
Supported APIs:
- Generate V2 Connect Full / Lite / Send Email
- Connect Full – Joint Borrowers
- Send Connect Email – Joint Borrowers
Supported processes:
- VOA
- VOAI
- VOI
- Aggregation
- ACH
- VOIE – Payroll
Description: Sent when a financial institution is unavailable (unknown reasons) and a connection isn’t possible.
Error codes: 102, 500, 900, 903, 904, 901, 910, 915, 916, and 920.
{
"customerId": "29272504",
"consumerId": "41d42ef0faef200e370208ad179a44cd",
"eventType": "unableToConnect",
"eventId": "1543535415162-6d06cbeed93533d612b4e255",
"payload": {
"institutionId": "15880"
"code": 500
}
}