LagDinBridgeLagDinBridge

Stripe → Fiken

Teknisk integrasjonsbeskrivelse for API-gjennomgang

Oversikt

LagDinBridge synkroniserer Stripe-betalinger til Fiken automatisk. Charges, refunds og subscriptions overføres som fakturaer og kreditnotaer med korrekt MVA og valutakonvertering.

Autentisering

Stripe

  • API-nøkkel: sk_live_* (produksjon) eller sk_test_* (test)
  • Webhook-signaturverifisering med HMAC-SHA256
  • Webhook-endpoint mottar events i sanntid

Fiken

  • Bearer token: Authorization: Bearer {api_token}
  • Base URL: https://api.fiken.no/api/v2
Stripe-nøkler og Fiken API-token lagres kryptert med Fernet (AES-128-CBC). Webhook-signaturer verifiseres for å forhindre forfalskning.

API-endepunkter

Stripe (innkommende events)

MetodeEndepunktFormål
POST/webhookMottar charge.succeeded, charge.refunded, invoice.paid events
GET/v1/charges/{id}Hent betalingsdetaljer (ved behov)
GET/v1/customers/{id}Hent kundedata (navn, e-post, adresse)

Fiken (utgående API-kall)

MetodeEndepunktFormål
GET/api/v2/companies/{slug}/contacts?name={name}Søk kontakt
POST/api/v2/companies/{slug}/contactsOpprett kontakt
POST/api/v2/companies/{slug}/invoicesOpprett faktura
POST/api/v2/companies/{slug}/invoices/{id}/paymentsRegistrer innbetaling
POST/api/v2/companies/{slug}/creditNotesOpprett kreditnota

Dataflyt

1

Stripe webhook-event mottas

charge.succeeded, charge.refunded eller invoice.paid

2

Verifiser webhook-signatur

HMAC-SHA256 med webhook signing secret — avvis ugyldige signaturer

3

Sjekk idempotens

stripe_fiken_mappings sjekker om charge allerede er bokført

4

Hent Stripe-kundedata

Navn, e-post, adresse og landskode fra Stripe Customer-objekt

5

Finn eller opprett Fiken-kontakt

Søk på e-post/navn. Opprett med full adresse hvis ikke funnet.

6

Beregn MVA

Basert på kundens land: norsk MVA, EU reverse charge, eller eksport

7

Valutakonvertering

Konverter fra originalvaluta (USD, EUR, GBP etc.) til NOK

8

Opprett betalt faktura i Fiken

Faktura + innbetaling. Ved refusjon: kreditnota.

9

Lagre mapping

Stripe charge_id → Fiken invoice_id for idempotens

Valutakonvertering

ValutaNavnKilde
USDUS DollarNorges Bank dagskurs
EUREuroNorges Bank dagskurs
GBPBritiske pundNorges Bank dagskurs
SEKSvenske kronerNorges Bank dagskurs
DKKDanske kronerNorges Bank dagskurs
NOKNorske kronerIngen konvertering

Beløpet fra Stripe konverteres til NOK basert på dagskurs. Stripe oppgir beløp i minste valutaenhet (cents/øre) — LagDinBridge konverterer automatisk.

For produksjonsmiljø brukes Norges Bank sine offisielle valutakurser. I testmodus brukes faste placeholder-kurser.

MVA-håndtering

Fiken-kodeSatsBeskrivelse
HIGH25 %Standard norsk MVA (kunde i Norge)
MEDIUM15 %Næringsmidler
LOW12 %Transport, overnatting
EXEMPT0 %Fritatt
EXEMPT_EXPORT0 %Eksport (kunde utenfor Norge)
EXEMPT_REVERSE_CHARGE0 %EU B2B med VAT-nummer (reverse charge)

MVA bestemmes av kundens faktureringsland. Norske kunder: 25 % standard. EU B2B med gyldig VAT-nummer: reverse charge (0 %). Kunder utenfor EU: eksportfritak (0 %).

Refusjonshåndtering

Med originalfaktura

Kreditnota opprettes i Fiken med referanse til den opprinnelige fakturaen.

Uten originalfaktura

Frittstående kreditnota opprettes hvis originalfaktura ikke finnes i mapping.

Delvis refusjoner støttes. Beløpet krediteres med proporsjonell MVA-fordeling.

Sikkerhet

Kryptert lagring

Alle API-nøkler og tokens krypteres med Fernet (AES-128-CBC + HMAC-SHA256) før lagring

HTTPS-only

All kommunikasjon med eksterne API-er skjer over TLS 1.2+ — ingen ukryptert trafikk

Tenant-isolering

Hver brukers credentials er isolert — ingen deling av nøkler mellom kunder

Feilhåndtering

Circuit breaker, exponential backoff (5 forsøk), og respekt for rate limits

Forutsetninger

  • Aktiv Stripe-konto med API-nøkler
  • Aktiv Fiken-konto med API-modul
  • Webhook-endpoint konfigurert i Stripe Dashboard
  • LagDinBridge-konto hos Technobridge

LagDinBridge er utviklet av Technobridge

Spørsmål? Kontakt oss på post@technobridge.no