TIC Credit Dokumentation

Välkommen till dokumentationen för TIC Credit — en kreditupplysningsplattform för företag och Mina sidor för privatpersoner.

Snabbstart

Tre leveranssätt — välj det som passar din integration. Det inbäddade flödet (iframe) är vårt rekommenderade sätt för bästa användarupplevelse där identitets- och kreditkontrollen sker direkt på din sida.

Så fungerar TIC Credit

Tre leveranssätt — välj det som passar din användarresa:

Inbäddat flöde (iframe) — rekommenderat för bästa användarupplevelse

Du bäddar in en iframe på din sida utan programmering. Användaren autentiserar sig och identitets- och kreditkontrollen sker direkt och resultatet (inklusive kreditbetyg, namn, folkbokföringsadress) rapporteras tillbaka direkt via postMessage.

1. Aktivera flödet i portalen — gå till Inställningar, kryssa i Aktivera inbäddat flöde, lägg till de origins där iframen får laddas.
2. Bädda in på din sida — ett par rader "kod" eller en <script>-tagg med vårt SDK.
3. Lyssna på event — tic-credit:completed ger dig checkId, creditScore, folkbokforingsadress, ipRisk direkt i din egen JS.

Läs hela embed-dokumentationen →

SMS-flöde (för andra integrationer)

SMS-godkännandet är en engångshändelse per person. När en person har godkänt att få sina kreditupplysningskopior via Mina sidor-kontot kommer alla kommande kreditupplysningskopior automatiskt att levereras dit.

1. Begär identitets- och kreditkontroll — Ditt system anropar vårt API med personnummer och mobilnummer.
2. SMS skickas — Första gången får personen ett SMS med en länk där de loggar in med BankID och bekräftar att de önskar sina kreditupplysningskopior levererade till Mina sidor. Vid efterföljande upplysningar skickas bara en kort SMS om att en ny kreditupplysningskopia finns på Mina sidor — inget godkännande, kreditupplysningen är klar direkt.
3. Kreditupplysning skapas — När den är klar notifieras du via webhook.
4. Hämta kreditupplysningen — Ditt system hämtar den färdiga kreditupplysningen via API.

Brev-flöde (Kivra eller brev)

1. Begär identitets- och kreditkontroll — Ditt system anropar vårt API med personnummer och deliveryMethod: "letter".
2. Kreditupplysning skapas direkt — Kreditupplysningskopia levereras automatiskt till personens Kivra-brevlåda om sådan finns, annars via post.
3. Hämta kreditupplysningen — Kreditupplysningen finns omedelbart tillgänglig via API.

OBS: Brev-flödet är inte tillämpligt för personer som redan har ett Mina sidor konto — för dem returneras 409 phone_already_confirmed och du ska skicka deliveryMethod: "sms" istället; TIC sköter notifieringen automatiskt.

Integrationslägen

Embed läge (rekommenderat för bästa användarupplevelse)

Bädda in iframen direkt på din sida. Identitets- och kreditkontrollen sker via BankID och resultatet kommer tillbaka som ett postMessage-event. Idealisk för alla flöden på din webbsida.

<div id="credit-embed"></div>
<script src="https://credit.tic.io/js/tic-credit-embed.js"></script>
<script>
TicCredit.embed({
    slug: 'YOUR_SLUG',
    container: '#credit-embed',
    onCompleted: (data) => console.log(data.checkId, data.creditScore)
});
</script>

API mode (rekommenderat för server-till-server)

Genomför identitets- och kreditkontroller programmatiskt via REST API. Full kontroll över ditt arbetsflöde. Passar bättre för B2B-flöden där du inte vill använda embed läge.

curl -X POST https://credit.tic.io/api/v1/check \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personalNumber": "YYYYMMDDNNNN", "mobilePhoneNumber": "+46XXXXXXXXX"}'

Behöver du hjälp?

Om du har frågor eller stöter på problem, besök vår supportsida.