Chilkat Online Tools

VB.NET / GP-API Collection / AUT_1.1 3DS2 Initiate

Back to Collection Items

' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.

Dim http As New Chilkat.Http
Dim success As Boolean

' Use this online tool to generate code from sample JSON: Generate Code to Create JSON

' The following JSON is sent in the request body.

' {
'   "three_ds": {
'     "source": "BROWSER",
'     "preference": "NO_PREFERENCE"
'   },
'   "account_name": "{{acc_name}}",
'   "channel": "CNP",
'   "amount": "5",
'   "currency": "EUR",
'   "country": "US",
'   "method_url_completion_status": "YES",
'   "payment_method": {
'     "id": "{{pmt_id}}"
'   },
'   "order": {
'     "time_created_reference": "2019-04-26T10:19:32.552327Z",
'     "amount": "1001",
'     "currency": "EUR",
'     "reference": "3400dd37-101d-4940-be15-3c963b6109b3",
'     "address_match_indicator": "false",
'     "shipping_address": {
'       "line1": "Apartment 852",
'       "line2": "Complex 741",
'       "line3": "House 963",
'       "city": "Chicago",
'       "postal_code": "50001",
'       "state": "IL",
'       "country": "840"
'     },
'     "gift_card_count": "01",
'     "gift_card_currency": "EUR",
'     "gift_card_amount": "25000",
'     "delivery_email": "james.mason@example.com",
'     "delivery_timeframe": "ELECTRONIC_DELIVERY",
'     "shipping_method": "ANOTHER_VERIFIED_ADDRESS",
'     "shipping_name_matches_cardholder_name": "true",
'     "preorder_indicator": "MERCHANDISE_AVAILABLE",
'     "preorder_availability_date:": "2019-04-18",
'     "reorder_indicator": "FIRST_TIME_ORDER",
'     "transaction_type": "GOODS_SERVICE_PURCHASE"
'   },
'   "payer": {
'     "reference": "6dcb24f5-74a0-4da3-98da-4f0aa0e88db3",
'     "account_age": "LESS_THAN_THIRTY_DAYS",
'     "account_creation_date": "2019-01-10",
'     "account_change_date": "2019-01-28",
'     "account_change_indicator": "THIS_TRANSACTION",
'     "account_password_change_date": "2019-01-15",
'     "account_password_change_indicator": "LESS_THAN_THIRTY_DAYS",
'     "home_phone": {
'       "country_code": "44",
'       "subscriber_number": "123456789"
'     },
'     "work_phone": {
'       "country_code": "44",
'       "subscriber_number": "1801555888"
'     },
'     "payment_account_creation_date": "2019-01-01",
'     "payment_account_age_indicator": "LESS_THAN_THIRTY_DAYS",
'     "suspicious_account_activity": "NO_SUSPICIOUS_ACTIVITY",
'     "purchases_last_6months_count": "03",
'     "transactions_last_24hours_count": "01",
'     "transaction_last_year_count": "05",
'     "provision_attempt_last_24hours_count": "01",
'     "shipping_address_time_created_reference": "2019-01-28",
'     "shipping_address_creation_indicator": "THIS_TRANSACTION"
'   },
'   "payer_prior_three_ds_authentication_data": {
'     "authentication_method": "FRICTIONLESS_AUTHENTICATION",
'     "acs_transaction_reference": "26c3f619-39a4-4040-bf1f-6fd433e6d615",
'     "authentication_timestamp": "2020-07-28T10:26:49.712Z",
'     "authentication_data": "secret123"
'   },
'   "recurring_authorization_data": {
'     "max_number_of_instalments": "05",
'     "frequency": "25",
'     "expiry_date": "2019-08-25"
'   },
'   "payer_login_data": {
'     "authentication_data": "secret123",
'     "authentication_timestamp": "2020-07-28T10:26:49.712Z",
'     "authentication_type": "MERCHANT_SYSTEM_AUTHENTICATION"
'   },
'   "browser_data": {
'     "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
'     "color_depth": "TWENTY_FOUR_BITS",
'     "ip": "123.123.123.123",
'     "java_enabled": "true",
'     "javascript_enabled": "true",
'     "language": "en-US",
'     "screen_height": "1080",
'     "screen_width": "1920",
'     "challenge_window_size": "FULL_SCREEN",
'     "timezone": "0",
'     "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36"
'   },
'   "merchant_contact_url": "https://enp4qhvjseljg.x.pipedream.net/"
' }

