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

Identify request

Parameters

Service specific 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

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

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

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

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

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

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

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

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