Guides

Whitelabel Integration Guide -- DRAFT

Suggest Edits

General

Axo Group offers three tech products for whitelabel integration:

  • AXO Whitelabel Form
    An embeddable front-end application for application forms (e.g., unsecured loans, credit cards).
  • AXO Integration API
    An API used to initiate loan applications within Axo Group’s platform.
  • AXO Pre-Check API
    An API used to check whether a lead is likely to be accepted by Axo.

To submit applications to Axo Group’s platform, the use of the AXO Whitelabel Form is required. The two APIs are optional.

This guide outlines how to access and use these products. Integration and usage are consistent across all of Axo Group’s brokering products (unsecured loans and credit cards), brands, and markets (Norway, Sweden, Denmark, and Finland).

All code examples provided in this guide are complete and functional.

Prerequisites

To become a whitelabel, you first need to join the Axo Group Affiliate Program. Once sign

  • Foo
  • Bar
  • Baz

Embedding the Form

Embedding the AXO Whitelabel Form involves adding a <script> tag to your HTML. The implementation is the same across all Axo Group markets, brands, and products.

Example

In this example, we embed the application form for unsecured loans from the brand axofinans.no.

<script
    id="axo-script"
    src="https://embed.axogroup.com/axofinans.no/loan-application/main.js"
    data-has-offers-affiliate-url="<YOUR-TRACKING-URL-PROVIDED-BY-AXO>"
    type="module">
</script>

Note: The data-has-offers-affiliate-url attribute is optional and should only be included when using Method 2: Full Front-End Integration.

Environments & URLs

AXO Whitelabel Forms follow a standard URL pattern:

https://<BASE-URL>/<BRAND>/<PRODUCT-TYPE>/main.js

Where:

  • BASE-URL is the environment:
    • Production: form.axofinance.com
    • Test: form.axo-test.io
  • BRAND is the domain of the brand (e.g., axofinans.no)
  • PRODUCT-TYPE is either loan-application or credit-card

Production URLs & Supported Product Types

To use the test version of a form, replace the base URL with form.axo-test.io.

BrandMarketProduct TypeURL
axofinans.noNOUnsecured Loanshttps://embed.axogroup.com/axofinans.no/loan-application/main.js
axofinans.noNOCredit Cardshttps://embed.axogroup.com/axofinans.no/credit-card/main.js
axofinans.seSEUnsecured Loanshttps://embed.axogroup.com/axofinans.se/loan-application/main.js
axolaina.fiFIUnsecured Loanshttps://embed.axogroup.com/axolaina.fi/loan-application/main.js
lendme.dkDKUnsecured Loanshttps://embed.axogroup.com/lendme.dk/loan-application/main.js

Method 1: Partial Front-End Integration

This method suits partners who want to host the initial stages of the customer journey themselves.

Example Scenario

A typical flow:

  1. A lead lands on the partner site.
  2. The lead fills out the partner’s custom form (referred to as the pre-form).
    • We recommend collecting the same fields as the first step of the AXO Form:
      • Loan Amount
      • Loan Duration
      • Email Address
      • Phone Number
    • Missing fields will result in the AXO Form redirecting the user to complete Step 1, ensuring continuity.
  3. Upon form submission, the partner can:
    • Call the AXO Pre-Check API [TODO: ADD LINK] to verify if the lead may be accepted.
  4. The partner calls the AXO Integration API [TODO: ADD LINK] to initiate the application.
  5. The partner stores the returned jwt and applicationID in sessionStorage.
  6. The lead is redirected to a page with the AXO Whitelabel Form embedded.
  7. The lead completes the form and is redirected to Axo Group My Page [TODO: ADD LINK] to view and accept offers.

Example Code

Two files are used in this example for the Danish brand lendme.dk.

  • index.html – Contains the pre-form
  • axo-form.html – Embeds the AXO Whitelabel Form
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
  <title>My Whitelabel Site</title>
