API de Redsys para PSD2
Soporte PSD2
production
development
https://apis-i.redsys.es:20443/psd2/xs2a
Endpoint entorno Integracion
Paths
/api-entrada-xs2a/services/{aspsp}/v1.1/funds-confirmations
post /api-entrada-xs2a/services/{aspsp}/v1.1/funds-confirmations
Consulta de fondos
Funds Confirmation - Funds Confirmation
This type of message is used in the fund consultation service. The HUB consults the ASPSP for the availability of funds for a given amount. The HUB communicates with the ASPSP to ask if it has funds and, after consultation, returns the response to the TPP.
RedsysClientId
X-IBM-Client-Id
(apiKey located in header)
Identificador consumidor APIS
aspsp
Required in path
string
Name of the ASPSP to which you wish to make the request.
X-Request-ID
Required in header
string
Unique identifier for the request given by the TPP. Match the HTTP request between TPP and HUB. Example: X-Request-ID: 1b3ab8e8-0fd5-43d2-946e-d75958b172e7
Digest
Required in header
string
It is content if the Signature field travels. Digest: SHA-256 = NzdmZjA4YjY5M2M2NDYyMmVjOWFmMGNmYTZiNTU3MjVmNDI4NTRlMzJkYzE3ZmNmMDE3ZGFmMjhhNTc5OTU3OQ ==
Signature
Required in header
string
Signature of the petition by the TPP.
TPP-Signature-Certificate
Required in header
string
Certificate signed
Authorization
Required in header
string
Bearer Token. Obtained in a previous authentication on OAuth2. Only if consent management has been done through the API.
Consent-ID
Required in header
string
Identifier of the consent obtained in the transaction to request consent. Only if consent management has been done through the API.
body
Required in body
object
Content-Type
Optional in header
string
application/json
Accept
Optional in header
string
application/json
default
HTTP/1.1 200 Ok
Example Request
Example Response
POST https://apis-i.redsys.es:20443/psd2/xs2a/api-entrada-xs2a/services/{aspsp}/v1.1/funds-confirmations
Try this operation
Definitions
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"example": "EUR"
},
"amount": {
"type": "string",
"example": "150.03"
}
}
}
{
"type": "object",
"properties": {
"iban": {
"type": "string",
"example": "ES1111111111111111111111",
"description": "IBAN de la cuenta",
"x-ibm-languages": {
"description": {
"en": "Account IBAN"
}
}
},
"bban": {
"type": "string",
"description": "BBAN de la cuenta, cuando esta no tiene IBAN.",
"x-ibm-languages": {
"description": {
"en": "Account BBAN, when it does not have IBAN."
}
},
"example": "20385778983000760236"
},
"pan": {
"type": "string",
"description": "Número de la tarjeta de la cuenta. Puede ser tokenizado por el ASPSP para cumplir los requerimientos de PCI DSS. Campo no soportado por el HUB.",
"x-ibm-languages": {
"description": {
"en": "Account card number. It can be tokenized by the ASPSP to meet the PCI DSS requirements. Field not supported by the HUB."
}
},
"example": "1234567891234567"
},
"msisdn": {
"type": "string",
"description": "Alias para acceder a una cuenta de pago a través de un número de teléfono móvil registrado.",
"x-ibm-languages": {
"description": {
"en": "Alias to access a payment account through a registered mobile phone number."
}
},
"example": "195198741874"
},
"currency": {
"type": "string",
"description": "Tipo de moneda.",
"x-ibm-languages": {
"description": {
"en": "Type of currency."
}
},
"example": "EUR"
}
}
}
{
"properties": {
"cardNumber": {
"type": "string",
"description": "Numeración de la tarjeta emitida por el PIISP. Debe ser enviada si está disponible. Este campo no está soportado para esta versión",
"x-ibm-languages": {
"description": {
"en": "Card number issued by the PIISP. It must be sent if available. This field is not supported for this version."
}
},
"example": "1111-1111-1111-1111"
},
"account": {
"$ref": "#\/definitions\/AccountReference",
"description": "Número de cuenta del PSU.",
"x-ibm-languages": {
"description": {
"en": "PSU account number."
}
}
},
"payee": {
"type": "string",
"description": "Comercio donde la tarjeta es aceptada como información para el PSU.",
"x-ibm-languages": {
"description": {
"en": "Commerce where the card is accepted as information for the PSU."
}
},
"example": "Comercio"
},
"instructedAmount": {
"description": "Contiene la cantidad y moneda a consultar.",
"x-ibm-languages": {
"description": {
"en": "Contains the quantity and currency to consult."
}
},
"$ref": "#\/definitions\/Amount"
}
},
"required": [
"account",
"instructedAmount"
]
}
{
"type": "object",
"properties": {
"tppMessage": {
"$ref": "#\/definitions\/TppMessage",
"description": "Mensaje para el TPP",
"x-ibm-languages": {
"description": {
"en": "Message for the TPP"
}
}
},
"fundsAvailable": {
"type": "boolean",
"example": "true",
"description": "Toma el valor \"true\" si hay suficientes fondos disponibles en el momento de la petición. \"false\" en otro caso.",
"x-ibm-languages": {
"description": {
"en": "It takes the value \"true\" if there are enough funds available at the time of the request. \"false\" in another case."
}
}
}
},
"required": [
"fundsAvailable"
]
}
{
"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"
}
},
"additionalProperties": false
}