Requests

      Requests


        Article Summary

        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

        ParameterTypeRequiredRecommendedDescription
        issuerIDstringyesBIC 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 this article helpful?

        What's Next