> ## Documentation Index
> Fetch the complete documentation index at: https://alyte.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Export recorded authority and purchase evidence for an Alyte payment

> Read-only evidence for an authorised-purchase denial. Comparisons are reconstructed from records; transaction authentication is returned only when recorded and bound to this payment. Includes general PSP field guidance and explicit gaps, not case-specific requirements or a submission payload. The merchant assembles and submits its dispute response.



## OpenAPI

````yaml https://app.alytegen.com/openapi.public.json get /v1/integration/payments/{intentId}/dispute-evidence
openapi: 3.1.0
info:
  title: Alyte API
  description: >-
    Secure agentic checkout for live-events ticketing. REST is the canonical
    surface; MCP/A2A are adapters over the same orchestrator.
  version: 1.0.0
servers:
  - url: /
    description: this instance
security:
  - bearerAuth: []
tags:
  - name: catalog
    description: Shop / event / tier discovery
  - name: ticketing
    description: 'The purchase spine: quote → reserve → confirm'
  - name: payments
    description: One-shot authorize + result reads
  - name: acp
    description: Agentic Commerce Protocol — checkout sessions (OpenAI ACP conformance)
  - name: vic
    description: >-
      Visa Intelligent Commerce — mandate-governed purchase-initiate (the VIC
      mandate is the spend authority)
  - name: signed-mandate
    description: >-
      Network signed-mandate (VIC / Mastercard Agent Pay shape) — a detached
      network signature over the mandate artefact is verified with real crypto
      before the spend authority is granted
  - name: ap2
    description: Legacy AP2 purchase — unsupported pending verified checkout authorization
  - name: buyer
    description: >-
      Buyer surface — magic-link identity, bring/create agents, card capture
      (PSP iframe), and mandates whose scope is locked server-side to the shop
      the session is for
  - name: discovery
    description: >-
      PUBLIC discovery (no auth) — the opt-in shop window + the ACP product
      feed. Only shops that flipped `discoverable` appear; everything else 404s.
  - name: protocols
    description: Protocol adapters (MCP / A2A) over the same orchestrator as REST
  - name: integration
    description: >-
      Server-to-server merchant integration (API token) — e.g. minting buyer
      sessions for users the MERCHANT'S own auth has already verified
