Loan Events
The following are events triggered by activities related to installment loans. These are sent to you in the Transaction Events Webhook which is part of the Events API.
loan_creation_event
A loan has been successfully created for a customer. The reference_id_list
is a list of transaction ids that the loan is for.
- Code — N/A
- Event trigger — A loan is successfully created.
- Process — This process contains the event trigger:
- Create Loan endpoint
- Create Loan from Transactions endpoint
All fields are strings.
Field | Default | Description |
---|---|---|
loan_id | X | Galileo-generated identifier for the loan, returned in the Create Loan response in the loan_id field. Example: "11117000000000082” |
reference_id_list | X | List of ids of source that created a loan. For Create Loan, this is an individual transaction ID. Example:"dbc7853f-d244-4ccb-a0f0-30e2ae332ee8" |
reference_id_type | X | Type of the reference_id .Example: “transaction_id” |
prn | X | Galileo 12-digit PRN for the account. Example: ”155101003022” |
# loan_creation_event example
{
"data": {
"loan_id": "11117000000000082",
"reference_ids": "dbc7853f-d244-4ccb-a0f0-30e2ae332ee8",
"reference_id_type": "7789999",
"prn": "207101498401"
}
loan_creation_failure_event
An incoming loan creation request has failed. No loan was created as a result.
- Code — N/A
- Event trigger — A loan creation request failed due to an error with the details of the loan.
- Process — This process contains the event trigger:
- Create Loan endpoint
- Create Loan from Transactions endpoint
All fields are strings.
Field | Default | Description |
---|---|---|
error_code | X | Status code provided by the endpoint response when the loan creation request fails. Example: ”1201-03” |
error_description | X | Description text of the status code. Example: “The loan amount exceeds the maximum allowed loan amount configured for this subproduct” |
reference_id | X | List of ids of source that created a loan. For Create Loan, this is an individual transaction ID. Example:"dbc7853f-d244-4ccb-a0f0-30e2ae332ee8" |
reference_id_list | X | Type of the reference_id .Example: “transaction_id” |
prn | X | Galileo 12-digit PRN for the account. Example: ”155101003022” |
# loan_creation_event example
{
"data": {
"error_code": "1201-03",
"error_description": "The loan amount exceeds the maximum allowed loan amount configured for this subproduct",
"reference_id": "3LNfa9N7bzrk5F_a",
"reference_id_type": "7789999",
"prn": "207101002559"
}
loan_payoff_event
An incoming payment request made by a customer results in the payoff of the loan.
- Code — N/A
- Event trigger — When a loan gets paid off.
- Process — This process contains the event trigger:
- Create Loan Payment endpoint
All fields are strings.
Field | Default | Description |
---|---|---|
loan_id | X | Galileo-generated identifier for the loan, returned in the Create Loan response in the loan_id field. Example: "11117000000000082” |
# loan_creation_event example
{
"data": {
"loan_id": "11117000000000082"
}