--- title: "3D Secure - Webhooks" canonical_url: https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/webhooks/ --- 1. [Home](https://docs.connect.worldline-solutions.com/) 2. Best practices 3. Services 4. 3dsv2 5. [webhooks](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/webhooks.md) 6. 3D Secure - Webhooks # Webhooks The additional properties that have been added to the Create Payment response have also been added to the webhook payment events, in the event that a 3-D Secure version 2 authentication was completed. ## Additional response properties related to 3-D Secure version 2 It is possible that the Authentication fails and the reason why will be detailed in the errors. It is also possible that the issuer will require Strong Customer Authentication (SCA) to be provided before the issuer will authorize the transaction. This means that you should process the transaction in a way that will allow SCA through for instance a challenge to take place. The below overview shows all properties in the output that are used in the 3-D Secure version 2 authentication. For each of the properties we have marked them as follows: * ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) New - The property did not previously exist in our API. * ![Moved property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/moved-warning-5-24.png?language_id=1) Moved - We have decided to move or rename an existing property to a more logical location. * ![Existing property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/existing-check-mark-4-24.png?language_id=1) Existing - This is an existing property that is used in the authentication process. * ![Deprecated property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/deprecated-warning-7-24.png?language_id=1) Deprecated - One property needed for 3-D Secure version 2 has an overlap with an existing property and in this case we have decided to deprecate the existing property as the new property needed to provide more detail. | Property name |||||| Change / Type || Description | |---|---|---|---|---|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | payment |||||| ![Existing property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/existing-check-mark-4-24.png?language_id=1) | Object | Object containing data regarding the payment | | | paymentOutput ||||| ![Existing property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/existing-check-mark-4-24.png?language_id=1) | Object | Object containing output data regarding the payment | | | | cardPaymentMethodSpecificOutput |||| ![Existing property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/existing-check-mark-4-24.png?language_id=1) | Object | Object containing card payment method specific output | | | | | initialSchemeTransactionId ||| ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN100 | The unique scheme transactionId of the initial transaction that was performed with SCA. Should be stored by the merchant to allow it to be submitted in future transactions. | | | | | schemeTransactionId ||| ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN100 | The unique scheme transactionId of this transaction. Should be stored by the merchant to allow it to be submitted in future transactions. Use this value in case the initialSchemeTransactionId property is empty. | | | | | threeDSecureResults ||| ![Existing property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/existing-check-mark-4-24.png?language_id=1) | Object | Object containing results of the 3D Secure authentication | | | | | | sdkData || ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | Object | Object containing 3-D Secure in-app SDK data | | | | | | | sdkTransactionId | ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN36 | Universally unique transaction identifier assigned by the 3-D Secure SDK to identify this transaction. | | | | | | threeDSecureData || ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | Object | Object containing data regarding the 3D Secure authentication | | | | | | | acsTransactionId | ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN36 | The ACS Transaction ID for this transaction. You should store this data as you will need it for the next transaction with the same card | | | | | | | method | ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | Enum (String) | Method of authentication used for this transaction. Possible values: * frictionless = frictionless authentication * challenged = cardholder was challenged * avs-verified = AVS verified * other = another issuer method was used to authenticate this transaction You should store this data as you will need it for the next transaction with the same card | | | | | | | utcTimestamp | ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN12 | Timestamp in UTC (YYYYMMDDHHmm) of the 3-D Secure authentication of this transaction You should store this data as you will need it for the next transaction with the same card | | | | | | directoryServerTransactionId || ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN36 | The 3-D Secure Directory Server transaction ID that is used for the 3-D Secure version 2 Authentication This property is used in the communication with the acquirer | | | | | | threeDServerTransactionId || ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN36 | The 3-D Secure Server transaction ID that is used for the 3-D Secure version 2 Authentication This property is used in the communication with the acquirer | | | | | | threeDSecureVersion || ![New property](https://docs.connect.worldline-solutions.com/global/images/content/best-practices/services/3d-secure-version-2/new-plus-5-24.png?language_id=1) | AN10 | The 3-D Secure version used for the authentication This property is used in the communication with the acquirer | The above mentioned additional properties in the response to the Create Payment request have been added generically. This means that they are also returned on a Get Payment request and all other requests that return a paymentOutput object. Please note that they are only returned in case of a 3-D Secure version 2 authentication. ## Additional information 1. [Introduction](https://docs.connect.worldline-solutions.com/services/3d-secure-version-2.md "Read more about 3-D Secure version 2") 2. [Highlevel implementation](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/implementation.md "Read more about 3-D Secure impact on the highlevel implementation & flows") 3. [Consumer user experience](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/consumer-ux.md "Read more about 3-D Secure impact on the user experience of the consumer") 4. [MyCheckout hosted payment pages implementation](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/mycheckout.md "Read more about 3-D Secure impact on the Create hostedCheckout API") 5. [Create Payment API implementation](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/payments-api.md "Read more about 3-D Secure impact on the Create Payment API") 6. [Test cases](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/test-cases.md "Read more about 3-D Secure test cases") 7. [Special use cases](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/special-cases.md "Read more about 3-D Secure special use cases") 8. **Webhooks**