</head>
<body>
  <form>
    <fieldset>
      <legend>Apply for a loan in Denmark</legend>
      <input type="email" name="Email" placeholder="Email"><br><br>
      <input type="text" name="PhoneNumber" placeholder="Phone Number"><br><br>
      <input type="text" name="SocialSecurityNumber" placeholder="SSN"><br><br>
      <input type="number" name="AppliedAmount" placeholder="Amount"><br><br>
      <input type="number" name="LoanDuration" placeholder="Duration"><br><br>
      <input type="submit" value="Continue">
    </fieldset>
  </form>

  <script>
    onsubmit = (e) => {
      e.preventDefault();
      const formData = new FormData(e.target);
      const formProps = Object.fromEntries(formData);

      fetch("https://integration.axo-test.io/v1/loan-application/", {
        method: "POST",
        headers: { "Content-type": "application/json; charset=UTF-8" },
        body: JSON.stringify({
          application: {
            AppliedAmount: parseInt(formProps.AppliedAmount) || 100000,
            LoanDuration: parseInt(formProps.LoanDuration) || 10,
            MarketCountry: "DK"
          },
          customer: {
            MobilePhoneNumber: formProps.PhoneNumber || "40000000",
            Email: formProps.Email || "[email protected]"
          },
          person: {
            SocialSecurityNumber: formProps.SocialSecurityNumber || "2803282547"
          },
          tracking: {
            HasOffersAffiliateURL: "https://go.axogroup.com/...",
            StartedAtUrl: document.location.pathname
          }
        })
      })
        .then((response) => response.ok ? response.json() : Promise.reject(response))
        .then((axoResponse) => {
          sessionStorage.setItem("axo.token", axoResponse.jwt);
          sessionStorage.setItem("axo.application-id", axoResponse.applicationID);
          window.location.replace('axo-form.html');
        })
        .catch(() => alert("Error creating the application at Axo."));
    };
  </script>
</body>
</html>

<!-- axo-form.html -->
<!DOCTYPE html>
<html>
<head>
  <title>Axo Whitelabel Form</title>
</head>
<body>
	<script 
  	id='axo-script'
    src='https://form.axo-test.io/lendme.dk/loan-application/main.js'
    type='module'>
	</script>
</body>
</html>

Method 2: Full Front-End Integration

This method is for partners who prefer AXO to handle the entire customer journey.
No custom form or API integration is required.

Example Scenario

  1. A lead lands on the partner site.
  2. The partner embeds the AXO Whitelabel Form on the landing page.
    1. Please note that in this scenario, you have to include the data-has-offers-affiliate-urlattribute in the script tag for your lead to attributed correctly in our systems
  3. The lead completes the form directly.
  4. The lead is redirected to Axo Group My Page [TODO: ADD LINK] to review and accept offers.

Example Code

<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
  <title>Axo Whitelabel Form</title>
</head>
<body>
  <script 
  	id='axo-script'
    src='https://form.axo-test.io/lendme.dk/loan-application/main.js'
    data-has-offers-affiliate-url="<YOUR-TRACKING-URL>"
    type='module'>
	</script>
</body>
</html>

AXO Integration API

Foo

Pre-Check API

The Pre-Check API allows you to verify whether AXO might pay for a lead before submitting them to the AXO platform. Final payout depends on the lead quality and your commission model.

This API works across all Axo Group brokering products.

Authentication

Use your dedicated API key in the x-api-key header.
If you don’t have a key, please contact our Affiliate Team.

Environments & URLs

EnvironmentProduct TypeURL
PRODUnsecured Loanshttps://integration.axofinance.com/pre-check
TESTUnsecured Loanshttps://integration.axo-test.io/pre-check
PRODCredit Cardshttps://integration.axofinance.com/pre-check/credit-card
TESTCredit Cardshttps://integration.axo-test.io/pre-check/credit-card

Example Request

curl --location --request GET 'https://integration.axo-test.io/[email protected]' --header 'x-api-key: <YOUR-API-KEY>'

Response

  • "REJECTED" – AXO will not pay for this lead.
  • "OK" – AXO might pay for this lead.
  • "BLOCKED" – Low quality lead; AXO might still pay.

Styling Overrides

Styling overrides are currently not supported and we discourage trying to override any of the internal styles. Proper support for simple theming configured by the whitelabel partner is in development.

Updated 3 days ago