Silverflow

Silverflow 3DS Authentication API

3DS Authentication Endpoints

Documentation GitHub OpenAPI

Business capability

Card Transaction Processing Management BC-1340.70

Operations 5

POST /3ds Create 3DS Authentication #

GET /3ds List 3DS Authentications #

POST /3ds/3ri Create 3RI Authentication #

GET /3ds/{threedsKey} Get 3DS Authentication #

POST /3ds/cardRanges Retrieve Card Ranges #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/silverflow-3ds-authentication-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Silverflow 3DS Authentication API
  version: 1.417.0
  contact:
    name: API Support
    email: support@silverflow.com
  license:
    name: Commercial
  description: 'Operations tagged 3DS Authentication across 2 of this provider''s published API definitions: silverflow-openapi.yml, silverflow-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://eu-west-1.api.silverflow.com/v1
  description: Production URL for Europe - Equivalent to https://api.silverflow.co/v1
- url: https://us-east-2.api.silverflow.com/v1
  description: Production URL for North America
- url: https://eu-west-1.api-sbx.silverflow.com/v1
  description: Sandbox URL - Equivalent to https://api-sbx.silverflow.co/v1
security:
- ApiKey: []
- BearerToken: []
tags:
- name: 3DS Authentication
  description: 3DS Authentication Endpoints
