---
swagger: "2.0"
info:
  x-ibm-name: sva-110
  title: 'SVA: Servicios de Valor Añadido'
  version: 1.1.0
  contact:
    name: Soporte PSD2
    email: psd2.sandbox.soporte@redsys.es
  description: ""
schemes:
- https
basePath: /
consumes:
- application/json
produces:
- application/json
securityDefinitions:
  RedsysClientSecret:
    type: apiKey
    description: Clave acceso consumidor APIS
    in: header
    name: X-IBM-Client-Secret
  RedsysClientId:
    type: apiKey
    description: Identificador consumidor APIS
    in: header
    name: X-IBM-Client-Id
security:
- RedsysClientId: []
x-ibm-configuration:
  enforced: true
  testable: true
  phase: realized
paths:
  /api-entrada-xs2a/services/v1.1/sva/aspsps:
    get:
      summary: Versión 1 ASPSPs disponibles
      description: Este mensaje es enviado por el TPP hacia el HUB para recibir la
        información acerca de que ASPSP están disponibles en el sistema.
      operationId: getAspsps
      parameters:
      - name: X-Request-ID
        in: header
        required: true
        type: string
        description: 'Identificador único de la transacción asignado por el TPP. Ej:
          X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7'
      - name: Digest
        in: header
        required: true
        type: string
        description: 'Es contenido si viaja el campo Signature. Ej: Digest: SHA-256=NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ=='
      - name: Signature
        in: header
        required: true
        type: string
        description: 'Firma de la petición por el TPP. '
      - name: TPP-Signature-Certificate
        in: header
        required: true
        type: string
        description: 'Certificado del TPP usado para firmar la petición, en base64.
          Ej: TPP-Signature-Certificate: MIIHgzCCBmugAwIBAgIIZzZvBQlt0UcwDQYJ………….KoZIhvcNAQELBQAwSTELMAkGA1UEBhMCVVMxEzARBgNVBA '
      responses:
        default:
          description: HTTP/1.1 200 Ok
          schema:
            $ref: '#/definitions/Response_AvailableASPSPs'
      tags:
      - Servicio de ASPSPs disponibles
  /api-entrada-xs2a/services/v2.1/sva/aspsps:
    get:
      summary: Versión 2 ASPSPs disponibles
      description: Este mensaje es enviado por el TPP hacia el HUB para recibir la
        información acerca de que ASPSP están disponibles en el sistema.
      operationId: getAspspsV2
      parameters:
      - name: X-Request-ID
        in: header
        required: true
        type: string
        description: 'Identificador único de la transacción asignado por el TPP. Ej:
          X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7'
      - name: Digest
        in: header
        required: true
        type: string
        description: 'Es contenido si viaja el campo Signature. Ej: Digest: SHA-256=NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ=='
      - name: Signature
        in: header
        required: true
        type: string
        description: 'Firma de la petición por el TPP. '
      - name: TPP-Signature-Certificate
        in: header
        required: true
        type: string
        description: 'Certificado del TPP usado para firmar la petición, en base64.
          Ej: TPP-Signature-Certificate: MIIHgzCCBmugAwIBAgIIZzZvBQlt0UcwDQYJ………….KoZIhvcNAQELBQAwSTELMAkGA1UEBhMCVVMxEzARBgNVBA '
      responses:
        default:
          description: HTTP/1.1 200 Ok
          schema:
            $ref: '#/definitions/Response_AvailableASPSPs'
      tags:
      - Servicio de ASPSPs disponibles
  /api-entrada-xs2a/services/{aspsp}/v1.1/sva/payments/{payment-product}:
    post:
      summary: Realización inicio de pago
      description: Este servicio permite al TPP la realización de un inicio de un
        pago sin informar la cuenta del ordenante “debtorAccount” y proporciona el
        listado de cuentas durante el flujo SCA para que el PSU seleccione una.
      operationId: startPayment_NoDebtorAcc
      parameters:
      - name: aspsp
        in: path
        required: true
        type: string
        description: URL del hub donde se publica el servicio
      - name: payment-product
        in: path
        required: true
        type: string
        description: Producto de pago a usar.
        enum:
        - sepa-credit-transfers
        - instant-sepa-credit-transfers
        - target-2-payments
        - cross-border-credit-transfers
      - name: Content-Type
        in: header
        required: true
        type: string
        description: application/json
      - name: X-Request-ID
        in: header
        required: true
        type: string
        description: 'Identificador único de la transacción asignado por el TPP. Ej:
          X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7'
      - name: Authorization
        in: header
        required: true
        type: string
        description: 'Bearer Token. Obtenido en una autenticación previa sobre Auth2.
          Ej:  Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA'
        default: Bearer 6yBnsqnMQQ
      - name: Consent-ID
        in: header
        required: false
        type: string
        description: 'Este dato es contenido si la transacción de inicio de pago forma
          parte de una sesión (combinación de AIS/PIS). Contendrá el consentId del
          consentimiento AIS que se realizó previo al inicio de pago. . Ej: Consent-ID:
          123-qwer-456'
      - name: PSU-ID
        in: header
        required: false
        type: string
        description: Identificador que el PSU utiliza para identificarse en su ASPSP.
          Puede ser informado incluso si se está usando un token de OAuth y, en tal
          caso, el ASPSP podría comprobar que el PSU-ID y el token se corresponden.
        x-ibm-languages:
          description:
            en: Identifier that the PSU uses to identify itself to its ASPSP. It can
              be reported even if an OAuth token is being used and, in such a case,
              the ASPSP could check that the PSU-ID and token match.
      - name: PSU-ID-Type
        in: header
        required: false
        type: string
        description: Tipo del PSU-ID. Necesario en escenarios donde el PSU tiene varios
          PSU-IDs como posibilidades de acceso.
        x-ibm-languages:
          description:
            en: PSU-ID type. Necessary in scenarios where the PSU has several PSU-IDs
              as access possibilities.
      - name: PSU-Corporate-ID
        in: header
        required: false
        type: string
        description: Identificador de "empresa" en los Canales Online.
        x-ibm-languages:
          description:
            en: '"Company" identifier in the Online Channels.'
      - name: PSU-Corporate-ID-Type
        in: header
        required: false
        type: string
        description: Tipo del PSU-Corporate-ID necesario por el ASPSP para identificar
          su contenido.
        x-ibm-languages:
          description:
            en: Type of PSU-Corporate-ID required by the ASPSP to identify its contents.
      - name: PSU-IP-Address
        in: header
        required: true
        type: string
        description: 'Dirección IP de la petición HTPP entre el PSU y el TPP. Si no
          está disponible, el TPP debe usar la dirección IP usada por el TPP cuando
          envía esta petición. Ej: Ej: PSU-IP-Address: 192.168.16.5'
      - name: PSU-IP-Port
        in: header
        required: false
        type: string
        description: 'Puerto IP de la petición HTTP entre el PSU y el TPP si está
          disponible. Ejemplo: PSU-IP-Port: 443'
      - name: PSU-Accept
        in: header
        required: false
        type: string
        description: 'Accept header de la petición HTTP entre PSU y el TPP. Ej: PSU-Accept:
          application/json'
      - name: PSU-Accept-Charset
        in: header
        required: false
        type: string
        description: 'Accept charset header de la petición HTTP entre PSU y el TPP.
          PSU-Accept-Charset: utf-8'
      - name: PSU-Accept-Encoding
        in: header
        required: false
        type: string
        description: 'Accept encoding header de la petición HTTP entre PSU y el TPP.
          PSU-Accept-Language: gzip '
      - name: PSU-Accept-Language
        in: header
        required: false
        type: string
        description: 'Accept language header de la petición HTTP entre PSU y el TPP.
          PSU-Accept-Language: es-ES '
      - name: PSU-User-Agent
        in: header
        required: false
        type: string
        description: 'Navegador o sistema operativo de la petición HTTP entre el PSU
          y el TPP. Ejemplo: PSU-User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1;
          en-US; rv:1.9.1.5) Gecko/20091102 Firefox/3.5.5 (.NET CLR 3.5.30729) '
      - name: PSU-Http-Method
        in: header
        required: false
        type: string
        description: 'Método HTTP usado en la interfaz entre PSU y TPP. Valores permitidos:
          POST. Ej: PSU-Http-Method: POST '
        default: POST
      - name: PSU-Device-ID
        in: header
        required: false
        type: string
        description: 'UUID (Universally Unique Identifier) para un dispositivo. El
          UUID identifica al dispositivo o a una instalación de una aplicación en
          un dispositivo. Este ID no debe ser modificado hasta la desinstalación de
          la aplicación del dispositivo. Ej: PSU-Device-ID: 5b3ab8e8-0fd5-43d2-946e-d75958b172e7'
      - name: PSU-Geo-Location
        in: header
        required: false
        type: string
        description: 'Localización correspondiente a la petición HTTP entre el PSU
          y el TPP. Ej: PSU-Geo-Location: GEO:90.023856;25.345963'
      - name: TPP-Redirect-URI
        in: header
        required: false
        type: string
        description: 'URI del TPP donde el flujo de la transacción debe ser redirigido
          después de alguna de las fases del SCA. Es recomendado usar siempre este
          campo de cabecera.En el futuro, este campo podría cambiar a obligatorio.
          Ej: TPP-Redirect-URI: https://www.tpp.com/cb'
        default: http://www.example.com
      - name: TPP-Nok-Redirect-URI
        in: header
        required: false
        type: string
        description: Si esta URI es contenida, el TPP está solicitando redirigir el
          flujo de la transacción a esta dirección en vez de al TPP-Redirect-URI en
          caso de un resultado negativo del método de SCA por redirección. "TPP-Nok-Redirect-URI":"https://www.tpp.com/cb/nok"
        default: http://www.exampleNok.com
      - name: TPP-Brand-Logging-Information
        in: header
        required: false
        type: string
        description: Este campo podría ser usado por el TPP para informar al ASPSP
          acerca de la marca (Brand) usada por el TPP de cara al PSU. Esta información
          puede ser usada para mejorar la comunicación entre el ASPSP y el PSU o el
          ASPSP y el TPP.
        x-ibm-languages:
          description:
            en: This field could be used by the TPP to inform the ASPSP about the
              Brand used by the TPP towards the PSU. This information can be used
              to improve communication between the ASPSP and the PSU or the ASPSP
              and the TPP.
      - name: Digest
        in: header
        required: true
        type: string
        description: 'Es contenido si viaja el campo Signature. Ej: Digest: SHA-256=NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ=='
      - name: Signature
        in: header
        required: true
        type: string
        description: 'Firma de la petición por el TPP. '
      - name: TPP-Signature-Certificate
        in: header
        required: true
        type: string
        description: 'Certificado del TPP usado para firmar la petición, en base64.
          Ej: TPP-Signature-Certificate: MIIHgzCCBmugAwIBAgIIZzZvBQlt0UcwDQYJ………….KoZIhvcNAQELBQAwSTELMAkGA1UEBhMCVVMxEzARBgNVBA '
      - name: Body
        required: true
        in: body
        schema:
          $ref: '#/definitions/SinglePayment'
        description: Body de la petición
      responses:
        default:
          headers:
            Location:
              type: string
              description: Contiene el link al recurso generado.
            X-Request-ID:
              type: string
              description: Identificador único de la operación asignado por el TPP.
            ASPSP-SCA-Approach:
              type: string
              description: Valor devuelto si el método SCA ha sido fijado. El SCA
                basado en OAuth será tomado como REDIRECT.
              enum:
              - EMBEDDED
              - DECOUPLED
              - REDIRECT
          description: HTTP/1.1 201 Created
          schema:
            $ref: '#/definitions/Response_PaymentInitiation'
      tags:
      - Inicio de pago con listado de cuentas disponibles para PISP
  /api-entrada-xs2a/services/{aspsp}/v1.1/sva/periodic-payments/{payment-product}:
    post:
      summary: Realización de inicio de pago periódico
      description: Este servicio permite al TPP la realización de un inicio de un
        pago periódico sin informar la cuenta del ordenante “debtorAccount” y proporciona
        el listado de cuentas durante el flujo SCA para que el PSU seleccione una.
      operationId: startPeriodicPayment_NoDebtorAcc
      parameters:
      - name: aspsp
        in: path
        required: true
        type: string
        description: URL del hub donde se publica el servicio
      - name: payment-product
        in: path
        required: true
        type: string
        description: Producto de pago a usar.
        enum:
        - sepa-credit-transfers
        - instant-sepa-credit-transfers
        - target-2-payments
        - cross-border-credit-transfers
      - name: Content-Type
        in: header
        required: true
        type: string
        description: application/json
      - name: X-Request-ID
        in: header
        required: true
        type: string
        description: 'Identificador único de la transacción asignado por el TPP. Ej:
          X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7'
      - name: Authorization
        in: header
        required: true
        type: string
        description: 'Bearer Token. Obtenido en una autenticación previa sobre Auth2.
          Ej:  Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA'
        default: Bearer 6yBnsqnMQQ
      - name: Consent-ID
        in: header
        required: false
        type: string
        description: 'Este dato es contenido si la transacción de inicio de pago forma
          parte de una sesión (combinación de AIS/PIS). Contendrá el consentId del
          consentimiento AIS que se realizó previo al inicio de pago. . Ej: Consent-ID:
          123-qwer-456'
      - name: PSU-ID
        in: header
        required: false
        type: string
        description: Identificador que el PSU utiliza para identificarse en su ASPSP.
          Puede ser informado incluso si se está usando un token de OAuth y, en tal
          caso, el ASPSP podría comprobar que el PSU-ID y el token se corresponden.
        x-ibm-languages:
          description:
            en: Identifier that the PSU uses to identify itself to its ASPSP. It can
              be reported even if an OAuth token is being used and, in such a case,
              the ASPSP could check that the PSU-ID and token match.
      - name: PSU-ID-Type
        in: header
        required: false
        type: string
        description: Tipo del PSU-ID. Necesario en escenarios donde el PSU tiene varios
          PSU-IDs como posibilidades de acceso.
        x-ibm-languages:
          description:
            en: PSU-ID type. Necessary in scenarios where the PSU has several PSU-IDs
              as access possibilities.
      - name: PSU-Corporate-ID
        in: header
        required: false
        type: string
        description: Identificador de "empresa" en los Canales Online.
        x-ibm-languages:
          description:
            en: '"Company" identifier in the Online Channels.'
      - name: PSU-Corporate-ID-Type
        in: header
        required: false
        type: string
        description: Tipo del PSU-Corporate-ID necesario por el ASPSP para identificar
          su contenido.
        x-ibm-languages:
          description:
            en: Type of PSU-Corporate-ID required by the ASPSP to identify its contents.
      - name: PSU-IP-Address
        in: header
        required: true
        type: string
        description: 'Dirección IP de la petición HTPP entre el PSU y el TPP. Si no
          está disponible, el TPP debe usar la dirección IP usada por el TPP cuando
          envía esta petición. Ej: Ej: PSU-IP-Address: 192.168.16.5'
      - name: PSU-IP-Port
        in: header
        required: false
        type: string
        description: 'Puerto IP de la petición HTTP entre el PSU y el TPP si está
          disponible. Ejemplo: PSU-IP-Port: 443'
      - name: PSU-Accept
        in: header
        required: false
        type: string
        description: 'Accept header de la petición HTTP entre PSU y el TPP. Ej: PSU-Accept:
          application/json'
      - name: PSU-Accept-Charset
        in: header
        required: false
        type: string
        description: 'Accept charset header de la petición HTTP entre PSU y el TPP.
          PSU-Accept-Charset: utf-8'
      - name: PSU-Accept-Encoding
        in: header
        required: false
        type: string
        description: 'Accept encoding header de la petición HTTP entre PSU y el TPP.
          PSU-Accept-Language: gzip '
      - name: PSU-Accept-Language
        in: header
        required: false
        type: string
        description: 'Accept language header de la petición HTTP entre PSU y el TPP.
          PSU-Accept-Language: es-ES '
      - name: PSU-User-Agent
        in: header
        required: false
        type: string
        description: 'Navegador o sistema operativo de la petición HTTP entre el PSU
          y el TPP. Ejemplo: PSU-User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1;
          en-US; rv:1.9.1.5) Gecko/20091102 Firefox/3.5.5 (.NET CLR 3.5.30729) '
      - name: PSU-Http-Method
        in: header
        required: false
        type: string
        description: 'Método HTTP usado en la interfaz entre PSU y TPP. Valores permitidos:
          POST. Ej: PSU-Http-Method: POST '
        default: POST
      - name: PSU-Device-ID
        in: header
        required: false
        type: string
        description: 'UUID (Universally Unique Identifier) para un dispositivo. El
          UUID identifica al dispositivo o a una instalación de una aplicación en
          un dispositivo. Este ID no debe ser modificado hasta la desinstalación de
          la aplicación del dispositivo. Ej: PSU-Device-ID: 5b3ab8e8-0fd5-43d2-946e-d75958b172e7'
      - name: PSU-Geo-Location
        in: header
        required: false
        type: string
        description: 'Localización correspondiente a la petición HTTP entre el PSU
          y el TPP. Ej: PSU-Geo-Location: GEO:90.023856;25.345963'
      - name: TPP-Redirect-URI
        in: header
        required: false
        type: string
        description: 'URI del TPP donde el flujo de la transacción debe ser redirigido
          después de alguna de las fases del SCA. Es recomendado usar siempre este
          campo de cabecera.En el futuro, este campo podría cambiar a obligatorio.
          Ej: TPP-Redirect-URI: https://www.tpp.com/cb'
        default: http://www.example.com
      - name: TPP-Nok-Redirect-URI
        in: header
        required: false
        type: string
        description: Si esta URI es contenida, el TPP está solicitando redirigir el
          flujo de la transacción a esta dirección en vez de al TPP-Redirect-URI en
          caso de un resultado negativo del método de SCA por redirección. "TPP-Nok-Redirect-URI":"https://www.tpp.com/cb/nok"
        default: http://www.exampleNok.com
      - name: TPP-Brand-Logging-Information
        in: header
        required: false
        type: string
        description: Este campo podría ser usado por el TPP para informar al ASPSP
          acerca de la marca (Brand) usada por el TPP de cara al PSU. Esta información
          puede ser usada para mejorar la comunicación entre el ASPSP y el PSU o el
          ASPSP y el TPP.
        x-ibm-languages:
          description:
            en: This field could be used by the TPP to inform the ASPSP about the
              Brand used by the TPP towards the PSU. This information can be used
              to improve communication between the ASPSP and the PSU or the ASPSP
              and the TPP.
      - name: Digest
        in: header
        required: true
        type: string
        description: 'Es contenido si viaja el campo Signature. Ej: Digest: SHA-256=NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ=='
      - name: Signature
        in: header
        required: true
        type: string
        description: 'Firma de la petición por el TPP. '
      - name: TPP-Signature-Certificate
        in: header
        required: true
        type: string
        description: 'Certificado del TPP usado para firmar la petición, en base64.
          Ej: TPP-Signature-Certificate: MIIHgzCCBmugAwIBAgIIZzZvBQlt0UcwDQYJ………….KoZIhvcNAQELBQAwSTELMAkGA1UEBhMCVVMxEzARBgNVBA '
      - name: Body
        required: true
        in: body
        schema:
          $ref: '#/definitions/Request_PeriodicPaymentInitiation'
        description: Body de la petición
      responses:
        default:
          description: HTTP/1.1 201 Created
          headers:
            Location:
              type: string
              description: Contiene el link al recurso generado.
            X-Request-ID:
              type: string
              description: Identificador único de la operación asignado por el TPP.
            ASPSP-SCA-Approach:
              type: string
              description: Valor devuelto si el método SCA ha sido fijado. El SCA
                basado en OAuth será tomado como REDIRECT.
              enum:
              - EMBEDDED
              - DECOUPLED
              - REDIRECT
          schema:
            $ref: '#/definitions/Response_PaymentInitiation'
      tags:
      - Inicio de órdenes permanentes para pagos recurrentes/periódicos con listado
        de cuentas disponibles para PISP
