Skip to content
On this page

W2 Data Ekyc SCANDI 025

Compatible Cases

About the service

This service can be used for identity checks in Sweden, Norway and Denmark. It uses Bank ID to confirm an individual's identity.

This service works slightly differently from our other services in that it runs asynchronously and has a two step process. First you will need to send us the identity to check. We will process this information and return a URL for Bank ID verification. The user will need to navigate to this URL in a browser and complete the Bank ID process there. Once this form is completed the user will be redirected to a URL of your choice.

When the Bank ID form is complete W2 will send a notification with the results of the identity check. We can either notify by email or send an HTTP POST to an endpoint of your choice.

You can force the service to skip the Bank ID process by specifying the SkipScandiBankId QueryOption. This will return the result immediately. The response will only contain information from our supplier's database and not a full Bank ID check but is still considered a full two plus two check.

Product Code: W2_DATA_EKYC_SCANDI_025

Does this service leave a credit search Footprint? No

Configuration

Before using this service you will need to let W2 know the following:

  1. Notification Preference: Whether you would prefer to be notified by email, HTTP POST or both.
  2. Email Address: If you want to be notified by email then we need to know which email address to use.
  3. Notification URL: If you want to be notified by HTTP POST then we need to know a URL to use. see here for more information.
  4. FormattingType: By default if we send an HTTP POST it will be JSON, we can also do XML if prefered.

Request

For this service we require the following information. Please note that:

  1. Most of the required data is supplied in the Data object as usual, but we also require a redirect URL be supplied in the QueryOptions see below.
  2. In an actual SOAP request the data should be supplied in alphabetical order.

Data

Property NameTypeLengthOptional/MandatoryNotes
ForenameString15Mandatory
SurnameString15Mandatory
CityString30Mandatory
CountryString3MandatoryThis must be a 3 character ISO Country code. This service only accepts SWE, DNK or NOR. i.e. Sweden, Denmark or Norway
HouseNameString30Mandatory if no HouseNumber given
HouseNumberString30Mandatory if no HouseName given
StreetString30Mandatory
RegionString30Optional
Post CodeString10Mandatory
Day of BirthInteger2Mandatory
Month of BirthInteger2Mandatory
Year of BirthInteger4Mandatory
NationalIdString15Optional
DateOfBirthMatchThresholdInteger2OptionalThis can be used to specify the percentage match for date of birth matches. For example if you put 90 in this field then we will consider a 90% match on date of birth to be a pass, when we calculate the interpret result.
NameQueryMatchThresholdInteger2OptionalThis can be used to specify the percentage match for name matches. For example if you put 90 in this field then we will consider a 90% match on name to be a pass, when we calculate the interpret result.

Options

Property NameOptional/MandatoryNotes
RedirectUrlMandatoryThis is the URL the user will be redirected to after they have filled in the Bank ID form.
****
SkipScandiBankIdOptionalIf this is set to "true" then the service will not supply a url for a Bank ID form. It will simply send whatever information is available as per your notification settings.
AddressMatchThresholdOptional0-100, specifies the required level of matching in the address.

Example Request

An example request might look like this

json
{
	"Data": {
		"City": "BILLDAL",
		"Country": "SWE",
		"DayOfBirth": 4,
		"Forename": "SIRI",
		"HouseNumber": "47",
		"MonthOfBirth": 6,
		"Postcode": "21725",
		"Street": "ERIKSBO VÄSTERGÄRDE 47",
		"Surname": "Petersen",
		"YearOfBirth": 1952,
		"NationalId": "23434645634"
	},
	"Options": {
		"RedirectUrl": "https://MY_WEBSITE"
	}
}

Response

Example Response

The response for this service simply contains a URL for the Bank ID form and a message. For example:

json
"w2DataEkycScandi025Result": {
	"bankIdFormUrl": "https://test.zignsec.com/v2/Hosted/some guid here",
	"interpretResult": "NotPerformed",
	"message": "Please complete the form at the supplied URL."
}

Exampe Response 2 bank id check skipped

The response from a request where the bank id check is skipped contains a two plus two result. For example:

json
"w2DataEkycScandi025Result": {
      	"interpretResult": "Pass",
      	"message": "Name and Address match found.",
      	"twoPlusTwoCheckResult": {
      		"matchResult": "OnePlusOne",
      		"nameAndAddressMatch": true,
      		"nameAndDateOfBirthMatch": false
      	}
      }

Example Response 3 No Interpretation, successful transaction

The transaction information will simply indicate the transaction was successful as no actual interpretation has been performed.

json
"serviceTransactions": [{
       		"haltTriggered": false,
       		"service": "W2_DATA_EKYC_SCANDI_025",
       		"serviceInterpretResult": "Fail",
       		"serviceTransactionResult": "Success",
       		"validationResult": "Pass"
       	}
       ]

Completing the Request

Once the query has finished, you should be returned a generated URL within the BankIdFormUrl object, you can use this to navigate to the page, and on this page there is a Bank ID login page. Once the user has successfully logged into their Bank ID (and by doing so, authorised you to use their data), the page will redirect to the URL you have previously specified. The system will then return a notification to you in the form of an e-mail, or a POST to an endpoint.

Notfication

When the Bank ID form has been completed W2 will attempt to notify you. We can either send an email or POST to an endpoint.

The email will look something like this:

/ missing image /

The post will be JSON and contains information from the verification process. We can also supply in XML if required, contact W2 support to configure this. The following is an example JSON response:

POST

json
{  
   "EventType":"ApiV3ServiceResponse",
   "ClientReference":"The client reference from the original call",
   "CallReference":"The call reference from the original call",
   "ClientSubaccount":"The client subaccount from the original call",
   "ServiceResults":{  
      "W2DataEkycScandi025":{  
         "InterpretResult":"PASS | FAIL | REFER | ERROR",
         "CallId":"A unique identifier for the call",
         "TwoPlusTwoResult":{  
            "MatchResult":"TwoPlusTwo | TwoPlusOne | OnePlusOne",
            "NameAndAddressMatch": true | false,
            "NameAndDateOfBirthMatch":true | false,
            "IndependentDataSources":true | false | null
         },
         "Message":"The status of the response",
         "NameAndAddressMessage":"The status of the name and address match in the two plus two check",
         "NameAndDateOfBirthMessage":"The status of the name and date of birth match in the two plus two check"
      }
   },
   "TransactionInformation":{  
      "ServiceTransactions":[  
         {  
            "Service":"W2_DATA_EKYC_SCANDI_025",
            "ServiceInterpretResult":"PASS | FAIL | REFER | ERROR",
            "ServiceTransactionResult":"Success | Fail"
         }
      ]
   }
}