Operation 5: Authenticate Payer

PUT https://{{domain}}/api/rest/version/{{collectionVersion}}/merchant/{{merchantId}}/order/{{paymentSessionOrderId}}/transaction/{{tranId}}

Request Body

{"apiOperation"=>"AUTHENTICATE_PAYER", "order"=>{"currency"=>"USD"}, "session"=>{"id"=>"{{paymentSessionID}}"}, "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":"025e31d4-60f1-4bbb-8ab7-83b69aa5129b"},"3ds2":{"3dsServerTransactionId":"3b03f51f-fef3-42e0-b4f5-1fd75630abc5","acsTransactionId":"7585683b-64c5-42b8-8b6f-ea984ab8d7a1","directoryServerId":"A999999999","dsTransactionId":"025e31d4-60f1-4bbb-8ab7-83b69aa5129b","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=\"0b556c5b-182c-4d08-bc9a-af2d7de9541d\" /\u003e \u003cinput type=\"hidden\" name=\"transaction.id\" value=\"4b8ae06e-ee1f-498f-b616-e90ff66fd3b8\" /\u003e \u003cinput type=\"hidden\" name=\"response.gatewayRecommendation\" value=\"PROCEED\" /\u003e \u003cinput type=\"hidden\" name=\"encryptedData.ciphertext\" value=\"Zcv2d8yD6+PTYv31rma3itwMFlZmvdEx1q07RBoXFlCPpPRxREJqI2iBFKfa373q7D4AqXQAzdID5214hVa05D1POFDZougPv8lqtzvHKV3mYzW/PChfrlKIdg4Ufq3G30SLDed1OIKSZdlGB3zGS6DPkidbsDkrfcFLLquqhQDjLnlqAm+wOz3pDrlAGzCajcIpif9E6Vj3EICkAahgrO/3QKY0WMt8pC/zNFYWT3EyQeQn+9cyKnfHjdP9Q/GF7dtlnHh8HutGPdiA4TTyL3MVg3Bgkg4jBdhhPqoLus+idlHC78UbNu2r0Z2WCwLfBKysAWRsJVsu+YvseGrm2NeH1iM9jn4R+t7XjZH2PI6gp8Fpsvlw2XMNgKwUqjWCKj6J8FHRLRU/pVxFTTRmwqu7WCG84aq5c/hWZnrmM6VqviFzlDxccMuOioelLdFE44HKILHIKh77Zjv+c6PwiDC2Kvx2PTvkwEPMD5XOQPpL3AZKtE6pvC1xFkuWu3/1RTz0HX5BlAOyCZvzXrwYmz7nLkYTaVvJZCX0RUQ8humg6AXU9/si178JYx2DtjMne912FeHcvcfbBz0ahrF4MznyhPgPzxrquDe002rVNVk7zg1Unxfz0CWaJJQ5fninvL/Z8zyyPmUXvZ0T9RqzlLUbSc+AH/uvJbdgMw==\" /\u003e \u003cinput type=\"hidden\" name=\"encryptedData.nonce\" value=\"uoraVT8paWOAArs2\" /\u003e \u003cinput type=\"hidden\" name=\"encryptedData.tag\" value=\"iCQ7CrLMmW1sj/RqEQOmXg==\" /\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:38:01.408Z","version":"3DS2"},"device":{"browser":"MOZILLA/4.0 (COMPATIBLE; MSIE 5.0; WINDOWS 95)"},"encryptedData":{"ciphertext":"Zcv2d8yD6+PTYv31rma3itwMFlZmvdEx1q07RBoXFlCPpPRxREJqI2iBFKfa373q7D4AqXQAzdID5214hVa05D1POFDZougPv8lqtzvHKV3mYzW/PChfrlKIdg4Ufq3G30SLDed1OIKSZdlGB3zGS6DPkidbsDkrfcFLLquqhQDjLnlqAm+wOz3pDrlAGzCajcIpif9E6Vj3EICkAahgrO/3QKY0WMt8pC/zNFYWT3EyQeQn+9cyKnfHjdP9Q/GF7dtlnHh8HutGPdiA4TTyL3MVg3Bgkg4jBdhhPqoLus+idlHC78UbNu2r0Z2WCwLfBKysAWRsJVsu+YvseGrm2NeH1iM9jn4R+t7XjZH2PI6gp8Fpsvlw2XMNgKwUqjWCKj6J8FHRLRU/pVxFTTRmwqu7WCG84aq5c/hWZnrmM6VqviFzlDxccMuOioelLdFE44HKILHIKh77Zjv+c6PwiDC2Kvx2PTvkwEPMD5XOQPpL3AZKtE6pvC1xFkuWu3/1RTz0HX5BlAOyCZvzXrwYmz7nLkYTaVvJZCX0RUQ8humg6AXU9/si178JYx2DtjMne912FeHcvcfbBz0ahrF4MznyhPgPzxrquDe002rVNVk7zg1Unxfz0CWaJJQ5fninvL/Z8zyyPmUXvZ0T9RqzlLUbSc+AH/uvJbdgMw==","nonce":"uoraVT8paWOAArs2","tag":"iCQ7CrLMmW1sj/RqEQOmXg=="},"merchant":"TESTARC49560744","order":{"amount":144,"authenticationStatus":"AUTHENTICATION_SUCCESSFUL","creationTime":"2023-03-16T21:37:47.562Z","currency":"USD","id":"0b556c5b-182c-4d08-bc9a-af2d7de9541d","lastUpdatedTime":"2023-03-16T21:38:01.403Z","merchantCategoryCode":"4511","reference":"0b556c5b-182c-4d08-bc9a-af2d7de9541d","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:38:01.403Z","timeOfRecord":"2023-03-16T21:37:47.562Z","transaction":{"acquirer":{"merchantId":"00090000266"},"amount":144,"authenticationStatus":"AUTHENTICATION_SUCCESSFUL","currency":"USD","id":"4b8ae06e-ee1f-498f-b616-e90ff66fd3b8","type":"AUTHENTICATION"},"version":"70"}