Requests

Requests


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
Base JSON request

Use the base request as instructed on this page

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
Basic parameters

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

Parameters

Basic parameters

Example request

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

Parameters

Basic parameters

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

Parameters

Basic parameters

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

Parameters

Basic parameters

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

Parameters

Basic parameters

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

Parameters

Basic parameters

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": "login",
        "Parameters": [
          {
            "Name": "issuerId",
            "Value": "INGBNL2A"
          }
        ]
      }
    ]
  }
}

Login response

Parameters

Basic parameters

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

Parameters

Basic parameters

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

Was dit artikel nuttig?

What's Next