Utvecklare

SettleInto API

Integrera etableringstjänster i er plattform. REST API med realtidswebhooks.

Snabbstart

Skapa en prenumeration på under en minut.

POST /v1/subscriptions

curl -X POST https://api.settleinto.io/v1/subscriptions \
  -H "Authorization: Bearer sk_live_4eC39HqLyjWDarHT8" \
  -H "Content-Type: application/json" \
  -d '{
    "package": "plus",
    "tenant": {
      "name": "Jane Smith",
      "email": "jane@company.com",
      "phone": "+46 70 234 5678"
    },
    "address": "Sveav\u00e4gen 42, 111 34 Stockholm",
    "start_date": "2026-03-01"
  }'

Svar 201 Created

{
  "id": "sub_abc123xyz789",
  "status": "pending",
  "package": "plus",
  "monthly_price": 699,
  "currency": "SEK",
  "services": ["insurance", "electricity", "mobile"],
  "tenant": {
    "name": "Jane Smith",
    "email": "jane@company.com"
  },
  "start_date": "2026-03-01",
  "activation_estimate": "2026-03-05",
  "created_at": "2026-02-18T14:30:00Z"
}

API-endpoints

Alla endpoints kräver Bearer-tokenautentisering.

Metod	Endpoint	Beskrivning
POST	/v1/subscriptions	Skapa en ny prenumeration
GET	/v1/subscriptions/:id	Hämta prenumerationsdetaljer och status
GET	/v1/subscriptions	Lista alla prenumerationer (med paginering)
POST	/v1/subscriptions/:id/terminate	Avsluta en prenumeration
GET	/v1/packages	Lista tillgängliga paket och priser
GET	/v1/eligibility/check	Kontrollera hyresgästens behörighet innan skapande
GET	/v1/invoices/:id	Hämta fakturadetaljer och betalningshistorik

Webhooks

Få notifieringar i realtid när prenumerationer och tjänster ändras.

Understödda händelser

subscription.created
subscription.activated
service.activated
service.failed
subscription.terminated
invoice.generated

Exempel på webhook-payload: service.activated

{
  "event": "service.activated",
  "timestamp": "2026-03-03T10:00:00Z",
  "data": {
    "subscription_id": "sub_abc123xyz789",
    "service": "electricity",
    "status": "active",
    "activated_at": "2026-03-03T10:00:00Z",
    "external_ref": "ANL-123456"
  },
  "id": "evt_789abc"
}

Autentisering

Bearer-tokenautentisering. Inkludera din API-nyckel i Authorization-headern: Authorization: Bearer sk_live_...
Separata sandbox- och produktionsnycklar. Testa noggrant i sandbox innan produktionsdistribution.
Alla förfrågningar måste använda HTTPS. Okrypterade förfrågningar avvisas.
Hastighetsgräns: 100 förfrågningar per minut. Överskrids detta resulterar det i ett 429 Too Many Requests-svar.
Håll din API-nyckel hemlig. Behandla den som ett lösenord. Om den komprometteras, rotera omedelbart från din dashboard.

Integrationsmodeller

Välj hur era användare interagerar med SettleInto.

Fullt API

Bygg eget gränssnitt. Skapa prenumerationer, kolla behörighet, hantera webhooks och hela flödet. För plattformar som vill ha total kontroll.

Hostad checkout

Omdirigera hyresgäster till app.settleinto.io/ert-varumärke. De väljer paket, verifierar inkomst och registrerar sig. Ni får webhooks. Noll frontend-arbete.

Sandboxmiljö

Testa innan ni går live. Alla funktioner tillgängliga utan kostnad.

Endpoint

Använd https://sandbox.api.settleinto.io istället för api.settleinto.io för alla testförfrågningar.

Test-API-nycklar

Tillhandahålls vid partnerregistrering. Börja med sk_sandbox_test för grundläggande testning.

Omedelbar aktivering

Tjänster aktiveras omedelbart i sandbox (ingen 5-dagarsväntan). Perfekt för automatiserad testning och demos.

Inga riktiga kostnader

Testa hur mycket ni vill. Inget kreditkort krävs, noll kostnader, noll påverkan på produktion.

Redo att integrera?

Få API-åtkomst, sandbox-autentiseringsuppgifter och dokumentation. Vi hör av oss inom 24 timmar.

Få API-åtkomst