definitions:
  AuthenticationObject:
    required:
    - authenticationMethodId
    - authenticationType
    - name
    properties:
      authenticationType:
        type: string
      authenticationVersion:
        type: string
      authenticationMethodId:
        type: string
      name:
        type: string
      explanation:
        type: string
  AccountReference:
    type: object
    properties:
      iban:
        properties: []
        type: string
        example: ES2640000418401234567599
        description: IBAN de la cuenta
      bban:
        properties: []
        type: string
        description: BBAN de la cuenta, cuando esta no tiene IBAN.
        example: "20385778983000760236"
      pan:
        properties: []
        type: string
        description: Primary Account Number de la tarjeta. Puede ser tokenizada por
          el ASPSP para cumplir los requerimientos de PCI DSS.
        example: "1234567891234567"
      maskedPan:
        properties: []
        type: string
        description: Primary Account Number de la tarjeta en forma enmascarda.
        example: 123456******4567
      msisdn:
        properties: []
        type: string
        description: Alias para acceder a una cuenta de pago a través de un número
          de teléfono móvil registrado.
        example: "27821234567"
      currency:
        properties: []
        type: string
        example: EUR
        description: Moneda
  Aspsp:
    type: object
    properties:
      bic:
        type: string
        description: Código BIC del ASPSP
        example: XXXXXXXXXXX
      name:
        type: string
        description: Nombre del ASPSP
        example: Nombre ASPSP
      apiName:
        type: string
        description: 'Nombre del ASPSP usado en el PATH de la petición. Nota: Solo
          disponible para versión 2 del listado de ASPSPs disponibles.'
        example: nombreBanco
    required:
    - bic
  Address:
    type: object
    properties:
      streetName:
        type: string
        description: Calle
        example: Ejemplo de Calle
      buildingNumber:
        type: string
        description: Numero
        example: "5"
      townName:
        type: string
        description: Ciudad
        example: Cordoba
      postCode:
        type: string
        description: Codigo Postal
        example: "14100"
      country:
        type: string
        description: Pais
        example: ES
    required:
    - country
    - townName
  Amount:
    type: object
    properties:
      currency:
        type: string
        description: Moneda del importe
        example: EUR
      amount:
        type: string
        description: Cantidad del importe
        example: "500.00"
    required:
    - currency
    - amount
  Href:
    required:
    - href
    type: object
    properties:
      href:
        type: string
        description: Contiene un enlace a un recurso
        example: /v1.1/payments/sepa-credit-transfers/asd-1234-jkl
  Links:
    type: object
    properties:
      scaRedirect:
        type: object
        description: URL utilizada para la realización de SCA, mediante redirección
          del navegador del PSU.
        additionalProperties:
          $ref: '#/definitions/Href'
      scaOAuth:
        type: object
        description: El enlace para recuperar un documento JSON que especifica los
          detalles del servidor de autorizaciones de ASPSP. El documento JSON sigue
          la definición dada en https://tools.ietf.org/html/draft-ietf-oauth-discovery.
          Solo para ASPSPs que requieran Ejecución de pago.
        additionalProperties:
          $ref: '#/definitions/Href'
      startAuthorisation:
        type: object
        description: Enlace al endpoint donde la autorizaición de la transacción o
          la autorización de la transacción de cancelación debe ser iniciada.
        additionalProperties:
          $ref: '#/definitions/Href'
      startAuthorisationWithAuthenticationMethodSelection:
        type: object
        description: Link al endpoint donde la autorización de una transacción o de
          una transacción de cancelación debe ser iniciada, donde el método SCA debe
          ser informado con la correspondiente llamada.
        additionalProperties:
          $ref: '#/definitions/Href'
      selectAuthenticationMethod:
        type: object
        description: Enlace donde el TPP puede seleccionar el método de autenticación
          de 2º factor aplicable para el PSU, en caso de haber más de uno.
        additionalProperties:
          $ref: '#/definitions/Href'
      self:
        type: object
        description: El enlace al recurso creado para la solicitud. Este enlace puede
          utilizarse posteriormente para recuperar el estado de la transacción.
        additionalProperties:
          $ref: '#/definitions/Href'
      status:
        type: object
        description: El enlace para recuperar el estado de la transacción. Por ejemplo,
          estado de inicio de pago.
        additionalProperties:
          $ref: '#/definitions/Href'
      scaStatus:
        type: object
        description: Enlace para recuperar el estado de la autorización o sub-recurso
          de autorización de cancelación.
        additionalProperties:
          $ref: '#/definitions/Href'
      account:
        type: object
        description: Link al recurso que proporciona los datos de una cuenta.
        additionalProperties:
          $ref: '#/definitions/Href'
      balances:
        type: object
        description: Link al recurso que proporciona los balances de la cuenta.
        additionalProperties:
          $ref: '#/definitions/Href'
      transactions:
        type: object
        description: Link al recurso que proporciona las transacciones de la cuenta.
        additionalProperties:
          $ref: '#/definitions/Href'
      cardAccount:
        type: object
        description: Link al recurso que proporciona los datos de una cuenta de tarjeta.
        additionalProperties:
          $ref: '#/definitions/Href'
      cardTransactions:
        type: object
        description: Link al recurso que proporciona las transacciones de la cuenta
          de tarjeta.
        additionalProperties:
          $ref: '#/definitions/Href'
      transactionDetails:
        type: object
        description: Enlace al recurso proporcionando detalles de una transacción
          específica. NO SOPORTADO EN ESTA VERSIÓN
        additionalProperties:
          $ref: '#/definitions/Href'
      first:
        type: object
        description: Enlace de navegación para informes de cuentas paginados.
        additionalProperties:
          $ref: '#/definitions/Href'
      next:
        type: object
        description: Enlace de navegación para informes de cuentas paginados.
        additionalProperties:
          $ref: '#/definitions/Href'
      previous:
        type: object
        description: Enlace de navegación para informes de cuentas paginados.
        additionalProperties:
          $ref: '#/definitions/Href'
      last:
        type: object
        description: Enlace de navegación para informes de cuentas paginados.
        additionalProperties:
          $ref: '#/definitions/Href'
      download:
        type: object
        description: Enlace de descarga para grandes paquetes de datos AIS. Solo para
          camt-data.
        additionalProperties:
          $ref: '#/definitions/Href'
    additionalProperties: true
  List_Aspsp:
    type: array
    items:
      $ref: '#/definitions/Aspsp'
  List_AuthenticationObject:
    type: array
    items:
      $ref: '#/definitions/AuthenticationObject'
  List_TppMessage:
    type: array
    items:
      $ref: '#/definitions/TppMessage'
  Request_PeriodicPaymentInitiation:
    allOf:
    - $ref: '#/definitions/SinglePayment'
    - properties:
        startDate:
          type: string
          description: El primer día aplicable de ejecución desde esta fecha es el
            primer pago
          x-ibm-languages:
            description:
              en: The first applicable day of execution from this date is the first
                payment
        executionRule:
          type: string
          description: Define el comportamiento cuando las fechas del pago recurrente
            caen en fin de semana o festivo. Entonces el pago se ejecuta el día laboral
            anterior o posterior
          x-ibm-languages:
            description:
              en: Define the behavior when recurring payment dates fall on weekends
                or holidays. Then the payment is executed the previous or subsequent
                business day
        endDate:
          type: string
          description: El último día aplicable de ejecución. Si no viene se trata
            de una orden permanente sin fin.
          x-ibm-languages:
            description:
              en: The last applicable day of execution. If it does not come, it is
                an endless permanent order.
        frequency:
          type: string
          description: La frecuencia del pago recurrente resultante de esta orden
            permanente
          x-ibm-languages:
            description:
              en: The frequency of recurring payment resulting from this permanent
                order
        dayOfExecution:
          type: string
          description: La fecha se refiere a la zona horaria del ASPSP
          x-ibm-languages:
            description:
              en: The date refers to the time zone of the ASPSP
      required:
      - frequency
      - startDate
  Response_AvailableASPSPs:
    type: object
    properties:
      aspsps:
        type: array
        items:
          $ref: '#/definitions/List_Aspsp'
      tppMessages:
        $ref: '#/definitions/TppMessage'
    required:
    - aspsps
    - tppMessages
  Response_PaymentInitiation:
    properties:
      transactionStatus:
        type: string
        description: Estado de la transaccion
        x-ibm-languages:
          description:
            en: Transaction Status
        example: RCVD
      paymentId:
        properties: []
        type: string
        description: Identificador del recurso que referencia a la iniciación de pago.
        x-ibm-languages:
          description:
            en: Identifier of the resource that refers to the initiation of payment.
        example: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7
      transactionFees:
        properties: []
        description: Comisiones asociadas al pago.
        x-ibm-languages:
          description:
            en: Fees associated with payment.
        example: ""
        $ref: '#/definitions/Amount'
      transactionFeeIndicator:
        properties: []
        type: boolean
        description: Si es igual a "true", la transacción implicará una comisión según
          el ASPSP o según lo acordado entre ASPSP y PSU. Si es igual a "false", la
          transacción no implicará ninguna comisión adicional para el PSU.
        x-ibm-languages:
          description:
            en: 'If it is equal to "true", the transaction will involve a commission
              according to the ASPSP or as agreed between ASPSP and PSU. If it is
              equal to "false", the transaction will not imply any additional commission
              for the PSU. '
        example: '"transactionFeeIndicator": true'
      scaMethods:
        $ref: '#/definitions/List_AuthenticationObject'
        description: Este elemento es contenido si SCA es requerido y si el PSU puede
          elegir entre diferentes métodos de autenticación.
        x-ibm-languages:
          description:
            en: This element is content if SCA is required and if the PSU can choose
              between different authentication methods.
      _links:
        properties: []
        description: 'Lista de hipervínculos para ser reconocidos por el TPP. Tipos
          soportados en esta respuesta:'
        x-ibm-languages:
          description:
            en: 'List of hyperlinks to be recognized by the TPP. Types supported in
              this answer: '
        $ref: '#/definitions/Links'
      psuMessage:
        properties: []
        type: string
        example: Informacion para el PSU
        description: Texto a mostrar al PSU.
        x-ibm-languages:
          description:
            en: Text to display to the PSU.
      tppMessages:
        properties: []
        $ref: '#/definitions/List_TppMessage'
        description: Mensaje para el TPP
        x-ibm-languages:
          description:
            en: Message for the TPP
    required:
    - transactionStatus
    - paymentId
    - _links
    additionalProperties: false
  PaymentExchangeRate:
    type: object
    properties:
      unitCurrency:
        type: string
        description: Moneda en la que el tipo de intercambio es expresado en moneda
          extranjera. En el siguiente ejemplo 1EUR = xxxCUR, la unidad monetaria es
          el EUR.
        example: USD
        x-ibm-languages:
          description:
            en: Currency in which the exchange rate is expressed in foreign currency.
              In the following example 1EUR = xxxCUR, the currency unit is EUR.
      exchangeRate:
        type: string
        description: Factor usado para convertir un importe en una moneda a otra.
          Refleja el precio en el cual una moneda fue comprada con otra moneda.
        example: "0.8"
        x-ibm-languages:
          description:
            en: Factor used to convert an amount in one currency to another. Reflects
              the price at which one currency was purchased with another currency.
      contractIdentification:
        type: string
        description: Identificación única para identificar el contrato de cambio de
          divisas
        example: 1234-qeru-23
        x-ibm-languages:
          description:
            en: Unique identification to identify the foreign exchange contract
      rateType:
        type: string
        description: 'Especifica el tipo usado para completar el cambio de moneda.
          Valores permitidos: SPOT, SALE, AGRD.'
        x-ibm-languages:
          description:
            en: 'Specifies the type used to complete the currency exchange. Allowed
              values: SPOT, SALE, AGRD.'
  Remittance:
    required:
    - reference
    type: object
    properties:
      reference:
        type: string
        description: Refencia actual
      referenceType:
        type: string
        description: Tipo de la refencia
      referenceIssuer:
        type: string
        description: Emisor de la refencia
  List_Remittance:
    type: array
    items:
      $ref: '#/definitions/Remittance'
  SinglePayment:
    type: object
    properties:
      endToEndIdentification:
        type: string
        description: Identificador único end to end.
        x-ibm-languages:
          description:
            en: Unique end to end identifier.
      instructionIdentification:
        type: string
        description: Identificación única de la instrucción asignada por la parte
          instructora
        x-ibm-languages:
          description:
            en: Unique identification of the instruction assigned by the instructing
              party
      debtorName:
        type: string
        description: Nombre del ordenante
        x-ibm-languages:
          description:
            en: Name of payer
      debtorAccount:
        type: object
        description: 'Cuenta del ordenante. Nota: este campo puede ser opcional en
          algunos servicios como pagos bulk'
        additionalProperties:
          $ref: '#/definitions/AccountReference'
        x-ibm-languages:
          description:
            en: 'Account of the payer. Note: this field may be optional in some services
              such as bulk payments.'
      debtorId:
        type: string
      ultimateDebtor:
        type: string
      instructedAmount:
        type: object
        description: Información de la transferencia realizada.
        additionalProperties:
          $ref: '#/definitions/Amount'
        x-ibm-languages:
          description:
            en: Transfer information made.
      currencyOfTranfer:
        type: string
      exchangeRateInformation:
        type: object
        additionalProperties:
          $ref: '#/definitions/PaymentExchangeRate'
      creditorAccount:
        type: object
        description: 'Cuenta del ordenante. Nota: este campo puede ser opcional en
          algunos servicios como pagos bulk'
        additionalProperties:
          $ref: '#/definitions/AccountReference'
        x-ibm-languages:
          description:
            en: 'Account of the payer. Note: this field may be optional in some services
              such as bulk payments.'
      creditorAgent:
        type: string
        description: BIC de la cuenta del beneficiario
        example: XXXLESMMXXX
        x-ibm-languages:
          description:
            en: BIC of the beneficiary's account
      creditorName:
        type: string
        description: Nombre del beneficiario
        example: Nombre
        x-ibm-languages:
          description:
            en: Beneficiary Name
      creditorId:
        type: string
      creditorAddress:
        type: object
        description: Direccion Beneficiario
        additionalProperties:
          $ref: '#/definitions/Address'
        x-ibm-languages:
          description:
            en: Beneficiary Address
      creditorNameAndAddress:
        type: string
      purposeCode:
        type: string
        description: Lista de códigos ISO
        x-ibm-languages:
          description:
            en: List of ISO codes
      chargeBearer:
        type: string
        description: 'Valores permitidos: Valores permitidos: • DEBT • CRED • SHAR
          • SLEV'
        example: SLEV
        x-ibm-languages:
          description:
            en: 'Allowed values: Allowed values: • DEBT • CRED • SHAR • SLEV'
      serviceLevel:
        type: string
        description: Nivel de servicio.
        x-ibm-languages:
          description:
            en: Level of service.
      remittanceInformationUnstructured:
        type: string
        description: Informacion Adicional
        example: Informacion adicional
        x-ibm-languages:
          description:
            en: Additional Information
      remittanceInformationUnstructuredArray:
        type: array
        items:
          type: string
      remittanceInformationStructured:
        type: object
        additionalProperties:
          $ref: '#/definitions/Remittance'
      remittanceInformationStructuredArray:
        type: object
        additionalProperties:
          $ref: '#/definitions/List_Remittance'
      requestedExecutionDate:
        type: string
        description: Fecha de ejecución
        x-ibm-languages:
          description:
            en: Date of execution
      requestedExecutionTime:
        type: string
        description: Fecha/hora de ejecución
        x-ibm-languages:
          description:
            en: Date/time of execution
    additionalProperties: true
  TppMessage:
    properties:
      category:
        type: string
        example: OK
      code:
        properties: []
        type: string
        example: ACCESS_OK
      text:
        properties: []
        type: string
        example: Acceso OK
      path:
        properties: []
        type: string
        example: /example/path
    required:
    - category
    - code
x-ibm-endpoints:
- endpointUrl: https://apis-i.redsys.es:20443/psd2/xs2a
  description: Endpoint entorno Integracion
  type:
  - production
  - development
...