Callbacks
The most effecient method to keep your systems up-to-date with leads from the AVICA platform is through the use of server-2-server callbacks.
We offer callbacks on application submit for low-quality, duplicaten and approved status codes. The callbacks will be executed as HTTP POST requests with the application as json request body. It is up to you to filter the callbacks according to how you want them to be handled in your systems. For example does approved applications not necessarily mean you earn commission so if you want to only process the callback in case of positive commission you need to filter yourself.
We recommend that you use no-code platforms like Make.com or Zapier.com to easily transform and filter the callback data. With Make.com and Zapier it is easy to connect your systems.
Go to portal.financeservice.io to see the callbacks activated on your account. Contact your account manager if you want to add or delete callback to your account.
Webhook Body
The webhook body might vary according to your account permissions.
{
"event": "submit:approved",
"webhook_id": "49",
"serverTimestamp": "2023-10-30 12:36:14",
"serverTimezone": "UTC",
"application_id": "2326553",
"data": {
"token": "7a3e50f6-7720-11ee-a380-02a38f9a40ff",
"url": "https://myloan.co.za/application",
"submit_status": "approved",
"datetime_submitted": "2023-10-30 12:36:13",
"datetime_updated": "2023-10-30 12:34:06",
"datetime_added": "2023-10-30 12:33:06",
"session_id": 5269182,
"form_id": 23,
"account_id": 1382407,
"application_id": 2326553,
"session": {
"id": 5269182,
"screen_width": 598,
"screen_height": 718,
"brand_id": 23,
"publisher_id": 2007,
"tracking": {
"pubidsub1": "tracking-value-1",
"pubidsub2": "tracking-value-2",
"pubidsub3": "tracking-value-3",
"utm_content": "email",
"utm_campaign": "fall-campaign-23"
}
},
"creditscores": [
{
"scorecard": "creditscore_v1.0",
"score_numeric": 0.13736,
"score_class": "A",
"datetime_added": "2023-10-30 12:36:13",
"datetime_updated": "2023-10-30 12:36:13",
"creditscore_id": 3382545,
"application_id": 2326553
},{
"scorecard": "iq_v1.0",
"score_numeric": 2.26324,
"score_class": "B",
"datetime_added": "2023-10-30 12:36:13",
"datetime_updated": "2023-10-30 12:36:13",
"creditscore_id": 3382543,
"application_id": 2326553
},{
"scorecard": "iq_v2.0",
"score_numeric": null,
"score_class": "F",
"datetime_added": "2023-10-30 12:36:13",
"datetime_updated": "2023-10-30 12:36:13",
"creditscore_id": 3382544,
"application_id": 2326553
}
],
"transactions": [{
"datetime_added": "2023-11-27 12:26:58",
"datetime_updated": "2023-11-27 12:26:58",
"transaction_id": 841297,
"currency_id": 40,
"amount_transformed": 10,
"amount_transformed_eur": 0.4863,
"currency": {
"id": 40,
"name": "south african rand",
"alpha3": "zar",
"symbol": "R",
"datetime_added": "2023-11-13 20:42:07",
"datetime_updated": "2023-11-13 20:42:07"
}
}],
"primaryApplicant": {
"email": "jane.doe@example.com",
"phone": "0000000000",
"postalcode": "0000",
"city": "johannesburg",
"suburb": "johannesburg",
"birthdate": "1900-01-01",
"gender": "male",
"subscriptions": [
{
"email_optin": "2023-10-30 12:36:13",
"email_optout": null,
"sms_optin": "2023-10-30 12:36:13",
"sms_optout": null,
"postal_optin": "2023-10-30 12:36:13",
"postal_optout": null,
"datetime_added": "2023-10-30 12:33:42",
"datetime_updated": "2023-10-30 12:36:13"
}
]
}
}
}