Requests

iDIN Services

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

Identify Request

Parameters

Service specific parameters

Parameter	Type	Required	Recommended	Description
issuerID	string	yes		BIC code of the issuing bank of the consumer. The bank must support iDIN

Example request

{
  "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
}

Identify Response

Example response

{
    "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
}

Identify Push

Example push

{
   "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

Verify Request

Example request

{
  "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"
          }
        ]
      }
    ]
  }
}

Verify Response

Example response

{
    "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
}

Verify Push

Example push

{
   "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)

Login Request

Example request

{
  "ReturnURL": "https://www.buckaroo.nl",
  "ReturnURLCancel": "https://www.buckaroo.nl/annuleren",
  "ReturnURLError": "https://www.buckaroo.nl/mislukt",
  "ReturnURLReject": "https://www.buckaroo.nl/ge

weigerd",
  "continueonincomplete": "redirecttohtml",
  "Services": {
    "ServiceList": [
      {
        "Name": "Idin",
        "Action": "login",
        "Parameters": [
          {
            "Name": "issuerId",
            "Value": "INGBNL2A"
          }
        ]
      }
    ]
  }
}

Login Response

Example response

{
    "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
}

Login Push

Example push

{
   "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
   }
}