Developer Documentation

Integrate your Keyloop AutoMaster DMS and Alfasystems with Autoloan Finland to streamline your car financing workflow.

Getting Started

Our integration is designed to be simple and robust, allowing you to submit finance applications directly from your DMS and receive real-time status updates.

1. API Authentication

To get started, you'll need an API key. You can generate one from your Dealer Portal under the "Settings > API" section. All API requests must include your key in an Authorization header.

HTTP Header

Authorization: Bearer YOUR_API_KEY

2. Submitting an Application from AutoMaster

To create a new finance application, send a POST request to our applications endpoint with the customer and vehicle details.

Endpoint

POST /api/v1/applications

JSON Payload

{
  "customer": {
    "firstName": "Matti",
    "lastName": "Meikäläinen",
    "email": "matti.meikalainen@example.com",
    "phone": "+358 40 123 4567"
  },
  "vehicle": {
    "vin": "YV1DZ82C...",
    "make": "Volvo",
    "model": "V60",
    "year": 2022,
    "price": 39000,
    "mileage": 30000
  },
  "dealerId": "DEALER-12345"
}

3. Pushing to Alfasystems Alfa 6 Cloud

Once an application is approved, the data must be pushed to your Alfasystems Alfa 6 Cloud instance to create the formal loan contract and begin the servicing lifecycle. This is done via a dedicated endpoint that requires authentication with your Alfa Systems credentials.

Endpoint

POST https://YOUR_ALFA_INSTANCE.alfasystems.com/api/v6/contracts

Contract Creation Payload

{
  "applicationId": "APP-005",
  "customerReference": "CUST-101",
  "vehicleDetails": {
    "vin": "YV1DZ82C...",
    "registrationNumber": "ABC-123",
    "make": "Volvo",
    "model": "V60",
    "price": 39000
  },
  "financeDetails": {
    "approvedAmount": 35000,
    "downPayment": 4000,
    "interestRate": 4.5,
    "termMonths": 60,
    "monthlyInstallment": 650.50
  }
}

4. Receiving Status Updates via Webhooks

To receive real-time updates on application statuses (e.g., "Pending", "Approved", "Rejected"), you can configure a webhook endpoint in your Dealer Portal. We will send a POST request to your specified URL with the following payload.

Webhook Payload Example

{
  "applicationId": "APP-005",
  "status": "Approved",
  "timestamp": "2024-07-18T10:00:00Z",
  "details": {
    "approvedAmount": 35000,
    "interestRate": 4.5,
    "term": 60
  }
}

Support

If you have any questions or need assistance with your integration, please don't hesitate to reach out to our developer support team at devsupport@autoloan.fi.