---
swagger: "2.0"
info:
  x-ibm-name: sva
  title: SVA
  version: 1.0.0
  contact:
    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/sva/aspsps:
    get:
      summary: Servicio de 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: OK
      tags:
      - Servicio de valor añadido
  /api-entrada-xs2a/services/v2/sva/aspsps:
    get:
      summary: Servicio de 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: OK
      tags:
      - Servicio de valor añadido
  /api-entrada-xs2a/services/{aspsp}/v1/sva/payments/{payment-product}:
    post:
      summary: Realización inicio de pago sin informar de la cuenta ordenante
      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-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: 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/RequestInicioPagoConListadoCuentasDisponible'
        description: Body de la petición
      responses:
        default:
          description: OK
      tags:
      - Servicio de valor añadido
definitions:
  RequestInicioPagoConListadoCuentasDisponible:
    type: object
    properties:
      instructedAmount:
        $ref: '#/definitions/_Amount'
        description: Información de la transferencia realizada.
      creditorName:
        type: string
        description: Nombre del beneficiario
        example: Nombre
      creditorAccount:
        $ref: '#/definitions/_AccountReference'
        description: Cuenta del beneficiario
      creditorAgent:
        type: string
        description: BIC de la cuenta del beneficiario.
        example: XSXHXSMMXXX
      creditorAddress:
        $ref: '#/definitions/Address'
        description: Dirección del beneficiario
      remittanceInformationUnstructured:
        type: string
        description: Informacion adicional
        example: Informacion Adicional
  _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
  Address:
    type: object
    properties:
      street:
        type: string
        description: Calle
        example: Ejemplo de Calle
      buildingNumber:
        type: string
        description: Numero
        example: "5"
      city:
        type: string
        description: Ciudad
        example: Cordoba
      postalCode:
        type: string
        description: Codigo Postal
        example: "14100"
      country:
        type: string
        description: Pais
        example: ES
  _Amount:
    type: object
    properties:
      currency:
        type: string
        description: Moneda del importe
        example: EUR
      amount:
        type: string
        description: Cantidad del importe
        example: "500.00"
tags: []
x-ibm-endpoints:
- endpointUrl: https://apis-i.redsys.es:20443/psd2/xs2a
  description: Endpoint entorno Integracion
  type:
  - production
  - development
...