BankID — Signeringsflöde

BankID-signering fungerar som inloggning — bara start-endpointen skiljer sig, och /sign skickar din body oförändrad till BankID, så du base64-kodar texterna själv.

1. Starta signeringsordern

curl -X POST https://sandbox-api.cerrtify.com/service/bankid/sign \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{
    "endUserIp": "192.168.0.1",
    "userVisibleData": "R29ka8Okbm4gw7Z2ZXJmw7ZyaW5nZW4gYXYgNTAwIGtyIHRpbGwgQWNtZQ==",
    "userNonVisibleData": "<base64 of the canonical document>"
  }'

• userVisibleData — det användaren ser i BankID-appen, base64-kodat av dig (UTF-8-text; exemplet är "Godkänn överföringen av 500 kr till Acme"). Högst 1 500 tecken efter kodning. Till skillnad från /auth kodar servern inte texten åt dig.
• userNonVisibleData — base64-kodad binärdata som inte visas för användaren men som signaturen binder till. Valfritt.

2. Rendera QR + collect

Visa QR-koden precis som vid inloggning — GET /service/bankid/qr-code?orderRef=… fungerar även för signeringsordrar (BankID — QR-kod) — och polla /collect som i autentiseringsflödet. Vid complete innehåller fältet completionData.signature BankID-signaturen som du sparar.