Webhooks overview
Arix uses webhooks to update you on the status of your loan, via API calls. Webhooks report to your system with real-time notifications when an event happens. You have to register your URL to receive a webhook for each relevant event status report. When that event occurs, a webhook is triggered and reports the updates to your system.
Example
After the partner submits George's complete loan documents to Arix, the loan passes to the status, DocsComplete. That triggers a webhook event which is reported to the partner notifying them of the event.
Webhook report failure
After a webhook is reported the first time, the endpoint doesn't check that it was successfully received, nor does it retry for failures.
For information on registering for and viewing webhooks, see Register for webhook events and View webhook events and updates.
Webhook API calls
Call | Description |
---|---|
Returns the events available to subscribe to such as:
| |
Registers a URL to an event with these parameters:
| |
Returns a list of webhook events you are registered to.
| |
Unregisters a URL from an event. To unregister from a webhook, use RegistrationId. See View registered webhook events to find the ID. |
Sample webhook responses
LoanStatusUpdated
{
"EventName": "LoanStatusUpdated",
"EventData": {
"Id": 0,
"LoanId": "5f1a5e2b-52be-4766-8d7b-aa8d005ecce1",
"Status": 1,
"TimeStamp": "2019-07-17T01:45:09.5144036"
}
}
FundingAttemptComplete
{
"EventName": "FundingAttemptComplete",
"EventData": {
"Id": 0,
"LoanId": "28f1388f-8110-4c49-8f5d-aa99010c0575",
"Time": "2019-07-29T13:44:31.3305937",
"TransactionGroupId": "77dd9024-8889-4ea9-8424-752d8a37f9b4",
"FundingResult": 0,
"AmountFunded": 6748
}
}
ComplianceLoanFailed
Note: Arix checks for duplicated loan numbers within the past 24 hours. If a partner sends a loan with a previously existing loan number, Arix moves the loan to ‘ComplianceLoanFailed’. At that stage, the partner can verify whether to approve or reject the loan.
{
"EventName": "ComplianceLoanFailed",
"EventData": {
"MPLId": "xxx",
"LoanId": "...guid...",
"CreateDate": "date",
"FailedRulesReasons": [
{
"RuleName": "rule name",
"Rule": "some string",
"Data": "some string",
"Result": true,
"FailedComplianceID": 67
}
]
}
}
RailUpdated
{
"EventName":"RailUpdated",
"EventData":{
"Id":0,
"RailId":"…ID of rail that is received when rail created…",
"LoanId":"fd331267-6ac2-4818-9d0f-ab2f00747b61",
"RailType":8,
"AmountFunded":8500.0,
"RailTransactionId":"…railid from cos…",
"FundResult": int(this is enum RailResultType),
"Message":"Description of rail created if no error returned",
"ProcessedAt":"2019-12-26T07:05:09Z",
"TransactionGroupId":"9dde776d-0c04-4bc8-9c9c-e0ad9a83c447"
}
}
Updated about 1 year ago