paths:
  /3ds:
    post:
      operationId: create3dsAuthentication
      summary: Create 3DS Authentication
      description: '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>.

        '
      tags:
      - 3DS Authentication
      requestBody:
        description: 'Create a 3DS authentication.

          '
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicCreate3dsRequest'
            examples:
              threeDsWithMerchantAcceptor:
                $ref: '#/components/examples/ThreeDsRequestWithMerchantAcceptorExample'
              threeDsWithMerchantInfo:
                $ref: '#/components/examples/ThreeDsRequestWithMerchantInfoExample'
      responses:
        '201':
          description: The 3DS authentication entity
          headers:
            Location:
              description: The URL of the newly created 3DS authentication
              schema:
                type: string
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/ThreeDsFrictionlessAuthenticated'
                - $ref: '#/components/schemas/ThreeDsChallenge'
                - $ref: '#/components/schemas/ThreeDsNoFlowNoAuth'
                - $ref: '#/components/schemas/ThreeDsDataOnly'
              examples:
                challenge:
                  $ref: '#/components/examples/ThreeDsFrictionlessResponseWithMerchantAcceptorExample'
                frictionless:
                  $ref: '#/components/examples/ThreeDsChallengeResponseWithMerchantAcceptorExample'
                frictionlessWithMerchantInfo:
                  $ref: '#/components/examples/ThreeDsFrictionlessResponseWithMerchantInfoExample'
                challengeWithMerchantInfo:
                  $ref: '#/components/examples/ThreeDsChallengeResponseWithMerchantInfoExample'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/InvalidRequestErrorDetails'
                - $ref: '#/components/schemas/schemas-InvalidInputErrorDetails'
              examples:
                InvalidRequestErrorExample:
                  $ref: '#/components/examples/InvalidRequestExample'
                InvalidInputErrorExample:
                  $ref: '#/components/examples/InvalidInputErrorExample'
        '401':
          $ref: '#/components/responses/components-responses-UnauthorizedError'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/ReferencedEntityNotFoundErrorDetails'
                - $ref: '#/components/schemas/UnsupportedCardNetworkErrorDetails'
                - $ref: '#/components/schemas/UnsupportedCardNetworkRegionErrorDetails'
              examples:
                ReferencedEntityNotFoundErrorExample:
                  $ref: '#/components/examples/ReferencedEntityNotFoundErrorExample'
                UnsupportedCardNetwork:
                  $ref: '#/components/examples/UnsupportedCardNetwork'
                UnsupportedCardNetworkRegion:
                  $ref: '#/components/examples/UnsupportedCardNetworkRegion'
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/UnsupportedProtocolVersionErrorDetails'
                - $ref: '#/components/schemas/UnenrolledAccountNumberErrorDetails'
                - $ref: '#/components/schemas/UnenrolledAcquireOrMerchantErrorDetails'
              examples:
                UnsupportedProtocolVersionCardExample:
                  $ref: '#/components/examples/UnsupportedProtocolVersionCardExample'
                UnenrolledAccountNumberExample:
                  $ref: '#/components/examples/UnenrolledAccountNumberExample'
                UnenrolledAcquireOrMerchantExample:
                  $ref: '#/components/examples/UnenrolledAcquireOrMerchantExample'
        '429':
          $ref: '#/components/responses/components-responses-TooManyRequestsError'
        '500':
          $ref: '#/components/responses/InternalServerError'
    get:
      operationId: get3dsAuthentications
      summary: List 3DS Authentications
      description: 'List 3DS transactions. 3DS authentications returned from this endpoint

        will never have the `authenticationValue` property in either `ares` or `rreq` properties.


        Requires the `threeDs:List` permission.

        '
      tags:
      - 3DS Authentication
      parameters:
      - $ref: '#/components/parameters/parameters-offsetToken'
      - $ref: '#/components/parameters/sortOrder'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: A (paged) list of 3DS authentications.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/threeDsPage'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidOffsetTokenErrorDetails'
              examples:
                InvalidOffsetToken:
                  $ref: '#/components/examples/InvalidOffsetTokenExample'
        '401':
          $ref: '#/components/responses/components-responses-UnauthorizedError'
        '429':
          $ref: '#/components/responses/components-responses-TooManyRequestsError'
        '500':
          $ref: '#/components/responses/InternalServerError'
    servers:
    - url: https://eu-west-1.api.silverflow.com/v1
      description: Production URL for Europe - Equivalent to https://api.silverflow.co/v1
    - url: https://us-east-2.api.silverflow.com/v1
      description: Production URL for North America
    - url: https://eu-west-1.api-sbx.silverflow.com/v1
      description: Sandbox URL - Equivalent to https://api-sbx.silverflow.co/v1
  /3ds/3ri:
    post:
      operationId: create3riAuthentication
      summary: Create 3RI Authentication
      description: "Create a new 3RI authentication. Also known as merchant-initiated authentications, allows merchants to authenticate a transaction without the direct involvement of the cardholder.\n\nRequires the `threeDs:Create` permission.\n\nDiners 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>. \n\nStandalone 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>.\n"
      tags:
      - 3DS Authentication
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ThreeRiRequest'
            examples:
              threeRiWithMerchantAcceptor:
                $ref: '#/components/examples/RequestWithMerchantAcceptor'
              threeRiWithMerchantInfo:
                $ref: '#/components/examples/RequestWithMerchantInfo'
      responses:
        '201':
          description: The 3RI authentication entity
          headers:
            Location:
              description: The URL of the newly created 3RI authentication
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThreeRiResponse'
              examples:
                authenticated:
                  $ref: '#/components/examples/ResponseWithMerchantAcceptor'
                authenticatedWithMerchantInfo:
                  $ref: '#/components/examples/ResponseWithMerchantInfo'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/InvalidRequestErrorDetails'
                - $ref: '#/components/schemas/schemas-InvalidInputErrorDetails'
              examples:
                InvalidRequestErrorExample:
                  $ref: '#/components/examples/InvalidRequestExample'
                InvalidInputErrorExample:
                  $ref: '#/components/examples/InvalidInputErrorExample'
        '401':
          $ref: '#/components/responses/components-responses-UnauthorizedError'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/ReferencedEntityNotFoundErrorDetails'
                - $ref: '#/components/schemas/UnsupportedCardNetworkErrorDetails'
                - $ref: '#/components/schemas/UnsupportedCardNetworkRegionErrorDetails'
              examples:
                ReferencedEntityNotFoundErrorExample:
                  $ref: '#/components/examples/ReferencedEntityNotFoundErrorExample'
                UnsupportedCardNetwork:
                  $ref: '#/components/examples/UnsupportedCardNetwork'
                UnsupportedCardNetworkRegion:
                  $ref: '#/components/examples/UnsupportedCardNetworkRegion'
        '422':
          description: Unprocessable Content
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/UnsupportedProtocolVersionErrorDetails'
                - $ref: '#/components/schemas/UnenrolledAccountNumberErrorDetails'
                - $ref: '#/components/schemas/UnenrolledAcquireOrMerchantErrorDetails'
              examples:
                UnsupportedProtocolVersion3riExample:
                  $ref: '#/components/examples/UnsupportedProtocolVersion3riExample'
                UnsupportedProtocolVersionCardExample:
                  $ref: '#/components/examples/UnsupportedProtocolVersionCardExample'
                UnenrolledAccountNumberExample:
                  $ref: '#/components/examples/UnenrolledAccountNumberExample'
                UnenrolledAcquireOrMerchantExample:
                  $ref: '#/components/examples/UnenrolledAcquireOrMerchantExample'
        '429':
          $ref: '#/components/responses/components-responses-TooManyRequestsError'
        '500':
          $ref: '#/components/responses/InternalServerError'
    servers:
    - url: https://eu-west-1.api.silverflow.com/v1
      description: Production URL for Europe - Equivalent to https://api.silverflow.co/v1
    - url: https://us-east-2.api.silverflow.com/v1
      description: Production URL for North America
    - url: https://eu-west-1.api-sbx.silverflow.com/v1
      description: Sandbox URL - Equivalent to https://api-sbx.silverflow.co/v1
  /3ds/{threedsKey}:
    get:
      operationId: get3dsAuthentication
      summary: Get 3DS Authentication
      description: 'Returns the 3DS authentication indentified by the key.


        Requires `threeDs:Get` permission.

        '
      tags:
      - 3DS Authentication
      parameters:
      - $ref: '#/components/parameters/threedsKey'
      responses:
        '200':
          description: The 3DS authentication
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThreeDs'
              examples:
                frictionlessWithMerchantAcceptor:
                  $ref: '#/components/examples/ThreeDsFrictionlessResponseWithMerchantAcceptorExample'
                challengeWithMerchantAcceptor:
                  $ref: '#/components/examples/ThreeDsChallengeResponseWithMerchantAcceptorExample'
                authenticatedChallengeWithMerchantAcceptor:
                  $ref: '#/components/examples/ThreeDsAuthenticatedChallengeResponseWithMerchantAcceptorExample'
                threeRiWithMerchantAcceptor:
                  $ref: '#/components/examples/ResponseWithMerchantAcceptor'
                frictionlessWithMerchantInfo:
                  $ref: '#/components/examples/ThreeDsFrictionlessResponseWithMerchantInfoExample'
                challengeWithMerchantInfo:
                  $ref: '#/components/examples/ThreeDsChallengeResponseWithMerchantInfoExample'
                authenticatedChallengeWithMerchantInfo:
                  $ref: '#/components/examples/ThreeDsAuthenticatedChallengeResponseWithMerchantInfoExample'
                threeRiWithMerchantInfo:
                  $ref: '#/components/examples/ResponseWithMerchantInfo'
        '401':
          $ref: '#/components/responses/components-responses-UnauthorizedError'
        '404':
          description: Entity not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityNotFoundErrorDetails'
              examples:
                InternalServerErrorExample:
                  $ref: '#/components/examples/EntityNotFoundExample'
        '429':
          $ref: '#/components/responses/components-responses-TooManyRequestsError'
        '500':
          $ref: '#/components/responses/InternalServerError'
    servers:
    - url: https://eu-west-1.api.silverflow.com/v1
      description: Production URL for Europe - Equivalent to https://api.silverflow.co/v1
    - url: https://us-east-2.api.silverflow.com/v1
      description: Production URL for North America
    - url: https://eu-west-1.api-sbx.silverflow.com/v1
      description: Sandbox URL - Equivalent to https://api-sbx.silverflow.co/v1
  /3ds/cardRanges:
    post:
      operationId: 3dsCardRanges
      summary: Retrieve Card Ranges
      description: 'Obtain information about which 3DS versions and features are supported for the given PAN. In case of co-branded cards information from both brands is retrieved.


        Requires `threeDs:Create` permission.

        '
      tags:
      - 3DS Authentication
      requestBody:
        description: 'Details of the PAN to retrieve information about.

          '
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ThreeDsCardRangesRequest'
            examples:
              withoutNetwork:
                $ref: '#/components/examples/Request'
      responses:
        '200':
          description: PAN information.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ThreeDsCardRangesResponse'
              examples:
                withoutNetwork:
                  $ref: '#/components/examples/Response'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/InvalidRequestErrorDetails'
                - $ref: '#/components/schemas/schemas-InvalidInputErrorDetails'
              examples:
                InvalidRequestErrorExample:
                  $ref: '#/components/examples/InvalidRequestExample'
                InvalidInputErrorExample:
                  $ref: '#/components/examples/InvalidInputErrorExample'
        '401':
          $ref: '#/components/responses/components-responses-UnauthorizedError'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferencedEntityNotFoundErrorDetails'
              examples:
                ReferencedEntityNotFoundErrorExample:
                  $ref: '#/components/examples/ReferencedEntityNotFoundErrorExample'
        '429':
          $ref: '#/components/responses/components-responses-TooManyRequestsError'
        '500':
          $ref: '#/components/responses/InternalServerError'
    servers:
    - url: https://eu-west-1.api.silverflow.com/v1
      description: Production URL for Europe - Equivalent to https://api.silverflow.co/v1
    - url: https://us-east-2.api.silverflow.com/v1
      description: Production URL for North America
    - url: https://eu-west-1.api-sbx.silverflow.com/v1
      description: Sandbox URL - Equivalent to https://api-sbx.silverflow.co/v1
