Back to Collection Items
LOCAL loHttp
LOCAL lnSuccess
LOCAL loJson
LOCAL loResp
* This example assumes the Chilkat API to have been previously unlocked.
* See Global Unlock Sample for sample code.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
loHttp = CreateObject('Chilkat.Http')
* 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/"
* }
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("three_ds.source","BROWSER")
loJson.UpdateString("three_ds.preference","NO_PREFERENCE")
loJson.UpdateString("account_name","{{acc_name}}")
loJson.UpdateString("channel","CNP")
loJson.UpdateString("amount","5")
loJson.UpdateString("currency","EUR")
loJson.UpdateString("country","US")
loJson.UpdateString("method_url_completion_status","YES")
loJson.UpdateString("payment_method.id","{{pmt_id}}")
loJson.UpdateString("order.time_created_reference","2019-04-26T10:19:32.552327Z")
loJson.UpdateString("order.amount","1001")
loJson.UpdateString("order.currency","EUR")
loJson.UpdateString("order.reference","3400dd37-101d-4940-be15-3c963b6109b3")
loJson.UpdateString("order.address_match_indicator","false")
loJson.UpdateString("order.shipping_address.line1","Apartment 852")
loJson.UpdateString("order.shipping_address.line2","Complex 741")
loJson.UpdateString("order.shipping_address.line3","House 963")
loJson.UpdateString("order.shipping_address.city","Chicago")
loJson.UpdateString("order.shipping_address.postal_code","50001")
loJson.UpdateString("order.shipping_address.state","IL")
loJson.UpdateString("order.shipping_address.country","840")
loJson.UpdateString("order.gift_card_count","01")
loJson.UpdateString("order.gift_card_currency","EUR")
loJson.UpdateString("order.gift_card_amount","25000")
loJson.UpdateString("order.delivery_email","james.mason@example.com")
loJson.UpdateString("order.delivery_timeframe","ELECTRONIC_DELIVERY")
loJson.UpdateString("order.shipping_method","ANOTHER_VERIFIED_ADDRESS")
loJson.UpdateString("order.shipping_name_matches_cardholder_name","true")
loJson.UpdateString("order.preorder_indicator","MERCHANDISE_AVAILABLE")
loJson.UpdateString("order.preorder_availability_date:","2019-04-18")
loJson.UpdateString("order.reorder_indicator","FIRST_TIME_ORDER")
loJson.UpdateString("order.transaction_type","GOODS_SERVICE_PURCHASE")
loJson.UpdateString("payer.reference","6dcb24f5-74a0-4da3-98da-4f0aa0e88db3")
loJson.UpdateString("payer.account_age","LESS_THAN_THIRTY_DAYS")
loJson.UpdateString("payer.account_creation_date","2019-01-10")
loJson.UpdateString("payer.account_change_date","2019-01-28")
loJson.UpdateString("payer.account_change_indicator","THIS_TRANSACTION")
loJson.UpdateString("payer.account_password_change_date","2019-01-15")
loJson.UpdateString("payer.account_password_change_indicator","LESS_THAN_THIRTY_DAYS")
loJson.UpdateString("payer.home_phone.country_code","44")
loJson.UpdateString("payer.home_phone.subscriber_number","123456789")
loJson.UpdateString("payer.work_phone.country_code","44")
loJson.UpdateString("payer.work_phone.subscriber_number","1801555888")
loJson.UpdateString("payer.payment_account_creation_date","2019-01-01")
loJson.UpdateString("payer.payment_account_age_indicator","LESS_THAN_THIRTY_DAYS")
loJson.UpdateString("payer.suspicious_account_activity","NO_SUSPICIOUS_ACTIVITY")
loJson.UpdateString("payer.purchases_last_6months_count","03")
loJson.UpdateString("payer.transactions_last_24hours_count","01")
loJson.UpdateString("payer.transaction_last_year_count","05")
loJson.UpdateString("payer.provision_attempt_last_24hours_count","01")
loJson.UpdateString("payer.shipping_address_time_created_reference","2019-01-28")
loJson.UpdateString("payer.shipping_address_creation_indicator","THIS_TRANSACTION")
loJson.UpdateString("payer_prior_three_ds_authentication_data.authentication_method","FRICTIONLESS_AUTHENTICATION")
loJson.UpdateString("payer_prior_three_ds_authentication_data.acs_transaction_reference","26c3f619-39a4-4040-bf1f-6fd433e6d615")
loJson.UpdateString("payer_prior_three_ds_authentication_data.authentication_timestamp","2020-07-28T10:26:49.712Z")
loJson.UpdateString("payer_prior_three_ds_authentication_data.authentication_data","secret123")
loJson.UpdateString("recurring_authorization_data.max_number_of_instalments","05")
loJson.UpdateString("recurring_authorization_data.frequency","25")
loJson.UpdateString("recurring_authorization_data.expiry_date","2019-08-25")
loJson.UpdateString("payer_login_data.authentication_data","secret123")
loJson.UpdateString("payer_login_data.authentication_timestamp","2020-07-28T10:26:49.712Z")
loJson.UpdateString("payer_login_data.authentication_type","MERCHANT_SYSTEM_AUTHENTICATION")
loJson.UpdateString("browser_data.accept_header","text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8")
loJson.UpdateString("browser_data.color_depth","TWENTY_FOUR_BITS")
loJson.UpdateString("browser_data.ip","123.123.123.123")
loJson.UpdateString("browser_data.java_enabled","true")
loJson.UpdateString("browser_data.javascript_enabled","true")
loJson.UpdateString("browser_data.language","en-US")
loJson.UpdateString("browser_data.screen_height","1080")
loJson.UpdateString("browser_data.screen_width","1920")
loJson.UpdateString("browser_data.challenge_window_size","FULL_SCREEN")
loJson.UpdateString("browser_data.timezone","0")
loJson.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")
loJson.UpdateString("merchant_contact_url","https://enp4qhvjseljg.x.pipedream.net/")
* Adds the "Authorization: Bearer <access_token>" header.
loHttp.AuthToken = "<access_token>"
loHttp.SetRequestHeader("X-GP-Version","{{version}}")
loResp = loHttp.PostJson3("https://{{url}}/ucp/authentications/{{aut_id}}/initiate","application/json",loJson)
IF (loHttp.LastMethodSuccess = 0) THEN
? loHttp.LastErrorText
RELEASE loHttp
RELEASE loJson
CANCEL
ENDIF
? STR(loResp.StatusCode)
? loResp.BodyStr
RELEASE loResp
RELEASE loHttp
RELEASE loJson
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": [
]
}
