Kom igång med TIC Credit

Stegen nedan beskriver API-flödet. För embed-flödet, gå direkt till embed-dokumentationen.

• Ett TIC Credit-konto (registrera dig här)
• Din API-nyckel (visas efter registrering) — krävs för API-flödet
• En webhook-endpoint för att ta emot notifikationer (valfritt)
• För embed-flödet: en eller flera origins att lägga till i allowlistan i portalens inställningar

Besök registreringssidan och skapa ett konto för ditt företag. Du får en API-nyckel och webhook-hemlighet efter registrering.

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",
    "webhookUrl": "https://your-app.com/webhook/credit"
  }'

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", "YOUR_API_KEY");

var response = await http.PostAsJsonAsync(
    "https://credit.tic.io/api/v1/check",
    new {
        personalNumber = "YYYYMMDDNNNN",
        mobilePhoneNumber = "+46XXXXXXXXX",
        webhookUrl = "https://your-app.com/webhook/credit"
    });

const res = await fetch('https://credit.tic.io/api/v1/check', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    personalNumber: 'YYYYMMDDNNNN',
    mobilePhoneNumber: '+46XXXXXXXXX',
    webhookUrl: 'https://your-app.com/webhook/credit'
  })
});

Svaret innehåller ett creditCheckId som du använder för att hämta resultatet:

{
  "creditCheckId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Requested",
  "deliveredVia": "sms",
  "hostedUrl": "/your-slug/check/550e8400-...",
  "expiresAt": "2026-04-15T12:30:00Z"
}

Första gången en person använder SMS-flödet får de ett SMS med en länk. När de klickar på länken loggar de in med BankID och bekräftar att de önskar kreditupplysningskopior via deras Mina sidor-konto.

Efterföljande kreditupplysningskopior på samma person går automatiskt till Mina sidor — de behöver inte godkänna med BankID igen, kreditupplysningen är klar direkt och ett kort SMS skickas om att en ny kreditupplysningskopia finns på Mina sidor. Svaret innehåller då "notificationOnly": true och completedAt istället för hostedUrl / expiresAt.

Du kan antingen:

• Använda webhooks — vi skickar en POST till din webhook-URL när upplysningen är klar.
• Polla status — anropa GET /api/v1/check/{id} periodiskt.

Har du bråttom och inte önskar använda SMS? Sätt "deliveryMethod": "letter" i request body — då levereras kreditupplysningskopian direkt till personens Kivra eller folkbokföringsadress och kreditupplysningen är tillgänglig omedelbart. letter är inte tillämpligt för personer som redan har ett bekräftat mobilnummer (då returneras 409 phone_already_confirmed); skicka istället "deliveryMethod": "sms" och TIC sköter notifieringen automatiskt.

curl https://credit.tic.io/api/v1/check/550e8400-... \
  -H "X-Api-Key: YOUR_API_KEY"

Svaret innehåller kreditbetyg och fullständig kreditupplysning:

{
  "creditCheckId": "550e8400-...",
  "status": "Completed",
  "personalNumber": "YYYYMMDDNNNN",
  "givenName": "Anna",
  "surname": "Andersson",
  "creditScore": 85,
  "requestedAt": "2026-04-15T12:00:00Z",
  "completedAt": "2026-04-15T12:02:30Z",
  "report": {
    "income": { ... },
    "debts": { ... },
    "paymentRemarks": [ ... ]
  }
}

• Inbäddat flöde (iframe) — synkron BankID-integration direkt på din sida med drop-in SDK
• Testläge & testdata — testpersoner och simulerade felutfall du kan integrera emot
• API-referens — komplett dokumentation av alla endpoints
• Webhooks — konfigurera realtidsnotifikationer
• Felkoder — hantera fel och undantag

Kontakta vår support på support@tic.io eller ring +46 10-510 78 78.