Dim json As New Chilkat.JsonObject
json.UpdateString("three_ds.source","BROWSER")
json.UpdateString("three_ds.preference","NO_PREFERENCE")
json.UpdateString("account_name","{{acc_name}}")
json.UpdateString("channel","CNP")
json.UpdateString("amount","5")
json.UpdateString("currency","EUR")
json.UpdateString("country","US")
json.UpdateString("method_url_completion_status","YES")
json.UpdateString("payment_method.id","{{pmt_id}}")
json.UpdateString("order.time_created_reference","2019-04-26T10:19:32.552327Z")
json.UpdateString("order.amount","1001")
json.UpdateString("order.currency","EUR")
json.UpdateString("order.reference","3400dd37-101d-4940-be15-3c963b6109b3")
json.UpdateString("order.address_match_indicator","false")
json.UpdateString("order.shipping_address.line1","Apartment 852")
json.UpdateString("order.shipping_address.line2","Complex 741")
json.UpdateString("order.shipping_address.line3","House 963")
json.UpdateString("order.shipping_address.city","Chicago")
json.UpdateString("order.shipping_address.postal_code","50001")
json.UpdateString("order.shipping_address.state","IL")
json.UpdateString("order.shipping_address.country","840")
json.UpdateString("order.gift_card_count","01")
json.UpdateString("order.gift_card_currency","EUR")
json.UpdateString("order.gift_card_amount","25000")
json.UpdateString("order.delivery_email","james.mason@example.com")
json.UpdateString("order.delivery_timeframe","ELECTRONIC_DELIVERY")
json.UpdateString("order.shipping_method","ANOTHER_VERIFIED_ADDRESS")
json.UpdateString("order.shipping_name_matches_cardholder_name","true")
json.UpdateString("order.preorder_indicator","MERCHANDISE_AVAILABLE")
json.UpdateString("order.preorder_availability_date:","2019-04-18")
json.UpdateString("order.reorder_indicator","FIRST_TIME_ORDER")
json.UpdateString("order.transaction_type","GOODS_SERVICE_PURCHASE")
json.UpdateString("payer.reference","6dcb24f5-74a0-4da3-98da-4f0aa0e88db3")
json.UpdateString("payer.account_age","LESS_THAN_THIRTY_DAYS")
json.UpdateString("payer.account_creation_date","2019-01-10")
json.UpdateString("payer.account_change_date","2019-01-28")
json.UpdateString("payer.account_change_indicator","THIS_TRANSACTION")
json.UpdateString("payer.account_password_change_date","2019-01-15")
json.UpdateString("payer.account_password_change_indicator","LESS_THAN_THIRTY_DAYS")
json.UpdateString("payer.home_phone.country_code","44")
json.UpdateString("payer.home_phone.subscriber_number","123456789")
json.UpdateString("payer.work_phone.country_code","44")
json.UpdateString("payer.work_phone.subscriber_number","1801555888")
json.UpdateString("payer.payment_account_creation_date","2019-01-01")
json.UpdateString("payer.payment_account_age_indicator","LESS_THAN_THIRTY_DAYS")
json.UpdateString("payer.suspicious_account_activity","NO_SUSPICIOUS_ACTIVITY")
json.UpdateString("payer.purchases_last_6months_count","03")
json.UpdateString("payer.transactions_last_24hours_count","01")
json.UpdateString("payer.transaction_last_year_count","05")
json.UpdateString("payer.provision_attempt_last_24hours_count","01")
json.UpdateString("payer.shipping_address_time_created_reference","2019-01-28")
json.UpdateString("payer.shipping_address_creation_indicator","THIS_TRANSACTION")
json.UpdateString("payer_prior_three_ds_authentication_data.authentication_method","FRICTIONLESS_AUTHENTICATION")
json.UpdateString("payer_prior_three_ds_authentication_data.acs_transaction_reference","26c3f619-39a4-4040-bf1f-6fd433e6d615")
json.UpdateString("payer_prior_three_ds_authentication_data.authentication_timestamp","2020-07-28T10:26:49.712Z")
json.UpdateString("payer_prior_three_ds_authentication_data.authentication_data","secret123")
json.UpdateString("recurring_authorization_data.max_number_of_instalments","05")
json.UpdateString("recurring_authorization_data.frequency","25")
json.UpdateString("recurring_authorization_data.expiry_date","2019-08-25")
json.UpdateString("payer_login_data.authentication_data","secret123")
json.UpdateString("payer_login_data.authentication_timestamp","2020-07-28T10:26:49.712Z")
json.UpdateString("payer_login_data.authentication_type","MERCHANT_SYSTEM_AUTHENTICATION")
json.UpdateString("browser_data.accept_header","text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8")
json.UpdateString("browser_data.color_depth","TWENTY_FOUR_BITS")
json.UpdateString("browser_data.ip","123.123.123.123")
json.UpdateString("browser_data.java_enabled","true")
json.UpdateString("browser_data.javascript_enabled","true")
json.UpdateString("browser_data.language","en-US")
json.UpdateString("browser_data.screen_height","1080")
json.UpdateString("browser_data.screen_width","1920")
json.UpdateString("browser_data.challenge_window_size","FULL_SCREEN")
json.UpdateString("browser_data.timezone","0")
json.UpdateString("browser_data.user_agent","Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36")
json.UpdateString("merchant_contact_url","https://enp4qhvjseljg.x.pipedream.net/")

' Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = "<access_token>"
http.SetRequestHeader("X-GP-Version","{{version}}")

Dim resp As Chilkat.HttpResponse = http.PostJson3("https://{{url}}/ucp/authentications/{{aut_id}}/initiate","application/json",json)
If (http.LastMethodSuccess = False) Then
    Debug.WriteLine(http.LastErrorText)
    Exit Sub
End If


Debug.WriteLine(resp.StatusCode)
Debug.WriteLine(resp.BodyStr)

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-H "X-GP-Version: {{version}}"
	-d '{
    "three_ds": {
        "source": "BROWSER",
        "preference": "NO_PREFERENCE"
    },
    "account_name": "{{acc_name}}",
    "channel": "CNP",
    "amount": "5",
    "currency": "EUR",
    "country": "US",
    "method_url_completion_status": "YES",
    "payment_method": {
        "id": "{{pmt_id}}"
    },
    "order": {
        "time_created_reference": "2019-04-26T10:19:32.552327Z",
        "amount": "1001",
        "currency": "EUR",
        "reference": "3400dd37-101d-4940-be15-3c963b6109b3",
        "address_match_indicator": "false",
        "shipping_address": {
            "line1": "Apartment 852",
            "line2": "Complex 741",
            "line3": "House 963",
            "city": "Chicago",
            "postal_code": "50001",
            "state": "IL",
            "country": "840"
        },
        "gift_card_count": "01",
        "gift_card_currency": "EUR",
        "gift_card_amount": "25000",
        "delivery_email": "james.mason@example.com",
        "delivery_timeframe": "ELECTRONIC_DELIVERY",
        "shipping_method": "ANOTHER_VERIFIED_ADDRESS",
        "shipping_name_matches_cardholder_name": "true",
        "preorder_indicator": "MERCHANDISE_AVAILABLE",
        "preorder_availability_date:": "2019-04-18",
        "reorder_indicator": "FIRST_TIME_ORDER",
        "transaction_type": "GOODS_SERVICE_PURCHASE"
    },
    "payer": {
        "reference": "6dcb24f5-74a0-4da3-98da-4f0aa0e88db3",
        "account_age": "LESS_THAN_THIRTY_DAYS",
        "account_creation_date": "2019-01-10",
        "account_change_date": "2019-01-28",
        "account_change_indicator": "THIS_TRANSACTION",
        "account_password_change_date": "2019-01-15",
        "account_password_change_indicator": "LESS_THAN_THIRTY_DAYS",
        "home_phone": {
            "country_code": "44",
            "subscriber_number": "123456789"
        },
        "work_phone": {
            "country_code": "44",
            "subscriber_number": "1801555888"
        },
        "payment_account_creation_date": "2019-01-01",
        "payment_account_age_indicator": "LESS_THAN_THIRTY_DAYS",
        "suspicious_account_activity": "NO_SUSPICIOUS_ACTIVITY",
        "purchases_last_6months_count": "03",
        "transactions_last_24hours_count": "01",
        "transaction_last_year_count": "05",
        "provision_attempt_last_24hours_count": "01",
        "shipping_address_time_created_reference": "2019-01-28",
        "shipping_address_creation_indicator": "THIS_TRANSACTION"
    },
    "payer_prior_three_ds_authentication_data": {
        "authentication_method": "FRICTIONLESS_AUTHENTICATION",
        "acs_transaction_reference": "26c3f619-39a4-4040-bf1f-6fd433e6d615",
        "authentication_timestamp": "2020-07-28T10:26:49.712Z",
        "authentication_data": "secret123"
    },
    "recurring_authorization_data": {
        "max_number_of_instalments": "05",
        "frequency": "25",
        "expiry_date": "2019-08-25"
    },
    "payer_login_data": {
        "authentication_data": "secret123",
        "authentication_timestamp": "2020-07-28T10:26:49.712Z",
        "authentication_type": "MERCHANT_SYSTEM_AUTHENTICATION"
    },
    "browser_data": {
        "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
        "color_depth": "TWENTY_FOUR_BITS",
        "ip": "123.123.123.123",
        "java_enabled": "true",
        "javascript_enabled": "true",
        "language": "en-US",
        "screen_height": "1080",
        "screen_width": "1920",
        "challenge_window_size": "FULL_SCREEN",
        "timezone": "0",
        "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36"
    },
    "merchant_contact_url": "https://enp4qhvjseljg.x.pipedream.net/"
}'
https://{{url}}/ucp/authentications/{{aut_id}}/initiate

