General

iDIN is a service from the Dutch banks that allows consumers to identify themselves. iDIN allows consumers to use the same account across multiple platforms, greatly reducing the number of accounts they have to create and remember.

iDIN offers 3 services:

Full identification- This returns all information registered at the bank

Age verification - This returns if the consumer is 18+ years old

Login - This returns a unique username for that consumer

Servicecode and actions

The service code for iDIN is 'idin'

There are 3 actions available:

For full identification, use the action "identify"

For age verification, use the action "verify"

For login, use the action "login"

Testing

There is a sandbox API for iDIN. In order to create a test iDIN request, you need to use the issuer "BANKNL2Y" instead of the actual bank

Identify

The identify action returns all available information from the issuing bank. This includes the following information:

  • Gender
  • Last name
  • Initials
  • Date of birth
  • Phone number
  • Bin (unique ID per consumer)
  • Address
  • Country
View in playground

Request


JSON Gateway request

JSON

copy
{
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
  "ReturnURLError": "https://www.buckaroo.nl/mislukt",
  "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
  "Services": {
    "Global": null,
    "ServiceList": [
      {
        "Name": "Idin",
        "Action": "identify",
        "Version": 0,
        "Parameters": [
          {
            "Name": "issuerId",
            "GroupType": "",
            "GroupID": "",
            "Value": "BANKNL2Y"
          }
        ]
      }
    ]
  },
  "CustomParameters": null,
  "AdditionalParameters": null
}

Response


JSON Gateway response

JSON

copy
{
    "Key": "A2487CF2BA574269994D9AXXXXXXXXXX",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": {
            "Code": "S002",
            "Description": "An additional action is required: Redirect to Idin."
        },
        "DateTime": "2021-05-14T13:20:04"
    },
    "RequiredAction": {
        "RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=958E59ED9B9542C0BB711EXXXXXXXXXX",
        "RequestedInformation": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "ServiceCode": "IDIN",
    "IsTest": false,
    "ConsumerMessage": null
}

Push


JSON Push response

JSON

copy
{
   "DataRequest":{
      "Key":"A2487CF2BA574269994D9AXXXXXXXXXX",
      "Invoice":null,
      "ServiceCode":"IDIN",
      "ActionCode":"Identify",
      "Status":{
         "Code":{
            "Code":190,
            "Description":"The request was successful."
         },
         "SubCode":null,
         "DateTime":"2021-05-14T13:20:35"
      },
      "IsTest":false,
      "Order":null,
      "Currency":null,
      "AmountDebit":0.0,
      "Services":[
         {
            "Name":"IDIN",
            "Action":null,
            "Parameters":[
               {
                  "Name":"Gender",
                  "Value":"Male"
               },
               {
                  "Name":"LegalLastName",
                  "Value":"Doe"
               },
               {
                  "Name":"Initials",
                  "Value":"J"
               },
               {
                  "Name":"DateOfBirth",
                  "Value":"1990-01-01"
               },
               {
                  "Name":"PhoneNumber",
                  "Value":"0031-0612345678"
               },
               {
                  "Name":"Bin",
                  "Value":"NLINGBVSNI+fGtTjhdWvBAXm8tYw86ZWNirx74ltWwAkmD+iWZEez+QiuQ1jWasferthkyilfcdroipq37BXWoPMuQJg=="
               },
               {
                  "Name":"Street",
                  "Value":"Test Street"
               },
               {
                  "Name":"HouseNumber",
                  "Value":"1"
               },
               {
                  "Name":"PostalCode",
                  "Value":"1234AB"
               },
               {
                  "Name":"City",
                  "Value":"Test City"
               },
               {
                  "Name":"Country",
                  "Value":"NL"
               }
            ],
            "VersionAsProperty":1
         }
      ],
      "CustomParameters":null,
      "AdditionalParameters":null,
      "MutationType":0,
      "IssuingCountry":null,
      "StartRecurrent":false,
      "Recurring":false,
      "CustomerName":null,
      "PayerHash":null,
      "PaymentKey":null
   }
}

Verify

The verify action verifies if a consumer is 18 years or older. This includes the following information:

  • Bin (unique ID per consumer
  • Is Eighteen or Older
View in playground

Request


JSON Gateway request

JSON

copy
{
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
  "ReturnURLError": "https://www.buckaroo.nl/mislukt",
  "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
  "continueonincomplete": "redirecttohtml",
  "Services": {
    "ServiceList": [
      {
        "Name": "Idin",
        "Action": "verify",
        "Parameters": [
          {
            "Name": "issuerId",
            "Value": "INGBNL2A"
          }
        ]
      }
    ]
  }
}

Response


JSON Gateway response

JSON

copy
{
    "Key": "AF313D77303C4C049ADACEXXXXXXXXXX",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": {
            "Code": "S002",
            "Description": "An additional action is required: Redirect to Idin."
        },
        "DateTime": "2021-05-14T13:37:35"
    },
    "RequiredAction": {
        "RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=0E945F379AE044759A80DBXXXXXXXXXX",
        "RequestedInformation": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "ServiceCode": "IDIN",
    "IsTest": false,
    "ConsumerMessage": null
}

