StromSignup – Dokumentation

Denne side beskriver tilmeldingsformularen (index.html + form.js): felter og validering, bannere der vises ved retur fra MitID/betaling, og selve submit-flowet.

1. Konfiguration

Al konfiguration sættes i CONFIG-objektet øverst i form.js:

var CONFIG = {
    adressevaelgerToken: 'adressevaelger123',               // token fra confluence.sdfi.dk
    saveUrl:             'https://dev.modstroem.dk',         // UmbracoSaveUrl
    apiKey:              'GEgvf0O83Re',                      // UmbracoSaveApiKey (X-Api-Key header)
    mitIdBaseUrl:        'https://identifikationdev.modstroem.dk', // MitID base URL
    successUrl:          'https://peladev.modstroem.dk',     // redirect efter succesfuldt MitID-flow
    failUrl:             'https://peladev.modstroem.dk',     // redirect efter fejlet/afbrudt MitID-flow
    clientIp:            '127.0.0.1',                        // klient-IP sendt til SaveRecord
    cssUrl:              'https://peladev.modstroem.dk/site.css' // absolut URL til site.css — sendes som formUrl
};

2. Formularfelter

Skjulte systemfelter

Adresse

Situation

Til- og fravalg (toggles)

Personoplysninger

Betalingstype

3. Bannere ved retur fra MitID / betaling

Bannere vises øverst på siden (over formkortet) baseret på query string når brugeren vender tilbage:

4. Submit-flow

1. DOM-snapshot – HTML fra <main>-elementet fanges som UTF-8 base64 (clone0). Kun <main> sendes (ikke hele siden) for at undgå at Cloudflare WAF blokerer den store POST-body.
2. Formdata indsamles – alle navngivne inputs samles i et formData-objekt.
3. Payload bygges:

   {
     "identifier":   "<klient-genereret GUID>",
     "formId":       "AppForm",
     "formUrl":      "<window.location.pathname>",
     "clone0":       "<base64 af <main> HTML>",
     "formData":     { ... alle felter ... },
     "formDataJson": "{ ... JSON-streng ... }",
     "clientIp":     "<CONFIG.clientIp>"
   }

4. SaveRecord – POST {saveUrl}/umbraco/api/MitIdApi/SaveRecord med headerne Content-Type: application/json og X-Api-Key: {apiKey}.
   Gemmer en record på Modstrøm-sitet med alle formdata, så den kan hentes af andre applikationer senere i processen.
   Fejler kaldet vises en rød fejlbanner og submit-knappen genaktiveres — brugeren blokeres ikke men omdirigeres heller ikke.
5. Redirect til MitID – ved succesfuldt svar navigeres til:

   {mitIdBaseUrl}/MitId/Index
     ?identifier={identifier}
     &ticks={DateTime.UtcNow.Ticks-ækvivalent}
     &successUrl={CONFIG.successUrl}
     &failUrl={CONFIG.failUrl}

   userType sendes ikke — den modtagende applikation defaulter til private.

6. Betaling / kundeoprettelse – efter MitID:
   • mobilepay, applepay, cardfrisbii → viderestilles til betalingsudbyder og tilbage igen.
   • betalingsservice → kunde oprettes direkte efter MitID (ingen betalings-redirect).
7. Retur – brugeren lander tilbage på siden, og et banner (afsnit 3) rapporterer resultatet.

5. Test

MitID testbruger

Betalingstest

I testmiljøet kan kun disse to betalingstyper gennemføres:

• Betalingsservice
• Betalingskort (cardfrisbii) – indtast testkortoplysninger når betalingsudbyderen beder om det

6. cURL-eksempel

curl -X POST https://dev.modstroem.dk/umbraco/api/MitIdApi/SaveRecord \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: GEgvf0O83Re" \
  -d '{
    "identifier": "b0c1d2e3-f4a5-4b6c-8d7e-9f0a1b2c3d4e",
    "formId":     "AppForm",
    "formUrl":    "/",
    "clone0":     "",
    "clientIp":   "127.0.0.1",
    "formData": {
      "adresse":           "Jagtvej 120, 2200 København N",
      "streetName":        "Jagtvej",
      "houseNumber":       "120",
      "zipCode":           "2200",
      "cityName":          "København N",
      "FlytteValg":        "leverandørskifte",
      "name":              "Test Testesen",
      "email":             "test@example.dk",
      "emailconfirm":      "test@example.dk",
      "telefonnummer":     "12345678",
      "BetalingstypeValg": "mobilepay"
    },
    "formDataJson": "{\"name\":\"Test Testesen\",\"email\":\"test@example.dk\"}"
  }'

7. Prisdata (GetElPrices)

Prisdata hentes per elProductGuid fra Modstrøm's pris-API. Brug E19F93CC-8A31-4432-AB10-9398C1022444 som produktguid (samme som den skjulte elProductGuid-felt i formularen).

Endpoints

cURL-eksempel

curl --location 'https://apidev.modstroem.dk/PriceController/GetElPrices \
  ?apiKey=<din-api-nøgle> \
  &encryptionKey=ModInfinity \
  &product=E19F93CC-8A31-4432-AB10-9398C1022444'

Respons

Responsen indeholder topniveau-felter samt et ElPrices-array med alle delpriser. Vigtige topniveau-felter:

ElPrices-arrayet indeholder delpriserne opdelt på ProductType og Region (1 = øst, 2 = vest):