components:
  examples:
    UnsupportedProtocolVersionCardExample:
      summary: The account number does not support the supported 3DS versions
      value:
        type: /silverflow/problems/3ds/unsupported-protocol-version
        title: Unsupported Protocol Version
        status: 422
        detail: 'Provided account number is not enrolled for any of the supported 3DS protocol versions: ["2.1.0", "2.2.0"]'
        instance: /silverflow/e21c1a9d-f66d-4ef7-9f5d-d48064a2bb5e
    Response:
      summary: Response to simple request to get card number's information.
      value:
      - network: bancontact
        startRange: '4500000000000001'
        endRange: '4500000000009999'
        acsStartProtocolVersion: 2.2.0
        acsEndProtocolVersion: 2.2.0
        dsStartProtocolVersion: 2.2.0
        dsEndProtocolVersion: 2.2.0
        threeDSMethodURL: string
        acsInfoIndicator:
        - '01'
        - '02'
        - '10'
        - '11'
      - network: visa
        startRange: '4500000000000001'
        endRange: '4500000000009999'
        acsStartProtocolVersion: 2.2.0
        acsEndProtocolVersion: 2.2.0
        dsStartProtocolVersion: 2.2.0
        dsEndProtocolVersion: 2.2.0
        threeDSMethodURL: threeDsMethodUrl
        acsInfoIndicator:
        - '01'
        - '02'
        - 09
        - '10'
    ThreeDsRequestWithMerchantAcceptorExample:
      summary: Initiating a 3DS authentication with merchant acceptor
      value:
        merchantAcceptorKey: mac-25oJsQ99GBpW23MQidKS
        card:
          number: '4200350000000801'
          expiryYear: 2023
          expiryMonth: 12
          holderName: Joe Cardholder
        type:
          intent: purchase
          cardEntry: e-commerce
          order: checkout
        amount:
          value: 30000
          currency: EUR
        cardholderInformation:
          email: carlos.somoza@gmail.com
          phone:
            work:
              number: 063012345678
              countryCode: '031'
            mobile:
              number: 063012344579
              countryCode: '031'
        billingAddress:
          countryCode:
            alpha3: NLD
          stateOrProvince: NH
          city: Amsterdam
          line1: Langtown Road
          line2: '4200'
          postalCode: 1234BC
        transactionReference: FR1
        authenticationContext:
          notificationUrl: https://www.merchant-shop.com/notify
          browserData:
            acceptHeader: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
            javascriptEnabled: true
            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
            screenWidth: '1536'
            screenHeight: '723'
            javaEnabled: true
            colorDepth: '24'
            timeZoneOffset: '0'
            browserIP: 123.123.123.123
    RequestWithMerchantAcceptor:
      summary: Initiating a 3RI authentication with merchant acceptor
      value:
        merchantAcceptorResolver:
          merchantAcceptorKey: mac-25oJsQ99GBpWjcMQidKS
        card:
          number: '4200350000000801'
          expiryYear: 2023
          expiryMonth: 12
          holderName: Joe Cardholder
        threeRiIndicator: recurring
        amount:
          value: 30000
          currency: EUR
        cardholderInformation:
          email: carlos.somoza@gmail.com
          phone:
            work:
              number: 063012345678
              countryCode: '031'
            mobile:
              number: 063012344579
              countryCode: '031'
        billingAddress:
          countryCode:
            alpha2: NL
          stateOrProvince: NH
          city: Amsterdam
          line1: Langtown Road
          line2: '4200'
          postalCode: 1234BC
        transactionReference: FR1
        recurringExpiry: '2024-03-10'
        recurringFrequency: 30
        threeDsPriorAuthenticationInfo:
          authMethod: challenge
          dateTime: '2022-06-15T14:30:00.000+00:00'
          acsTransId: 2385d219-0f19-4e82-a318-511f249c6c21
          dsTransId: 043cff46-f694-432a-863b-0338511dc420
    InvalidInputErrorExample:
      summary: The request was invalid
      value:
        type: /silverflow/problems/invalid-input
        title: Invalid Input
        status: 400
        detail: The request does not adhere to the defined API schema.
        instance: /silverflow/184b44aa-33a4-4244-9074-5eb49715aa90
        validationErrors:
        - path: /body/card/number
          errorCode: required.openapi.validation
          message: must match pattern "^[0-9]+$"
    ThreeDsChallengeResponseWithMerchantInfoExample:
      summary: The 3DS response in case of a challenge flow with standalone merchant info
      value:
        key: tds-5pCQR03sTuUcXGE59fLV
        merchantInfo:
          acquirerBin: '123456'
          merchantId: MERCHANT123
          mcc: '5411'
          merchantName: Example Store Inc
          merchantCountryCode:
            alpha2: NL
            alpha3: NLD
            numeric: '528'
          websiteUrl: https://example.com
          network: visa
        amount:
          value: 30000
          currency: EUR
        network: visa
        protocolVersion: 2.2.0
        deviceChannel: browser
        flow: challenge
        result: challenge
        ares:
          messageType: ARes
          transStatus: C
          acsChallengeMandated: Y
          acsURL: https://issuera-acs.com/challenge
          threeDSServerTransID: 2b4d6f8a-0c2e-4a6c-8e0b-4f6a8c0e2b4d
          messageVersion: 2.2.0
          dsTransID: 6d8f0b2d-4e6a-4d0f-9c1b-7f9b1d3f5e7a
          acsTransID: 2f4a6c8e-0a2c-4e8a-b0c2-6a8c0a2e4f6c
          acsReferenceNumber: 3DS_ACS_REF_NUM
          acsOperatorID: AcsOpId-123456
          dsReferenceNumber: DS_LOA_12345-1234
          authenticationType: '01'
        transactionReference: FR1
        type:
          intent: purchase
          order: checkout
        created: '2022-06-16T09:50:12.201+00:00'
        version: 1
    ReferencedEntityNotFoundErrorExample:
      summary: A referenced entity was not found
      value:
        type: /silverflow/problems/referenced-entity-not-found
        title: Referenced Entity Not Found
        status: 409
        detail: The referenced acceptor with key 'mac-1eOdAHhgstYTUhlphPFf' was not found.
        instance: /silverflow/b0451a9d-f66d-4ef7-9f5d-d48064a2bb3e
    ThreeDsFrictionlessResponseWithMerchantInfoExample:
      summary: The 3DS response in case of a frictionless flow with standalone merchant info
      value:
        key: tds-4nBPQ92rYsTbWFD48eKU
        merchantInfo:
          acquirerBin: '123456'
          merchantId: MERCHANT123
          mcc: '5411'
          merchantName: Example Store Inc
          merchantCountryCode:
            alpha2: NL
            alpha3: NLD
            numeric: '528'
          websiteUrl: https://example.com
          network: visa
        amount:
          value: 30000
          currency: EUR
        network: visa
        protocolVersion: 2.2.0
        deviceChannel: browser
        flow: frictionless
        result: authenticated
        ares:
          messageType: ARes
          transStatus: Y
          threeDSServerTransID: 9a1b3c5e-7f2d-4e8b-b6a0-2d4f6c8e0a12
          messageVersion: 2.2.0
          dsTransID: 5c7e9a1b-3d5f-4c2e-8b0a-6e8c0a2b4d6f
          acsTransID: 1e3a5c7b-9d1f-4b6e-a2c4-8e0a2c4e6a8c
          dsReferenceNumber: DS_LOA_12345-1234
          acsReferenceNumber: 3DS_ACS_REF_NUM
          acsOperatorID: AcsOpId-123456
          authenticationValue: AUTHENTICATION_VALUE
          eci: '05'
        transactionReference: FR1
        type:
          intent: purchase
          order: checkout
        created: '2022-06-16T09:49:42.757+00:00'
        version: 1
    EntityNotFoundExample:
      summary: The entity was not found
      value:
        status: 404
        type: /silverflow/problems/3ds/not-found
        title: Not Found
        detail: The threeDs with key 'tds-1234abc' was not found.
        instance: /silverflow/5a276b24-4c46-4c73-beb4-462a7c08f941
    AuthenticationRequiredExample:
      summary: Invalid credentials
      value:
        type: /silverflow/problems/authentication-required
        title: Authentication Required
        status: 401
        detail: Authentication Required
        instance: /silverflow/8e445b2e-d745-4b38-a38d-781fc998e442
    ThreeDsRequestWithMerchantInfoExample:
      summary: Initiating a 3DS authentication with standalone merchant info
      value:
        merchantInfo:
          acquirerBin: '123456'
          merchantId: MERCHANT123
          mcc: '5411'
          merchantName: Example Store Inc
          merchantCountryCode:
            alpha2: NL
          websiteUrl: https://example.com
          network: visa
        card:
          number: '4200350000000801'
          expiryYear: 2023
          expiryMonth: 12
          holderName: Joe Cardholder
        type:
          intent: purchase
          cardEntry: e-commerce
          order: checkout
        amount:
          value: 30000
          currency: EUR
        cardholderInformation:
          email: carlos.somoza@gmail.com
          phone:
            work:
              number: 063012345678
              countryCode: '031'
            mobile:
              number: 063012344579
              countryCode: '031'
        billingAddress:
          countryCode:
            alpha3: NLD
          stateOrProvince: NH
          city: Amsterdam
          line1: Langtown Road
          line2: '4200'
          postalCode: 1234BC
        transactionReference: FR1
        authenticationContext:
          notificationUrl: https://www.merchant-shop.com/notify
          browserData:
            acceptHeader: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
            javascriptEnabled: true
            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
            screenWidth: '1536'
            screenHeight: '723'
            javaEnabled: true
            colorDepth: '24'
            timeZoneOffset: '0'
            browserIP: 123.123.123.123
    UnsupportedProtocolVersion3riExample:
      summary: The account number does not support 3RI
      value:
        type: /silverflow/problems/3ds/unsupported-protocol-version
        title: Unsupported Protocol Version
        status: 422
        detail: 3RI authentication is only possible when the enrolled card number supports version 2.2.0 or higher. Please submit the transaction directly for authorization.
        instance: /silverflow/b0451a9d-f66d-4ef7-9f5d-d48064a2bb3e
    UnenrolledAccountNumberExample:
      summary: The account number is not enrolled for 3DS
      value:
        type: /silverflow/problems/3ds/unenrolled-account-number
        title: Unenrolled Account Number
        status: 422
        detail: The account number provided in 'card.number' is not enrolled for 3DS authentication.
        instance: /silverflow/e21c1a9d-f66d-4ef7-9f5d-d48064a2bb5e
    UnenrolledAcquireOrMerchantExample:
      summary: The acquirer or merchant is not enrolled for 3DS
      value:
        type: /silverflow/problems/3ds/unenrolled-acquirer-or-merchant
        title: Unenrolled Acquirer or Merchant
        status: 422
        detail: The acquirer or merchant has not been enrolled for 3D Secure authentication.
        instance: /silverflow/e1451a9d-f66d-4ef7-9f5d-d48064a5bb2c
    ResponseWithMerchantAcceptor:
      summary: The 3DS 3RI authenticated response
      value:
        key: tds-2lCYA85kxQaWoER37cJS
        merchantAcceptorRef:
          key: mac-25oJsQ99GBpWjcMQidKS
          version: 1
        amount:
          value: 30000
          currency: EUR
        network: visa
        protocolVersion: 2.2.0
        deviceChannel: 3ri
        result: authenticated
        fraudLiability: issuer
        threeRiIndicator: recurring
        ares:
          messageType: ARes
          transStatus: Y
          threeDSServerTransID: 54c64c00-eef8-4a8b-af44-fee8cc57e530
          messageVersion: 2.2.0
          dsTransID: 043cff46-f694-432a-863b-0338511dc420
          acsTransID: 2385d219-0f19-4e82-a318-511f249c6c21
          dsReferenceNumber: DS_LOA_12345-1234
          acsReferenceNumber: 3DS_ACS_REF_NUM
          acsOperatorID: AcsOpId-123456
          authenticationValue: AUTHENTICATION_VALUE
          eci: '05'
        transactionReference: FR1
        created: '2022-06-16T09:49:42.757+00:00'
        version: 1
    ThreeDsFrictionlessResponseWithMerchantAcceptorExample:
      summary: The 3DS response in case of a frictionless flow
      value:
        key: tds-2lCYA85kxQaWoER37cJS
        merchantAcceptorRef:
          key: mac-25oJsQ99GBpWjcMQidKS
          version: 1
        amount:
          value: 30000
          currency: EUR
        network: visa
        protocolVersion: 2.2.0
        deviceChannel: browser
        flow: frictionless
        result: authenticated
        ares:
          messageType: ARes
          transStatus: Y
          threeDSServerTransID: 54c64c00-eef8-4a8b-af44-fee8cc57e530
          messageVersion: 2.2.0
          dsTransID: 043cff46-f694-432a-863b-0338511dc420
          acsTransID: 2385d219-0f19-4e82-a318-511f249c6c21
          dsReferenceNumber: DS_LOA_12345-1234
          acsReferenceNumber: 3DS_ACS_REF_NUM
          acsOperatorID: AcsOpId-123456
          authenticationValue: AUTHENTICATION_VALUE
          eci: '05'
        transactionReference: FR1
        type:
          intent: purchase
          order: checkout
        created: '2022-06-16T09:49:42.757+00:00'
        version: 1
    UnsupportedCardNetworkRegion:
      summary: Unsupported region for the given card network
      value:
        type: /silverflow/problems/3ds/unsupported-card-network-region
        title: Unsupported Region for this Card Network
        status: 409
        detail: 'Amex Direct Merchant model not supported for country ''ATA'' (from merchant.registeredAddress.countryCode.alpha3). Supported regions: USA, CAN, MEX, ARG, EMEA, JAPA. Update merchant address or contact support.'
        instance: /silverflow/e21c1a9d-f66d-4ef7-9f5d-d48064a2bb5e
    InternalServerErrorExample:
      summary: Internal server error
      value:
        status: 500
        type: /silverflow/problems/internal-server-error
        title: Internal Server Error
        detail: The server encountered an unexpected condition.
        instance: /silverflow/9cb3486d-4fca-495b-91f2-218b669c3aa6
    UnsupportedCardNetwork:
      summary: Unsupported card network
      value:
        type: /silverflow/problems/3ds/unsupported-card-network
        title: Unsupported Card Network
        status: 409
        detail: 'Merchant 

# --- truncated at 32 KB (134 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/silverflow/refs/heads/main/openapi/silverflow-3ds-authentication-api-openapi.yml