SIsilverflow
3DS Authentication

Create 3DS Authentication

Create a new 3DS authentication. This endpoint can potentially trigger a 3DS challenge flow.

Requires the threeDs:Create permission.

Diners support is <a class="experimental-tag-link" href="https://docs.silverflow.com/guides/api-lifecycle#tag/EXPERIMENTAL-Tag"><span class="tag experimental-tag">EXPERIMENTAL</span></a>.

Standalone merchant info (merchantInfo) is <a class="experimental-tag-link" href="https://docs.silverflow.com/guides/api-lifecycle#tag/EXPERIMENTAL-Tag"><span class="tag experimental-tag">EXPERIMENTAL</span></a>.

post/3ds

Request

Request body

OR

Example request

{
  "merchantAcceptorKey": "mac-25oJsQ99GBpW23MQidKS",
  "card": {
    "cvc": "132",
    "holderName": "Joe Cardholder"
  },
  "amount": {
    "value": 1234,
    "currency": "EUR"
  },
  "authenticationContext": {
    "notificationUrl": "https://myserver.com/send/callback/here",
    "browserData": {
      "acceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
      "language": "nl-NL",
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36",
      "browserIP": "1.12.123.255",
      "screenWidth": "1536",
      "screenHeight": "724",
      "timeZoneOffset": "0",
      "javaEnabled": true,
      "colorDepth": "24"
    }
  },
  "transactionReference": "Dz3dIzE74EfH1HeTInyE",
  "dynamicDescriptor": {
    "merchantName": "Acme Inc."
  },
  "cardholderInformation": {
    "email": "carlos.somoza@gmail.com"
  },
  "threeDSServerTransID": "6357449a-b12b-4e81-b577-fee137273231",
  "billingAddress": {
    "countryCode": {
      "alpha3": "NLD"
    },
    "stateOrProvince": "NH",
    "city": "Amsterdam",
    "line1": "Langtown Road",
    "line2": "4200",
    "postalCode": "1234BC"
  },
  "shippingAddress": {
    "countryCode": {
      "alpha3": "NLD"
    },
    "stateOrProvince": "NH",
    "city": "Amsterdam",
    "line1": "Langtown Road",
    "line2": "4200",
    "postalCode": "1234BC"
  }
}

Response

The 3DS authentication entity

OR
OR
OR

Example response

{
  "key": "tds-2lCYLHDuRPW9MvQK3sd6",
  "merchantAcceptorRef": {
    "key": "{{acceptorKeyMastercard}}"
  },
  "merchantInfo": {
    "merchantCountryCode": {
      "alpha3": "NLD",
      "alpha2": "NL",
      "numeric": "528"
    }
  },
  "amount": {
    "value": 1234,
    "currency": "EUR"
  },
  "ares": {
    "sdkTransID": "6357449a-b12b-4e81-b577-fee137273136",
    "messageExtension": [
      {
        "name": "msgextname",
        "id": "501341592B_0001_4568"
      }
    ],
    "dsTransID": "c73bcdcc-2669-4bf6-81d3-e4ae73fb11fd",
    "acsTransID": "d7c1ee99-9478-44a6-b1f2-391e29c6b340",
    "threeDSServerTransID": "6357449a-b12b-4e81-b577-fee137273231",
    "acsURL": "https://www.acs.com/challenge\n",
    "acsSignedContent": "eyJhbGciOiJQUzI1NiIsIng1YyI6Ik1JSURlVENDQW1HZ0F3SUJ"
  },
  "transactionReference": "Dz3dIzE74EfH1HeTInyE"
}

Changes

No recorded changes to this operation across all 1 revision of this API.