EXTERNAL

Enables card payments to be authenticated through a third-party MPI (Merchant Plug-In). In this setup, the merchant leverages an external standalone 3DS authentication server to obtain the 3DS cryptogram, which is then forwarded in the authorization request.

The following parameters can be submitted:


`authenticationStatus`	The 3DS authentication status code.
`authenticationStatusReason`	The 3DS authentication status reason.
`authenticationValue`	Cardholder Authentication Verification Value (CAVV) A cryptographic value generated by the issuer after successful 3DS authentication.
`authenticationAlgorithm`	The 3DS authentication CAVV algorithm used.
`authenticationMode`	The 3DS authentication mode.
`eci`	Electronic Commerce Indicator. Indicates the outcome and strength of authentication.
`version`	The 3DS authentication version.
`externalId`	The 3DS authentication transaction identifier.
`externalAcsId`	Identifier used by the ACS (issuer's server) to track the transaction.
`score`	The 3DS score.
`challenge.preference`	The 3DS authentication challenge initialization preference.
`challenge.outcome`	The 3DS authentication challenge outcome.
`challenge.exemptionReason`	The 3DS authentication challenge exemption reason.
`challenge.cancellationReason`	The 3DS challenge cancellation indicator.
`outOfScope.reason`	The 3DS out of scope reason, to be used to indicate the reason if the payment is out of scope of SCA.

EXTERNAL_3DS is only applicable to the CARD payment method. When included, it is immediately forwarded as part of the authorization request.

Request

//...
  "authenticationSettings": [
    {
      "type": "EXTERNAL_3DS",
      "settings": {
        "authenticationStatus": "SUCCESS",
        "authenticationValue": "e3f7a0c2-fff8-4fb8-afab-dbae6e17c9cc",
        "eci": "01",
        "version": "2.0.0",
        "externalId": "a7fe5eae-d5bb-4f57-a946-2125c3c32801",
        "challenge": {
          "preference": "NO_CHALLENGE_REQUESTED",
          "outcome": "FRICTIONLESS",
          "exemptionReason": "LOW_VALUE"
        }
      }
    }
  ]
//...