paths:
  /v1/integration/payments/{intentId}/dispute-evidence:
    get:
      tags:
        - integration
      summary: Export recorded authority and purchase evidence for an Alyte payment
      description: >-
        Read-only evidence for an authorised-purchase denial. Comparisons are
        reconstructed from records; transaction authentication is returned only
        when recorded and bound to this payment. Includes general PSP field
        guidance and explicit gaps, not case-specific requirements or a
        submission payload. The merchant assembles and submits its dispute
        response.
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
          in: path
          name: intentId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  schemaVersion:
                    type: string
                    enum:
                      - alyte.dispute_evidence.v2
                  observedAt:
                    type: string
                    format: date-time
                  tenantId:
                    type: string
                  intentId:
                    type: string
                  merchantId:
                    type: string
                  agentId:
                    type: string
                  purpose:
                    type: string
                    enum:
                      - authorised_purchase_denied
                  payment:
                    type: object
                    properties:
                      amountMinor:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      currency:
                        type: string
                      scheme:
                        type: string
                      createdAt:
                        type: string
                        format: date-time
                      status:
                        type: string
                        enum:
                          - authorized
                          - declined
                          - error
                          - pending
                          - unavailable
                      paymentState:
                        type:
                          - 'null'
                          - string
                        enum:
                          - authorization_pending
                          - capture_pending
                          - requires_action
                          - captured
                          - declined
                          - reconciliation_required
                      pspId:
                        type:
                          - 'null'
                          - string
                      pspTransactionId:
                        type:
                          - 'null'
                          - string
                      captureEvidence:
                        type: string
                        enum:
                          - recorded
                          - unavailable
                    required:
                      - amountMinor
                      - currency
                      - scheme
                      - createdAt
                      - status
                      - paymentState
                      - pspId
                      - pspTransactionId
                      - captureEvidence
                  authority:
                    type: object
                    properties:
                      binding:
                        type: string
                        enum:
                          - exact_mandate
                          - unavailable
                      mandateId:
                        type:
                          - 'null'
                          - string
                    required:
                      - binding
                      - mandateId
                  permission:
                    anyOf:
                      - type: object
                        properties:
                          mandateId:
                            type: string
                          grantedAt:
                            type: string
                            format: date-time
                          eventSequence:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            maximum: 9007199254740991
                          capMinor:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          currency:
                            type: string
                          expiresAt:
                            type:
                              - string
                              - 'null'
                            format: date-time
                          expiryRecorded:
                            type: boolean
                          scope:
                            type: object
                            properties:
                              merchants:
                                type: array
                                items:
                                  type: string
                              events:
                                type: array
                                items:
                                  type: string
                              tierKinds:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - general
                                    - seated
                              quantity:
                                type: object
                                properties:
                                  min:
                                    type: integer
                                    minimum: 0
                                    maximum: 9007199254740991
                                  max:
                                    type: integer
                                    minimum: 0
                                    maximum: 9007199254740991
                                  step:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                              addonPolicy:
                                type: string
                                enum:
                                  - none
                                  - allow_all
                                  - selected
                              allowedAddonCategories:
                                type: array
                                items:
                                  type: string
                              allowedAddonTierIds:
                                type: array
                                items:
                                  type: string
                              addonCapMinor:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                          consent:
                            type: object
                            properties:
                              source:
                                type: string
                                enum:
                                  - buyer
                                  - merchant
                                  - unavailable
                              surface:
                                type:
                                  - string
                                  - 'null'
                            required:
                              - source
                              - surface
                        required:
                          - mandateId
                          - grantedAt
                          - eventSequence
                          - capMinor
                          - currency
                          - expiresAt
                          - expiryRecorded
                          - scope
                          - consent
                      - type: 'null'
                  purchase:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: string
                          quantity:
                            type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                          chargeMinor:
                            type:
                              - integer
                              - 'null'
                            minimum: 0
                            maximum: 9007199254740991
                          currency:
                            type: string
                          createdAt:
                            type: string
                            format: date-time
                          expiresAt:
                            type: string
                            format: date-time
                          lines:
                            minItems: 1
                            type: array
                            items:
                              type: object
                              properties:
                                tierId:
                                  type: string
                                quantity:
                                  type: integer
                                  exclusiveMinimum: 0
                                  maximum: 9007199254740991
                                unitPriceMinor:
                                  type:
                                    - integer
                                    - 'null'
                                  minimum: 0
                                  maximum: 9007199254740991
                                subtotalMinor:
                                  type:
                                    - integer
                                    - 'null'
                                  minimum: 0
                                  maximum: 9007199254740991
                              required:
                                - tierId
                                - quantity
                                - unitPriceMinor
                                - subtotalMinor
                        required:
                          - id
                          - quantity
                          - chargeMinor
                          - currency
                          - createdAt
                          - expiresAt
                          - lines
                      - type: 'null'
                  comparisons:
                    type: object
                    properties:
                      basis:
                        type: string
                        enum:
                          - reconstructed_from_records
                      timeBasis:
                        type: string
                        enum:
                          - payment_created_at
                      amountWithinRecordedCap:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      currency:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      merchant:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      expiry:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      quantity:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      quoteAmount:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      eventScope:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      tierKindScope:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      addonScope:
                        type: string
                        enum:
                          - match
                          - mismatch
                          - unknown
                      cumulativeAllowance:
                        type: string
                        enum:
                          - unknown
                      revocation:
                        type: string
                        enum:
                          - no_recorded_revocation
                          - mismatch
                          - unknown
                    required:
                      - basis
                      - timeBasis
                      - amountWithinRecordedCap
                      - currency
                      - merchant
                      - expiry
                      - quantity
                      - quoteAmount
                      - eventScope
                      - tierKindScope
                      - addonScope
                      - cumulativeAllowance
                      - revocation
                  authentication:
                    type: object
                    properties:
                      setup:
                        type: string
                        enum:
                          - 3ds_authenticated
                          - not_supported
                          - legacy_assumed
                          - none
                          - unavailable
                      setupFlow:
                        type:
                          - 'null'
                          - string
                        enum:
                          - challenge
                          - frictionless
                      transaction:
                        type: string
                        enum:
                          - recorded
                          - unavailable
                      transactionDetails:
                        anyOf:
                          - anyOf:
                              - type: object
                                properties:
                                  provider:
                                    type: string
                                    enum:
                                      - stripe
                                  paymentIntentId:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  chargeId:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  result:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  flow:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  version:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  eci:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  transactionId:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  observedAt:
                                    type: string
                                    format: date-time
                                required:
                                  - provider
                                  - paymentIntentId
                                  - result
                                  - observedAt
                              - type: object
                                properties:
                                  provider:
                                    type: string
                                    enum:
                                      - adyen
                                  pspReference:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  result:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  flow:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  version:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  eci:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  transactionId:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                    pattern: ^[A-Za-z0-9_.-]+$
                                  observedAt:
                                    type: string
                                    format: date-time
                                required:
                                  - provider
                                  - pspReference
                                  - result
                                  - observedAt
                          - type: 'null'
                    required:
                      - setup
                      - setupFlow
                      - transaction
                      - transactionDetails
                  pspRequirements:
                    type: object
                    properties:
                      psp:
                        type:
                          - 'null'
                          - string
                        enum:
                          - stripe
                          - adyen
                      profile:
                        type:
                          - 'null'
                          - string
                      version:
                        type: string
                        enum:
                          - '2026-11-08'
                      sources:
                        type: array
                        items:
                          type: string
                          format: uri
                      caseRequirements:
                        type: string
                        enum:
                          - not_retrieved
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            availability:
                              type: string
                              enum:
                                - available
                                - partial
                                - unavailable
                                - conflicting
                            requirement:
                              type: string
                              enum:
                                - supporting
                                - conditional
                            evidenceOwner:
                              type: string
                              enum:
                                - alyte
                                - merchant
                                - psp
                            targetFields:
                              type: array
                              items:
                                type: string
                            dataPaths:
                              type: array
                              items:
                                type: string
                            note:
                              type: string
                          required:
                            - id
                            - availability
                            - requirement
                            - evidenceOwner
                            - targetFields
                            - dataPaths
                            - note
                    required:
                      - psp
                      - profile
                      - version
                      - sources
                      - caseRequirements
                      - items
                  gaps:
                    type: array
                    items:
                      type: string
                required:
                  - schemaVersion
                  - observedAt
                  - tenantId
                  - intentId
                  - merchantId
                  - agentId
                  - purpose
                  - payment
                  - authority
                  - permission
                  - purchase
                  - comparisons
                  - authentication
                  - pspRequirements
                  - gaps
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.