BankID — Autentiseringsflöde

Starta en order, rendera den rullande QR-koden och polla tills användaren loggat in.

BankID-autentiseringsflödet består av tre faser: start, rendering och collect.

1. Starta ordern

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/auth \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{
    "endUserIp": "192.168.0.1",
    "userVisibleData": "Sign in to Acme"
  }'

Svar:

{
  "orderRef": "131daac9-16c6-4618-beb0-365768f37288",
  "autoStartToken": "7c40b5c9-fa74-49cf-b98c-bfe651f9a7c6",
  "qrStartToken": "67df3917-fa0d-44e5-b327-edcc928297f8",
  "qrStartSecret": "d28db9a7-4cde-429e-a983-359be676944c"
}

Spara orderRef på serversidan, kopplad till användarens session.

2. Rendera den rullande QR-koden

QR-innehållet ändras varje sekund. Beräkna inte HMAC:en själv — anropa proxyn från din backend:

curl "https://sandbox-api.cerrtify.com/service/bankid/qr-code?orderRef=<orderRef>" \
  -H "X-API-Key: cert_..."

Svar:

{ "qrData": "bankid.67df3917-fa0d-44e5-b327-edcc928297f8.0.dee5cd3f..." }

Polla denna endpoint ungefär en gång per sekund och rendera om QR-koden från qrData. När användaren har skannat tar BankID-appen över. Detaljer, fel och kodexempel: BankID — QR-kod.

3. Polla tills ordern är klar

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/collect \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{"orderRef":"<orderRef>"}'

Statusar:

pending — fortsätt polla (varannan sekund rekommenderas).
complete — klart. Svaret innehåller completionData med användarens personnummer, namn, IP-adress med mera.
failed — användaren avbröt eller ordern gick ut på tid. Sluta polla.

4. Avbryt (valfritt)

Om användaren lämnar sidan, avbryt ordern:

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/cancel \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{"orderRef":"<orderRef>"}'

Testpersonnummer (endast sandbox)

I sandbox klickar du först på Aktivera BankID i sandbox i dashboarden; då läggs Cerrtifys testcertifikat till, som går mot BankID:s testmiljö. Du behöver ett test-BankID — BankID-appen inställd för test och en testanvändare — ett riktigt BankID fungerar inte där. Se BankID:s testinstruktioner och Miljöer.