Postman Collection Item JSON

{
  "name": "AUT_1.1 3DS2 Initiate",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "//Json Parse",
          "",
          "var jsonData = JSON.parse(responseBody);",
          "var creq = jsonData.three_ds.challenge_value; ",
          "var acs_challenge_request_url = jsonData.three_ds.acs_challenge_request_url; ",
          "",
          "//console.log(pareq);",
          "pm.test(\"set  html\",function(){",
          "    var template='<!DOCTYPE html> <html> <head> <title>Sample 3DSecure Page</title> </head> <body><form action='+acs_challenge_request_url+' method=\"POST\">  <input type=\"hidden\" name=\"creq\" value= '+creq+' /> <input type=\"submit\" value=\"Submit\"> </form> </body> </html>'     // save your html in the template and then     ",
          "    pm.visualizer.set(template);     // set that template to pm.visualizer",
          "})",
          ""
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "auth": {
      "type": "oauth2",
      "oauth2": [
        {
          "key": "accessToken",
          "value": "{{token}}",
          "type": "string"
        },
        {
          "key": "addTokenTo",
          "value": "header",
          "type": "string"
        }
      ]
    },
    "method": "POST",
    "header": [
      {
        "key": "X-GP-Version",
        "type": "text",
        "value": "{{version}}"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"three_ds\": {\n        \"source\": \"BROWSER\",\n        \"preference\": \"NO_PREFERENCE\"\n    },\n    \"account_name\": \"{{acc_name}}\",\n    \"channel\": \"CNP\",\n    \"amount\": \"5\",\n    \"currency\": \"EUR\",\n    \"country\": \"US\",\n    \"method_url_completion_status\": \"YES\",\n    \"payment_method\": {\n        \"id\": \"{{pmt_id}}\"\n    },\n    \"order\": {\n        \"time_created_reference\": \"2019-04-26T10:19:32.552327Z\",\n        \"amount\": \"1001\",\n        \"currency\": \"EUR\",\n        \"reference\": \"3400dd37-101d-4940-be15-3c963b6109b3\",\n        \"address_match_indicator\": \"false\",\n        \"shipping_address\": {\n            \"line1\": \"Apartment 852\",\n            \"line2\": \"Complex 741\",\n            \"line3\": \"House 963\",\n            \"city\": \"Chicago\",\n            \"postal_code\": \"50001\",\n            \"state\": \"IL\",\n            \"country\": \"840\"\n        },\n        \"gift_card_count\": \"01\",\n        \"gift_card_currency\": \"EUR\",\n        \"gift_card_amount\": \"25000\",\n        \"delivery_email\": \"james.mason@example.com\",\n        \"delivery_timeframe\": \"ELECTRONIC_DELIVERY\",\n        \"shipping_method\": \"ANOTHER_VERIFIED_ADDRESS\",\n        \"shipping_name_matches_cardholder_name\": \"true\",\n        \"preorder_indicator\": \"MERCHANDISE_AVAILABLE\",\n        \"preorder_availability_date:\": \"2019-04-18\",\n        \"reorder_indicator\": \"FIRST_TIME_ORDER\",\n        \"transaction_type\": \"GOODS_SERVICE_PURCHASE\"\n    },\n    \"payer\": {\n        \"reference\": \"6dcb24f5-74a0-4da3-98da-4f0aa0e88db3\",\n        \"account_age\": \"LESS_THAN_THIRTY_DAYS\",\n        \"account_creation_date\": \"2019-01-10\",\n        \"account_change_date\": \"2019-01-28\",\n        \"account_change_indicator\": \"THIS_TRANSACTION\",\n        \"account_password_change_date\": \"2019-01-15\",\n        \"account_password_change_indicator\": \"LESS_THAN_THIRTY_DAYS\",\n        \"home_phone\": {\n            \"country_code\": \"44\",\n            \"subscriber_number\": \"123456789\"\n        },\n        \"work_phone\": {\n            \"country_code\": \"44\",\n            \"subscriber_number\": \"1801555888\"\n        },\n        \"payment_account_creation_date\": \"2019-01-01\",\n        \"payment_account_age_indicator\": \"LESS_THAN_THIRTY_DAYS\",\n        \"suspicious_account_activity\": \"NO_SUSPICIOUS_ACTIVITY\",\n        \"purchases_last_6months_count\": \"03\",\n        \"transactions_last_24hours_count\": \"01\",\n        \"transaction_last_year_count\": \"05\",\n        \"provision_attempt_last_24hours_count\": \"01\",\n        \"shipping_address_time_created_reference\": \"2019-01-28\",\n        \"shipping_address_creation_indicator\": \"THIS_TRANSACTION\"\n    },\n    \"payer_prior_three_ds_authentication_data\": {\n        \"authentication_method\": \"FRICTIONLESS_AUTHENTICATION\",\n        \"acs_transaction_reference\": \"26c3f619-39a4-4040-bf1f-6fd433e6d615\",\n        \"authentication_timestamp\": \"2020-07-28T10:26:49.712Z\",\n        \"authentication_data\": \"secret123\"\n    },\n    \"recurring_authorization_data\": {\n        \"max_number_of_instalments\": \"05\",\n        \"frequency\": \"25\",\n        \"expiry_date\": \"2019-08-25\"\n    },\n    \"payer_login_data\": {\n        \"authentication_data\": \"secret123\",\n        \"authentication_timestamp\": \"2020-07-28T10:26:49.712Z\",\n        \"authentication_type\": \"MERCHANT_SYSTEM_AUTHENTICATION\"\n    },\n    \"browser_data\": {\n        \"accept_header\": \"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8\",\n        \"color_depth\": \"TWENTY_FOUR_BITS\",\n        \"ip\": \"123.123.123.123\",\n        \"java_enabled\": \"true\",\n        \"javascript_enabled\": \"true\",\n        \"language\": \"en-US\",\n        \"screen_height\": \"1080\",\n        \"screen_width\": \"1920\",\n        \"challenge_window_size\": \"FULL_SCREEN\",\n        \"timezone\": \"0\",\n        \"user_agent\": \"Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36\"\n    },\n    \"merchant_contact_url\": \"https://enp4qhvjseljg.x.pipedream.net/\"\n}",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "https://{{url}}/ucp/authentications/{{aut_id}}/initiate",
      "protocol": "https",
      "host": [
        "{{url}}"
      ],
      "path": [
        "ucp",
        "authentications",
        "{{aut_id}}",
        "initiate"
      ]
    },
    "description": "This request follows the 'Check Version' request in the 3DS2 flow. The merchant must submit data including the billing and shipping details of the payer, at least one phone number, the device data, transaction details, outcome from the ACS Method URL if it took place and a link to the merchant's About or Contact page.\r\n\r\nFor more information on the 3DS2 Initate step, please visit: https://developer.globalpay.com/api/3d-secure-two and https://developer.globalpay.com/api/authentications#/Initiate/initiate3DS"
  },
  "response": [
  ]
}