ZignSec

Account & Settings

The MyAccount API is for the customer´s self-management of own settings.

APIs

GET (all) from https://env.zignsec.com/v2/myaccount/settings
GET from https://env.zignsec.com/v2/myaccount/settings/settingname
POST to https://env.zignsec.com/v2/myaccount/settings/settingname
DELETE from https://env.zignsec.com/v2/myaccount/settings/settingname
   where env is api or test and settingname is the name of a specific setting.

List of Settings

  • DefaultLanguage – Changes the user interface language for web forms shown by ZignSec. For example, if a customer mainly uses the Swedish BankID ZignSec will set this setting to SV for best user experience. If DefaultLanguage is not set EN is used. The code format should be the 2-letter ISO 639-1 language code, case-insenitive.
  • EID_Webhook_PROD – (for prod environment) If this url is present success and error results will be POST:ed to the url.
  • EID_Webhook_TEST – (for test environment) If this url is present success and error results will be POST:ed to the url.
  • TestSeLookupPerson – Add extra Swedish test persons for LookupPerson for your merchant.
  • TestDkLookupPerson – Add extra Danish test persons for LookupPerson for your merchant.

Note: The above test persons string should be formatted as a string with persons joined by the character | where each person strings contains: personalnumber; firstname; lastname; address; address2; postalcode; city An example (two Danish test persons): 0608914472; Trude; Berg; Mengvej 91;; 6094; Hejls | 1204001139; Tito; Kristoffersen; Eskj\u00e6rvej 6; Eskj\u00e6r; 7870; Roslev And even larger test cache example can be found here.

GET myaccount/settings

This example demonstrates how to get all stored settings on your account.

Request Example:

            GET https://test.zignsec.com/v2/myaccount/settings HTTP/1.1
Authorization: YOUR-KEY

        

Response is of content-type “application/json; charset=utf-8”, in this case :

            {
  "test2": "testing_testing",
  "test3": "23'45l cv89\u00f6\\\u00a3\u20ac@9!\"#\u00a7\u00bd",
  "TestDkLookupPerson": "0608914472; Trude; Berg; Mengvej 91;; 6094; Hejls |  1204001139; Tito; Kristoffersen; Eskj\u00e6rvej 6; Eskj\u00e6r; 7870; Roslev"
}
        

GET myaccount/settings/{settingName}

The example below demonstrates the retrieval of the TestDkLookupPerson setting.

Request Example:

            GET https://test.zignsec.com/v2/myaccount/settings/testdklookupperson HTTP/1.1
Authorization: YOUR-KEY

        

Response is of content-type “plain/text”, in this case:

0608914472; Trude; Berg; Mengvej 91;; 6094; Hejls |
1204001139; Tito; Kristoffersen; Eskjærvej 6; Eskjær; 7870; Roslev |
2202132121; Thom; Gregersen; Jættehøjen 57; ; 8240; Risskov |
1904450040; Tina; Danielsen; Sundbakken 31; ; 5700; Svendborg

POST myaccount/settings/{settingName}

The below example sets setting test3 to the new value “23’45l cv89ö\£€@9!”#§½.“, a string containing unusual characters as a demonstration. Notice how the string needs to be base64-encoded in the http body below.

Request:

            POST https://test.zignsec.com/v2/myaccount/settings/test3 HTTP/1.1
Content-Length: 27
Content-Type: application/json; charset=UTF-8
Authorization: YOUR-KEY

{"newValue":"MjMnNDVsIGN2ODnDtlzCo+KCrEA5ISIjwqfCvQ=="}


        

DELETE myaccount/settings/{settingName}

The below example detetes setting ‘test3’ for the current customer.

Request:

            DELETE https://test.zignsec.com/v2/myaccount/settings/test3 HTTP/1.1
Authorization: YOUR-KEY

        

A larger example of setting TestDkLookupPerson

This data could also be used for Swdedish test persons in setting TestSeLookupPerson, the personalnumbers are however not in the correct Swedish PNR-format.