Push


JSON Push response

JSON

copy
{
   "DataRequest":{
      "Key":"AF313D77303C4C049ADACEXXXXXXXXXX",
      "Invoice":null,
      "ServiceCode":"IDIN",
      "ActionCode":"Verify",
      "Status":{
         "Code":{
            "Code":190,
            "Description":"The request was successful."
         },
         "SubCode":null,
         "DateTime":"2021-05-14T13:38:21"
      },
      "IsTest":false,
      "Order":null,
      "Currency":null,
      "AmountDebit":0.0,
      "Services":[
         {
            "Name":"IDIN",
            "Action":null,
            "Parameters":[
               {
                  "Name":"ConsumerBIN",
                  "Value":"NLINGBVSNI+fGtTjhdWvBAXm8tYw86ZWNirx74ltWwAkmD+iWZEez+QiuQ1fksndafndsf5f2oipq37BXWoPMuQJg=="
               },
               {
                  "Name":"IsEighteenOrOlder",
                  "Value":"True"
               }
            ],
            "VersionAsProperty":1
         }
      ],
      "CustomParameters":null,
      "AdditionalParameters":null,
      "MutationType":0,
      "IssuingCountry":null,
      "StartRecurrent":false,
      "Recurring":false,
      "CustomerName":null,
      "PayerHash":null,
      "PaymentKey":null
   }
}

Login

The login call returns a unique ID for each consumer. This returns the following information:

  • Bin (unique ID per consumer)
View in playground

Request


JSON Gateway request

JSON

copy
{
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
  "ReturnURLError": "https://www.buckaroo.nl/mislukt",
  "ReturnURLReject": "https://www.buckaroo.nl/geweigerd",
  "continueonincomplete": "redirecttohtml",
  "Services": {
    "ServiceList": [
      {
        "Name": "Idin",
        "Action": "login",
        "Parameters": [
          {
            "Name": "issuerId",
            "Value": "INGBNL2A"
          }
        ]
      }
    ]
  }
}

Response


JSON Gateway response

JSON

copy
{
    "Key": "7919DEA7D77E493E90AB32DC194ADFA1",
    "Status": {
        "Code": {
            "Code": 791,
            "Description": "Pending processing"
        },
        "SubCode": {
            "Code": "S002",
            "Description": "An additional action is required: Redirect to Idin."
        },
        "DateTime": "2021-05-14T13:46:25"
    },
    "RequiredAction": {
        "RedirectURL": "https://checkout.buckaroo.nl/html/redirect.ashx?r=3B27471845D04227B469BAXXXXXXXXXX",
        "RequestedInformation": null,
        "Name": "Redirect",
        "TypeDeprecated": 0
    },
    "Services": null,
    "CustomParameters": null,
    "AdditionalParameters": null,
    "RequestErrors": null,
    "ServiceCode": "IDIN",
    "IsTest": false,
    "ConsumerMessage": null
}

Push


JSON Push response

JSON

copy
{
   "DataRequest":{
      "Key":"7919DEA7D77E493E90AB32XXXXXXXXXX",
      "Invoice":null,
      "ServiceCode":"IDIN",
      "ActionCode":"Login",
      "Status":{
         "Code":{
            "Code":190,
            "Description":"The request was successful."
         },
         "SubCode":null,
         "DateTime":"2021-05-14T13:47:34"
      },
      "IsTest":false,
      "Order":null,
      "Currency":null,
      "AmountDebit":0.0,
      "Services":[
         {
            "Name":"IDIN",
            "Action":null,
            "Parameters":[
               {
                  "Name":"ConsumerBIN",
                  "Value":"NLINGBVSNI+fGtTjhdWvBAXm8tYw86ZWNirx74ltWwAkmD+iWZEez+QiuQ1jW3dfsansdjfnewqPMuQJg=="
               }
            ],
            "VersionAsProperty":1
         }
      ],
      "CustomParameters":null,
      "AdditionalParameters":null,
      "MutationType":0,
      "IssuingCountry":null,
      "StartRecurrent":false,
      "Recurring":false,
      "CustomerName":null,
      "PayerHash":null,
      "PaymentKey":null
   }
}