Valtuutuspyynnön tunnisteen luonti ja käyttö

Valtuutuspyynnöille tulee määrittää varsinaisen tapahtuman tunnuksen (“sanoma-ID”) lisäksi valtuutuspyynnön tunniste. Valtuutuspyynnön tunniste tulee määrittää riippumatta siitä, luodaanko valtuutuspyyntö rajapinnan kautta DH-830-tapahtumilla vai manuaalisesti Datahubin käyttöliittymältä.

Valtuutuspyynnön tunnisteena tulee käyttää UUID-muotoista tunnusta. UUID-tunnusten luomiseksi löytyy verkkosivuja, joita voi hyödyntää valtuutuspyynnön tunnisteen luomisessa.

Toisin kuin tapahtuman tunnuksen, valtuutuspyynnön tunnisteen ei tarvitse kaikissa käyttötapauksissa olla täysin uniikki. Samaa valtuutuspyynnön tunnistetta voidaan käyttää saman asiakkaan useassa eri valtuutuspyynnössä, mikäli asiakkaalle tehdään kerralla useampi valtuutuspyyntö, jotka asiakas ohjataan hyväksymään valtuutuspalveluun osana osapuolen omaa palveluprosessia URL-ohjauksen avulla. Tällöin, kun asiakas ohjataan osapuolen palveluprosessista hyväksymään valtuutuspyynnöt valtuutuspalveluun, asiakas voi hyväksyä yhdellä ohjauksella kaikki valtuutuspyyntönsä, joille on määritetty sama valtuutuspyynnön tunniste. Tällöin asiakasta ei tarvitse ohjata palveluprosessin aikana useaan kertaan valtuutuspalveluun, mikäli asiakkaalle tehdään kerralla useita valtuutuspyyntöjä.

Mikäli pyynnöt halutaan tehdä asiakkaalle erillisinä prosesseina, tulee tällöin käyttää uniikkia tunnistetta jokaiselle valtuutuspyynnölle.

Koska valtuutuspyynnön ei tarvitse olla aina uniikki yllä kuvatun käyttötapauksen mukaisesti, valtuutuspyynnön tunnisteena ei suositella käytettävän valtuutuspyynnön sanomatunnusta, vaan nämä kaksi tunnistetta on hyvä pitää erillisinä tunnisteina.