Operation 5: Authenticate Payer

PUT https://{{domain}}/api/rest/version/{{collectionVersion}}/merchant/{{merchantId}}/order/{{orderIdForToken}}/transaction/{{transactionIdforToken}}

Request Body

{"apiOperation"=>"AUTHENTICATE_PAYER", "order"=>{"currency"=>"USD"}, "session"=>{"id"=>"{{tokenSessionId}}"}, "device"=>{"browser"=>"MOZILLA/4.0 (COMPATIBLE; MSIE 5.0; WINDOWS 95)", "browserDetails"=>{"screenHeight"=>481, "screenWidth"=>1920, "language"=>"en-US", "colorDepth"=>24, "javaEnabled"=>"false", "timeZone"=>240, "acceptHeaders"=>"application/json", "3DSecureChallengeWindowSize"=>"FULL_SCREEN"}}}

RESPONSES

status: Created

{"authentication":{"3ds":{"acsEci":"02","authenticationToken":"mHyn+7YFi1EUAREAAAAvNUe6Hv8=","transactionId":"8060e149-f062-4049-9386-a5686e03a1d5"},"3ds2":{"3dsServerTransactionId":"c236b826-44e0-4dfc-aed1-152499a8885d","acsTransactionId":"25bf03cc-35e6-4b99-b80b-4db097156494","directoryServerId":"A999999999","dsTransactionId":"8060e149-f062-4049-9386-a5686e03a1d5","methodCompleted":false,"methodSupported":"SUPPORTED","protocolVersion":"2.1.0","requestorId":"requestorId","requestorName":"ARC Travel Office","transactionStatus":"Y"},"amount":144,"payerInteraction":"NOT_REQUIRED","psd2":{"trustedMerchantStatus":"ON_LIST"},"redirect":{"domainName":"na.gateway.mastercard.com","html":"\u003cdiv id=\"threedsFrictionLessRedirect\" xmlns=\"http://www.w3.org/1999/html\"\u003e \u003ciframe id=\"challengeFrame\" name=\"challengeFrame\"\u003e \u003c/iframe\u003e \u003cform id=\"threedsFrictionLessRedirectForm\" method=\"POST\" action=\"\" target=\"challengeFrame\"\u003e \u003cinput type=\"hidden\" name=\"order.id\" value=\"51bd1ce1-163e-49c1-a6ac-9e89d3874e62\" /\u003e \u003cinput type=\"hidden\" name=\"transaction.id\" value=\"322dd3f5-feda-4939-9b62-10224644084b\" /\u003e \u003cinput type=\"hidden\" name=\"response.gatewayRecommendation\" value=\"PROCEED\" /\u003e \u003cinput type=\"hidden\" name=\"encryptedData.ciphertext\" value=\"vC5dr6B2jj+RqId+ylY1s37+uNxynBhkrMqKVnFqMebmNN7UF2IUwGv+xGO7P6Xv4JnSDeCw/IhyowOYplyhDX8d4K+6EKmixOwSuBdeAYqiwMZkswqYexdHxehi3/CWjgRF1K2QUWPAeyMwpU6Okm2J4nO9JFd08WCtE56Fd+ssUdj8e5QGa+2GOD6ZXS1BeloqXQUrmHFguALbC1eVkrs+NZZN8gmSvN7JxIHYjqnd1X3BbccBoiTdhAj10scUl8ZqCw+xOmySp3ruq6J+gbb0dR/2fexs/yngQRjVl4YMgmpYauemiTMpXlOOjaqBjXYdC+TxeBZiHAOrWwnkn/iMDr5q9fis31CCfw4U3VPhLTnqqT7y8Exv3GXCeWXaihkYq6QZtpVc7KDMQ3T6VE54Lj3TQBoSWjDqtivsYpTKihLSFSonxxJ9R2tI3izQrxkhW2/p1ZzcubfQSRJVZe6KOuvVwzLmO/isW1xo2ZFM7hXSD3qSAfLnpQtAHkK+SSh0MdJbuGJnjh5IT3reMsnMWAonWK/Plw42rVXpTJ4gLe4movAknn3Q+RV0NCcaLRQf/JGKk4T5ESZqN1eT5jZ3jNvCMSU7TPqkspeQ9ss6ELQS497dSrYMAwoT4a510qfrYNvSoW73MdTm02t5BpfA/IeTUyj8MQQ7xw==\" /\u003e \u003cinput type=\"hidden\" name=\"encryptedData.nonce\" value=\"h0CZsJEvOkCAArYO\" /\u003e \u003cinput type=\"hidden\" name=\"encryptedData.tag\" value=\"+MW0ZgaIKxhjWqD9p1Go7g==\" /\u003e \u003cinput type=\"hidden\" name=\"result\" value=\"SUCCESS\" /\u003e \u003c/form\u003e \u003cscript id=\"authenticate-payer-script\"\u003e var e=document.getElementById(\"threedsFrictionLessRedirectForm\"); if (e) { e.submit(); if (e.parentNode !== null) { e.parentNode.removeChild(e); } } \u003c/script\u003e \u003c/div\u003e"},"time":"2023-03-16T21:43:05.345Z","version":"3DS2"},"billing":{"address":{"city":"Tampa","company":"ARC","country":"USA","postcodeZip":"11124","stateProvinceCode":"FL","street":"123 test street","street2":"323 qe drive"}},"correlationId":"test adding correlationId","customer":{"account":{"authentication":{"method":"ISSUER_ACCOUNT_LOGIN","time":"2022-08-01T15:45:55.080Z"},"history":{"addCardAttempts":99,"annualActivity":999,"creationDate":"2022-09-01","lastUpdated":"2022-10-01","passwordLastChanged":"2022-10-01","recentActivity":99,"shippingAddressDate":"2022-10-01","suspiciousActivity":false}},"firstName":"TEST","lastName":"TEST","mobilePhone":" +1 607 1234 5678","phone":" +1 607 1234 5678","taxRegistrationId":"TESTtaxRegId"},"device":{"browser":"MOZILLA/4.0 (COMPATIBLE; MSIE 5.0; WINDOWS 95)"},"encryptedData":{"ciphertext":"vC5dr6B2jj+RqId+ylY1s37+uNxynBhkrMqKVnFqMebmNN7UF2IUwGv+xGO7P6Xv4JnSDeCw/IhyowOYplyhDX8d4K+6EKmixOwSuBdeAYqiwMZkswqYexdHxehi3/CWjgRF1K2QUWPAeyMwpU6Okm2J4nO9JFd08WCtE56Fd+ssUdj8e5QGa+2GOD6ZXS1BeloqXQUrmHFguALbC1eVkrs+NZZN8gmSvN7JxIHYjqnd1X3BbccBoiTdhAj10scUl8ZqCw+xOmySp3ruq6J+gbb0dR/2fexs/yngQRjVl4YMgmpYauemiTMpXlOOjaqBjXYdC+TxeBZiHAOrWwnkn/iMDr5q9fis31CCfw4U3VPhLTnqqT7y8Exv3GXCeWXaihkYq6QZtpVc7KDMQ3T6VE54Lj3TQBoSWjDqtivsYpTKihLSFSonxxJ9R2tI3izQrxkhW2/p1ZzcubfQSRJVZe6KOuvVwzLmO/isW1xo2ZFM7hXSD3qSAfLnpQtAHkK+SSh0MdJbuGJnjh5IT3reMsnMWAonWK/Plw42rVXpTJ4gLe4movAknn3Q+RV0NCcaLRQf/JGKk4T5ESZqN1eT5jZ3jNvCMSU7TPqkspeQ9ss6ELQS497dSrYMAwoT4a510qfrYNvSoW73MdTm02t5BpfA/IeTUyj8MQQ7xw==","nonce":"h0CZsJEvOkCAArYO","tag":"+MW0ZgaIKxhjWqD9p1Go7g=="},"merchant":"merchantId","order":{"amount":144,"authenticationStatus":"AUTHENTICATION_SUCCESSFUL","creationTime":"2023-03-16T21:42:44.506Z","currency":"USD","id":"51bd1ce1-163e-49c1-a6ac-9e89d3874e62","lastUpdatedTime":"2023-03-16T21:43:05.339Z","merchantCategoryCode":"4511","reference":"51bd1ce1-163e-49c1-a6ac-9e89d3874e62","status":"AUTHENTICATED","totalAuthorizedAmount":0,"totalCapturedAmount":0,"totalRefundedAmount":0,"valueTransfer":{"accountType":"NOT_A_TRANSFER"}},"partnerSolutionId":"1111","response":{"gatewayCode":"APPROVED","gatewayRecommendation":"PROCEED"},"result":"SUCCESS","sourceOfFunds":{"provided":{"card":{"brand":"MASTERCARD","expiry":{"month":"1","year":"39"},"fundingMethod":"CREDIT","issuer":"AFRILAND FIRST BANK","number":"512345xxxxxx2346","scheme":"MASTERCARD"}},"type":"CARD"},"timeOfLastUpdate":"2023-03-16T21:43:05.339Z","timeOfRecord":"2023-03-16T21:42:44.506Z","transaction":{"acquirer":{"merchantId":"00090000266"},"amount":144,"authenticationStatus":"AUTHENTICATION_SUCCESSFUL","currency":"USD","id":"322dd3f5-feda-4939-9b62-10224644084b","type":"AUTHENTICATION"},"version":"70"}