1006713360; Tordis; Andersen; Mengvej 91;; 6094; Hejls |
1704534279; Tore; Frandsen; Eskjærvej 6; Eskjær; 7870; Roslev |
0210272659; Torgni; Jensen; Jættehøjen 57; ; 8240; Risskov |
2712771986; Tienna; Nørgaard; Sundbakken 31; ; 5700; Svendborg |
2904700972; Telse; Karlsen; Søndergårds Allé 103, 2. mf; ; 2760; Måløv |
0601811883; Thorleif; johansen; Flensborgvej 120; Broderup Mark; 6360; Tinglev |
2212464023; Thorkel; Klaussen; Skolegade 10A, st. tv; ; 9300; Sæby |
0302302789; Tibor; Thomsen; Gydebakken 9; ; 3520; Farum |
0811701213; Tor; Kjeldsen; Øster Hessel 40; Løjt Kirkeby; 6200; Aabenraa |
2111681540; Telse; Overgaard; Torvet 17; ; 9370; Hals |
2407083223; Theiss; Martinssen; Hovedvejen 119; ; 4720; Præstø |
0106630729; Thorgny; Lund; Havremarksvej 6; ; 8462; Harlev J |
0303604427; Trohn; Mikkelsen; Kålagervej 10; ; 2300; København S |
1907682937; Taj; Toft; Kåvervej 2; Sønderho; 6720; Fanø |
0901091456; Tinella; Steffensen; Coldingvej 304; ; 8732; Hovedgård |
2601932820; Thilde; Mortensen; Vestervænget 27; Vonsild; 6000; Kolding |
2911482523; Tordur; Klaussen; Skallevænget 5; ; 4760; Vordingborg |
1408082812; Thilda; Lind; Allegade 21 G; ; 2000; FREDERIKSBERG |
1511193108; Tonya; Bertelsen; Sundbakken 32; ; 5700; Svendborg |
0811723318; Thuri; Hermanssen; Luthersvej 47, st. tv; ; 7000; Fredericia |
0608914472; Trude; Berg; Mengvej 91;; 6094; Hejls |
1204001139; Tito; Kristoffersen; Eskjærvej 6; Eskjær; 7870; Roslev |
2202132121; Thom; Gregersen; Jættehøjen 57; ; 8240; Risskov |
1904450040; Tina; Danielsen; Sundbakken 31; ; 5700; Svendborg |
1306012191; Tade; Holm; Søndergårds Allé 103, 2. mf; ; 2760; Måløv |
1201050866; Tiina; Bach; Flensborgvej 120; Broderup Mark; 6360; Tinglev |
1607501608; Tescha; Lassen; Skolegade 10A, st. tv; ; 9300; Sæby |
1602491595; Tomas; Madsen; Gydebakken 9; ; 3520; Farum |
2804974109; Tau; Skov; Øster Hessel 40; Løjt Kirkeby; 6200; Aabenraa |
0407773967; Torkel; Kristoffersen; Torvet 17; ; 9370; Hals |
0803632190; Thinka; Schou; Hovedvejen 119; ; 4720; Præstø |
2801944295; Tommy; Nissen; Havremarksvej 6; ; 8462; Harlev J |
0412824428; Thine; Hansen; Kålagervej 10; ; 2300; København S |
0505250721; Tano; Holm; Kåvervej 2; Sønderho; 6720; Fanø |
1007431032; Trinke; Ravn; Coldingvej 304; ; 8732; Hovedgård |
2109072989; Torlif; Vestergaard; Vestervænget 27; Vonsild; 6000; Kolding |
0809300526; Thenna; Nissen; Skallevænget 5; ; 4760; Vordingborg |
1312462968; Tinnie; Gregersen; Allegade 21 G; ; 2000; FREDERIKSBERG |
2802620565; Thonny; Olsen; Sundbakken 32; ; 5700; Svendborg |
0209412403; Tem; Johansen; Luthersvej 47, st. tv; ; 7000; Fredericia |
0311614054; Thenna; Thorsen; Nørregade 6D; ; 9850; Hirtshals |
1005564890; Tiane; Hermansen; Enghavevej 7; Hvidbjerg; 7790; Thyholm |
0201930856; Tonita; Christensen; Svalevej 36; ; 7900; Nykøbing M |
1412421244; Thyra; Toft; Vardevej 18; Sig; 6800; Varde |
1003871732; Tiffany; Frandsen; Dyrskuevej 27, 2. 3; ; 9200; Aalborg SV |
1101422715; Tage; Østergaard; Holmstrupgårdvej 223; Holmstrup; 8210; Aarhus V |
2601771350; Tula; Søndergaard; Nygade 1A, 3.; ; 7400; Herning |
2906220615; Torjus; Bang; Industrivænget 2,2 tv; ; 9000; Aalborg |
3112383728; Traita; Whinter; Boulevarden 101,1 mf; ; 6800; Varde |
1906541690; Tiffanie; Lauridsen; Svinget 50; ; 9000; Aalborg |
1210000893; Trond; Hansen; Vestervænget 27; Vonsild; 6000; Kolding |
2505732851; Thorgot; Frederiksen; Skallevænget 6; ; 4760; Vordingborg |
0411131192; Tiane; Simonsen; Allegade 22 G; ; 2000; FREDERIKSBERG |
2309921960; Teresia; Mogensen; Sundbakken 33; ; 5700; Svendborg |
2912200759; Tyge; Bak; Luthersvej 48, st. tv; ; 7000; Fredericia |
2801473971; Thonny; Ravn; Nørregade 7D; ; 9850; Hirtshals |
0902452714; Tia; Danielsen; Enghavevej 8; Hvidbjerg; 7790; Thyholm |
1612541131; Tito; Dam; Svalevej 37; ; 7900; Nykøbing M |
2011153735; Thorkel; Thorsen; Vardevej 19; Sig; 6800; Varde |
1512042099; Toste; Skov; Dyrskuevej 28, 2. 3; ; 9200; Aalborg SV |
2309803923; Thorer; Davidsen; Holmstrupgårdvej 224; Holmstrup; 8210; Aarhus V |
0106011626; Tanya; Laursen; Nygade 2A, 3.; ; 7400; Herning |
0608954623; Thorgrim; Winther; Industrivænget 3,2 tv; ; 9000; Aalborg |
1506873323; Thommy; Danielsen; Boulevarden 102,1 mf; ; 6800; Varde |
2102833274; Tabitta; Frederiksen; Svinget 51; ; 9000; Aalborg