> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uvvipay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter resultados 3DS

> Obtém o resultado final da autenticação 3DS após o challenge. Aceita header CLIENT-ID (integração API) ou PAYMENT-LINK-ID (checkout do link de pagamento).



## OpenAPI

````yaml POST /v1/3ds/authentication-results
openapi: 3.0.0
info:
  title: UvviPay Public API
  description: >-
    Endpoints públicos da plataforma UvviPay para integração de subcontas
    (submerchants).
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.uvvipay.com.br
    description: Produção
  - url: https://api-staging.uvvipay.com.br
    description: Staging
security:
  - client-id: []
    client-secret: []
tags: []
paths:
  /v1/3ds/authentication-results:
    post:
      tags:
        - 3DS
      summary: Obter resultados 3DS
      description: >-
        Obtém o resultado final da autenticação 3DS após o challenge. Aceita
        header CLIENT-ID (integração API) ou PAYMENT-LINK-ID (checkout do link
        de pagamento).
      operationId: threeDsAuthenticationResults
      parameters:
        - name: client-id
          in: header
          description: >-
            ID público da credencial do merchant (integração API). Mutuamente
            exclusivo com payment-link-id.
          required: false
          schema:
            type: string
        - name: payment-link-id
          in: header
          description: >-
            UUID do payment link (checkout público). Mutuamente exclusivo com
            client-id.
          required: false
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthenticationResultsRequestDto'
      responses:
        '200':
          description: Resultado da autenticação
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationResultsResponseDto'
        '400':
          description: Erro de validação
        '401':
          description: CLIENT-ID ou PAYMENT-LINK-ID inválido ou ausente
components:
  schemas:
    AuthenticationResultsRequestDto:
      type: object
      properties:
        token:
          type: string
          description: Access token obtido em /v1/3ds/generateToken
        token_challenge:
          type: string
          description: Token retornado após o challenge
          example: AxjzbwSTm0Nhm0SCFl4d/+MCT4triUCL2hcGlJKGTSTL0YtGZ6wLwAAA5hWN
        currency:
          type: string
          minLength: 3
          maxLength: 3
          example: BRL
        total_amount:
          type: integer
          minimum: 1
          example: 1050
        card:
          $ref: '#/components/schemas/CardInfoDto'
      required:
        - token
        - token_challenge
        - currency
        - total_amount
        - card
    AuthenticationResultsResponseDto:
      type: object
      properties:
        status:
          type: integer
          example: 200
        message:
          type: string
          example: SUCCESSFUL
        data:
          type: array
          items:
            $ref: '#/components/schemas/AuthenticationResultsDataDto'
        error:
          type: array
          items:
            type: object
          example:
            - {}
    CardInfoDto:
      type: object
      properties:
        number:
          type: string
          example: '4111111111111111'
        expiration_month:
          type: string
          minLength: 2
          maxLength: 2
          example: '12'
        expiration_year:
          type: string
          minLength: 4
          maxLength: 4
          example: '2029'
      required:
        - number
        - expiration_month
        - expiration_year
    AuthenticationResultsDataDto:
      type: object
      properties:
        status:
          type: string
          example: AUTHENTICATION_SUCCESSFUL
        token:
          type: string
        specification_version:
          type: string
          example: 2.2.0
        ucaf_collection_indicator:
          type: string
          example: '2'
        authentication_result:
          type: string
          example: '0'
        authentication_status_msg:
          type: string
          example: Success
        indicator:
          type: string
          example: spa
        eci:
          type: string
          example: '02'
        eci_raw:
          type: string
          example: '02'
        pares_status:
          type: string
          example: 'Y'
        ucaf_authentication_data:
          type: string
        ucaf:
          type: string
        directory_server_transaction_id:
          type: string
        three_d_s_server_transaction_id:
          type: string
        acs_transaction_id:
          type: string
        id:
          type: string
        client_reference_code:
          type: string
        submit_time_utc:
          type: string
          example: '2026-01-15T17:23:23Z'
        send_ds_date:
          type: number
        rec_ds_date:
          type: number
  securitySchemes:
    client-id:
      type: apiKey
      in: header
      name: client-id
    client-secret:
      type: apiKey
      in: header
      name: client-secret

````