Merchant Active 3DS Result Submission Processing Flow

3DS Key Input Parameters

Field Name	Type	Description
executeThreeD	String	Fill with external for active 3DS result submission
authenticationValue	String	Unique identifier generated by the issuing bank for Visa, American Express, JCB, Diners Club and Discover transactions after customer authentication. Raw data is in base64 units. Need to convert the value to readable format.
acsTransactionId	String	Unique transaction identifier assigned by ACS to identify a single transaction.
veresEnrolled	String	Result of registration check. This field can contain one of the following values: - Y: Card is registered or registerable; authentication must be performed. Liability shift. - N: Unenrolled card; proceed with authorization. Liability shift. - U: Authentication cannot be performed for any reason. No liability shift.
specificationVersion	String	This field contains the 3D Secure version used to process the transaction. For example, 1.0.2 or 2.0.0.
directoryServerTransactionId	String	Directory server transaction ID generated by Mastercard directory server during authentication transaction and passed back to merchant along with authentication result.
threeDSServerTransactionId	String	Unique transaction identifier assigned by 3DS server to identify a single transaction.
paresStatus	String	Original result of authentication check. This field can contain one of the following values: - A: Proof of authentication attempt generated. - N: Customer authentication failed or cancelled. Transaction declined. - U: Authentication not completed for any reason. - Y: Customer successfully authenticated.
eci	String	For authentication, numeric Electronic Commerce Indicator (ECI) is returned only for Visa, American Express, JCB, Diners Club and Discover transactions. Field is missing when authentication fails. This field contains one of the following values: - 01: Authentication attempted (Mastercard) - 02: Authentication successful (Mastercard) - 05: Successful authentication (Visa, American Express, JCB, Diners Club and Discover) - 06: Authentication attempted (Visa, American Express, JCB, Diners Club and Discover)

Order Creation and Payment Interface Input Example

Parameter Example

{
    "clientId": "2018092714313010016",
    "accId": "2018092714313010016431",
    "amount": 10,
    "version": "1.0",
    "currency": "USD",
    "merchantTransactionId": "{{merchantTransactionId}}",
    "paymentType": "SALE",
    "shopperResultUrl": "https://aa.com",
    "shopperCancelUrl": "https://aa.com",
    "signType": "MD5",
    "threeDSecure": "N",
    "sign": "{{Sign}}",
    "requestId": "{{requestId}}",
    "acquirerType": "PAY",
    "notificationUrl": "https://test-acquirerpay.pingpongx.com/qa/notify",
    "threeDSRequestData": {
        "executeThreeD": "external",
        "acsTransactionId": "d53e5ae3-6a98-4ae0-be1a-7e7f0e91f392",
        "authenticationValue": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=",
        "directoryServerTransactionId": "83196474-07ec-43d5-85a0-aafc9e505419",
        "eci": "02",
        "paresStatus": "Y",
        "threeDSServerTransactionId": "59a87425-2e29-484e-94f8-f2bc04649332",
        "specificationVersion": "2.1.0"
    },
    "payMethodInfo": {
        "card": {
            "cvv": "103",
            "expireMonth": "12",
            "expireYear": "2025",
            "holderFirstName": "James",
            "holderLastName": "LeBron",
            "number": "5200000000003092"
        }
    },
    "billing": {
        "city": "Birmingham",
        "country": "US",
        "email": "3ds@pingpongx.com",
        "firstName": "James",
        "lastName": "LeBron",
        "phone": "18301770495",
        "postcode": "35222",
        "state": "AL",
        "street": "1986 Broad Street"
    },
    "shipping": {
        "city": "Miami",
        "country": "US",
        "email": "t_email",
        "firstName": "Jamesbb",
        "lastName": "LeBronbb",
        "phone": "3055787342",
        "postcode": "33131",
        "state": "FL",
        "street": "701 Brickell Avenue, Suite 2700",
        "lastModifierStreetTime": "20191225162010",
        "lastModifierPhoneTime": "20191225162010"
    },
    "customer": {
        "acquisitionChannel": "SEARCH_ENGINE",
        "customerId": "20191201001",
        "domain": "pingpongx.com",
        "email": "3ds@pingpongx.com",
        "firstName": "James",
        "firstOrder": "N",
        "identificationId": "",
        "identificationType": "ID",
        "lastName": "LeBron",
        "lastPayTime": "201905120330",
        "loginIp": "222.126.52.24",
        "loginTime": "201912010032",
        "middleName": "von",
        "nonMemberOrder": "N",
        "orderCountry": "US",
        "orderIp": "222.126.52.23",
        "orderTime": "20191201001",
        "payCountry": "US",
        "payIp": "222.126.52.25",
        "phone": "18301770495"
    }
}