---
title: "3D Secure - Special use cases"
canonical_url: https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/special-cases/
---

1. [Home](https://docs.connect.worldline-solutions.com/)
2. Best practices
3. Services
4. 3dsv2
5. [special-cases](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/special-cases.md)
6. 3D Secure - Special use cases

# Special use cases

## Using externally obtained authentication results

It is possble to submit external authentication results for both 3-D Secure version 1 and version 2 in your create Payment request. We'll then not perform an authentication, but we will use the data submitted by you directly in our authorization process.

### Examples

Create Payment request - External authentication 3-D Secure version 1

    POST /v1/70417/payments HTTP/1.1
    Authorization: GCS v1HMAC:2852fe598a84c2d8:Ch9sCYPdtpEh5BQKj08RoHXfTMPDg2uxaenyQBTOpV8=
    Date: Mon, 08 Jul 2019 23:32:15 GMT
    Content-Type: application/json
    Host: 10.63.66.100:20104
    Connection: close
    User-Agent: Paw/3.1.8 (Macintosh; OS X/10.14.5) GCDHTTPRequest
    Content-Length: 881

    {
      "cardPaymentMethodSpecificInput": {
        "card": {
          "cvv": "451",
          "cardNumber": "4012005616165343",
          "expiryDate": "1220",
          "cardholderName": "Wile E. Coyote"
        },
        "isRecurring": false,
        "paymentProductId": 1,
        "transactionChannel": "ECOMMERCE",
        "threeDSecure": {
          "externalCardholderAuthenticationData": {
            "cavv": "AAABBEg0VhI0VniQEjRWAAAAAAA=",
            "eci": "05",
            "xid": "000007041700000006220000100001"
          }
        }
      },
      "order": {
        "amountOfMoney": {
          "currencyCode": "EUR",
          "amount": 2980
        },
        "customer": {
          "billingAddress": {
            "countryCode": "NL"
          }
        },
        "references": {
          "merchantOrderId": 123456,
          "merchantReference": "WLSmESDvuf3jtOHCO0f3cAJgPBcbJI"
        }
      }
    }   

Create Payment response - External authentication 3-D Secure version 1

    {
       "creationOutput" : {
          "additionalReference" : "rohEA0gCrF60HubT3TWP",
          "externalReference" : "rohEA0gCrF60HubT3TWPiS4pjAx50R"
       },
       "payment" : {
          "id" : "000007041700000008250000100001",
          "paymentOutput" : {
             "amountOfMoney" : {
                "amount" : 2980,
                "currencyCode" : "EUR"
             },
             "references" : {
                "merchantOrderId" : 123456,
                "merchantReference" : "rohEA0gCrF60HubT3TWPiS4pjAx50R",
                "paymentReference" : "0"
             },
             "paymentMethod" : "card",
             "cardPaymentMethodSpecificOutput" : {
                "paymentProductId" : 1,
                "fraudResults" : {
                   "fraudServiceResult" : "no-advice",
                   "avsResult" : "0",
                   "cvvResult" : "0"
                },
                "threeDSecureResults" : {
                   "cavv" : "AAABBEg0VhI0VniQEjRWAAAAAAA=",
                   "eci" : "5",
                   "xid" : "000007041700000006220000100001"
                },
                "card" : {
                   "cardNumber" : "************5343",
                   "expiryDate" : "1220"
                }
             }
          },
          "status" : "PENDING_APPROVAL",
          "statusOutput" : {
             "isCancellable" : true,
             "statusCategory" : "PENDING_MERCHANT",
             "statusCode" : 600,
             "statusCodeChangeDateTime" : "20190708212550",
             "isAuthorized" : true,
             "isRefundable" : false
          }
       }
    }   

Create Payment request - External authentication 3-D Secure version 2

    POST /v1/70417/payments HTTP/1.1
    Authorization: GCS v1HMAC:2852fe598a84c2d8:EJX8ONPhufbSORaA6CwIylgzkxxaRNd/JUael7wEI7k=
    Date: Mon, 08 Jul 2019 23:30:33 GMT
    Content-Type: application/json
    Host: 10.63.66.100:20104
    Connection: close
    User-Agent: Paw/3.1.8 (Macintosh; OS X/10.14.5) GCDHTTPRequest
    Content-Length: 1028

    {
      "cardPaymentMethodSpecificInput": {
        "card": {
          "cvv": "451",
          "cardNumber": "4012005616165343",
          "expiryDate": "1220",
          "cardholderName": "Wile E. Coyote"
        },
        "isRecurring": false,
        "paymentProductId": 1,
        "transactionChannel": "ECOMMERCE",
        "threeDSecure": {
          "externalCardholderAuthenticationData": {
          	"cavv" : "AAABBEg0VhI0VniQEjRWAAAAAAA=",
          	"directoryServerTransactionId" : "f25084f0-5b16-4c0a-ae5d-b24808a95e4b",
          	"eci" : "05",
          	"threeDSecureVersion" : "2.1.0"
    	}
        }
      },
      "order": {
        "amountOfMoney": {
          "currencyCode": "EUR",
          "amount": 2980
        },
        "customer": {
          "billingAddress": {
            "countryCode": "NL"
          }
        },
        "references": {
          "merchantOrderId": 123456,
          "merchantReference": "oGPc8xJURfpFitBa6ORrpkBuPoGpvD"
        }
      }
    }   

Create Payment response - External authentication 3-D Secure version 2

    HTTP/1.1 201 
    Location: http://10.63.66.100:20104/v1/70417/payments/000007041700000008210000100001
    Content-Type: application/json;charset=UTF-8
    Transfer-Encoding: chunked
    Date: Mon, 08 Jul 2019 19:50:58 GMT
    Connection: close

    {
       "creationOutput" : {
          "additionalReference" : "VjM0O0U7BOE3brdOK0Ec",
          "externalReference" : "VjM0O0U7BOE3brdOK0Ecik4VAuJlUJ"
       },
       "payment" : {
          "id" : "000007041700000008210000100001",
          "paymentOutput" : {
             "amountOfMoney" : {
                "amount" : 2980,
                "currencyCode" : "EUR"
             },
             "references" : {
                "merchantOrderId" : 123456,
                "merchantReference" : "VjM0O0U7BOE3brdOK0Ecik4VAuJlUJ",
                "paymentReference" : "0"
             },
             "paymentMethod" : "card",
             "cardPaymentMethodSpecificOutput" : {
                "paymentProductId" : 1,
                "fraudResults" : {
                   "fraudServiceResult" : "no-advice",
                   "avsResult" : "0",
                   "cvvResult" : "0"
                },
                "threeDSecureResults" : {
                   "cavv" : "AAABBEg0VhI0VniQEjRWAAAAAAA=",
                   "eci" : "05",
                   "threeDSecureVersion" : "2.1.0"
                },
                "card" : {
                   "cardNumber" : "************5343",
                   "expiryDate" : "1220"
                }
             }
          },
          "status" : "PENDING_APPROVAL",
          "statusOutput" : {
             "isCancellable" : true,
             "statusCategory" : "PENDING_MERCHANT",
             "statusCode" : 600,
             "statusCodeChangeDateTime" : "20190708195058",
             "isAuthorized" : true,
             "isRefundable" : false
          }
       }
    }   

## 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**
8. [Webhooks](https://docs.connect.worldline-solutions.com/best-practices/services/3dsv2/webhooks.md "Read more about 3-D Secure version 2 impact on webhooks")