Endpoint entorno Integracion
Paths
/api-entrada-xs2a/services/v1/sva/aspsps
Servicio de ASPSPs disponibles
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.
Identificador consumidor APIS
Identificador único de la transacción asignado por el TPP. Ej: X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7
Es contenido si viaja el campo Signature. Ej: Digest: SHA-256=NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ==
Firma de la petición por el TPP.
Certificado del TPP usado para firmar la petición, en base64. Ej: TPP-Signature-Certificate: MIIHgzCCBmugAwIBAgIIZzZvBQlt0UcwDQYJ………….KoZIhvcNAQELBQAwSTELMAkGA1UEBhMCVVMxEzARBgNVBA
OK
/api-entrada-xs2a/services/v2/sva/aspsps
Servicio de ASPSPs disponibles
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.
Identificador consumidor APIS
Identificador único de la transacción asignado por el TPP. Ej: X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7
Es contenido si viaja el campo Signature. Ej: Digest: SHA-256=NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ==
Firma de la petición por el TPP.
Certificado del TPP usado para firmar la petición, en base64. Ej: TPP-Signature-Certificate: MIIHgzCCBmugAwIBAgIIZzZvBQlt0UcwDQYJ………….KoZIhvcNAQELBQAwSTELMAkGA1UEBhMCVVMxEzARBgNVBA
OK
/api-entrada-xs2a/services/{aspsp}/v1/sva/payments/{payment-product}
Realización inicio de pago sin informar de la cuenta ordenante
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.
Identificador consumidor APIS
URL del hub donde se publica el servicio
Producto de pago a usar.
{
"enum": [
"sepa-credit-transfers",
"instant-sepa-credit-transfers",
"target-2-payments",
"cross-border-credit-transfers"
]
}application/json
Identificador único de la transacción asignado por el TPP. Ej: X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7
Bearer Token. Obtenido en una autenticación previa sobre Auth2. Ej: Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA
{
"default": "Bearer 6yBnsqnMQQ"
}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
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
Puerto IP de la petición HTTP entre el PSU y el TPP si está disponible. Ejemplo: PSU-IP-Port: 443
Accept header de la petición HTTP entre PSU y el TPP. Ej: PSU-Accept: application/json
Accept charset header de la petición HTTP entre PSU y el TPP. PSU-Accept-Charset: utf-8
Accept encoding header de la petición HTTP entre PSU y el TPP. PSU-Accept-Language: gzip
Accept language header de la petición HTTP entre PSU y el TPP. PSU-Accept-Language: es-ES
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)
Método HTTP usado en la interfaz entre PSU y TPP. Valores permitidos: POST. Ej: PSU-Http-Method: POST
{
"default": "POST"
}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
Localización correspondiente a la petición HTTP entre el PSU y el TPP. Ej: PSU-Geo-Location: GEO:90.023856;25.345963
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"
}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"
}Es contenido si viaja el campo Signature. Ej: Digest: SHA-256=NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ==
Firma de la petición por el TPP.
Certificado del TPP usado para firmar la petición, en base64. Ej: TPP-Signature-Certificate: MIIHgzCCBmugAwIBAgIIZzZvBQlt0UcwDQYJ………….KoZIhvcNAQELBQAwSTELMAkGA1UEBhMCVVMxEzARBgNVBA
Body de la petición
OK
Definitions
{
"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"
}
}
}
{
"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"
}
}
}
{
"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"
}
}
}
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "Moneda del importe",
"example": "EUR"
},
"amount": {
"type": "string",
"description": "Cantidad del importe",
"example": "500.00"
}
}
}