Main page - BBVA
Documentation Download v1.1
Flowchart Download
Version | Domains | |
v1.1 | API sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-entrada-xs2a/services/BBVA/v1.1 |
API oAuth-sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-oauth-xs2a/services/rest/BBVA |
API Producción https://psd2.redsys.es/api-entrada-xs2a/services/BBVA/v1.1 |
API oAuth-Producción Authorize: https://hubpsd2.redsys.es/api-oauth-xs2a/services/rest/BBVA Token: https://hubpsd2.redsys.es/api-oauth-xs2a/services/rest/BBVA |
The entity has included the 180-day SCA extension in the Production environment.
Entity Configuration:
Payment Initiation Service (PIS)
Initiation of a simple and future payment | V1.1 | |||
Simple payment start POST /payments/{payment-product} |
payment product | sepa-credit-transfers | Normal credit transfers within the euro zone (SEPA). It is indicated in the PATH of the request. | X |
instant-sepa-credit-transfers |
Immediate credit transfers within the euro zone (iSEPA). It is indicated in the PATH of the request. *NOTE: For this payment product it is additionally mandatory to send the townName field. |
X | ||
target-2-payments [2] | Payments by the TARGET2 system. It is indicated in the PATH of the request. | X | ||
cross-border-credit-transfers [1] | Cross-border credit transfers. It is indicated in the PATH of the request. | X | ||
Payment start support multi-currency accounts | Applies to all payment products | Allows you to make a transfer from a sub-account identified by IBAN + currency | X | |
Future Payment Start POST /payments/{payment-product} |
payment product (Field requestedExecutionDate) |
sepa-credit-transfers | Normal credit transfers within the euro zone (SEPA). It is indicated in the PATH of the request. | X |
instant-sepa-credit-transfers | Immediate credit transfers within the euro zone (iSEPA). It is indicated in the PATH of the request. | |||
target-2-payments [2] | Payments by the TARGET2 system. It is indicated in the PATH of the request. | X | ||
cross-border-credit-transfers [1] | Cross-border credit transfers. It is indicated in the PATH of the request. | X | ||
Future payment start support multi-currency accounts | Applies to all paid products | Allows you to make a transfer from a sub-account identified by IBAN + currency | X | |
Payment status GET /payments/{payment-product}/{paymentId}/status |
Check payment status | X | ||
Get payment GET /payments/{payment-product}/{paymentId} |
Return of the payer's account | Sí | The payment detail is returned and IF the payer's account (debtorAccount) is informed after the SCA ok | X |
Return of the payer's name | Sí | The payment detail is returned and IF the name of the payer (debtorName) is informed after the SCA ok | X | |
Authorize start of payment POST /payments/{payment-product}/{paymentId}/authorisations |
The TPP requires an explicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multilevel SCA (several PSU sign the operation) |
X | ||
Update PSU Authorization Data (scaMethod) PUT payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
The TPP can use this request to inform the ASPSP of the SCA method selected by the PSU in case of have more than one available | |||
Get list of authorization subresources GET /payments/{payment-product}/{paymentId}/authorisations |
The TPP can read the list of authorization subresource IDs that have been created | X | ||
Authorization SCA Status GET /payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
The TPP can use this request to obtain the SCA status of the authorization. | X | ||
Cancel payment DELETE /payments/{payment-product}/{paymentId} |
Functionality to cancel a payment (if allowed by the ASPSP). | X | ||
Implicit Cancellation Authorization | The TPP requires an implicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multilevel SCA (several PSU sign the operation) Note: mandatory if cancellation authorization supported |
X | ||
Authorize payment initiation cancellation POST payments/{payment-product}/{paymentId}/cancelation-authorisations |
The TPP requires an explicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multilevel SCA (several PSU sign the operation) Note: mandatory if cancellation authorization supported |
X | ||
Update PSU cancellation authorization data (scaMethod) PUT payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancelationId} |
The TPP can use this request to inform the ASPSP of the SCA method selected by the PSU in case of have more than one available Note: mandatory if SCA method selection is supported |
|||
Get Cancellation Authorization Sub-Resource List GET payments/{payment-product}/{paymentId}/cancelation-authorisations |
The TPP can read the list of cancellation authorization subresource IDs that have been created Note: mandatory if cancellation authorization supported |
X | ||
SCA status of cancellation authorization GET payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancellationId} |
The TPP can use this request to obtain the SCA status of the cancellation authorization Note: required if cancellation authorization supported |
X |
Initiating a bulk payment | V1.1 | |||
Bulk payment initiation POST bulk-payments/{payment-product} |
Payment product supported | sepa-credit-transfers [1] | Normal credit transfers within the euro zone (SEPA). It is indicated in the PATH of the request. | X |
instant-sepa-credit-transfers [1] |
Immediate credit transfers within the euro zone (iSEPA). It is indicated in the PATH of the request. *NOTE: For this payment product it is additionally mandatory to send the townName field. |
X | ||
target-2-payments | Payments through the TARGET2 system. It is indicated in the PATH of the request. | |||
cross-border-credit-transfers | Cross-border credit transfers. It is indicated in the PATH of the request. | |||
Support start payment bulk multi-currency accounts | Applies to all paid products | Allows you to make a transfer from a sub-account identified by IBAN + currency | X | |
Bulk payment status [1] GET bulk-payments/{payment-product}/{paymentId}/status |
Check bulk payment status | X | ||
Get bulk payment GET bulk-payments/{payment-product}/{paymentId} |
Return of the payer's name | No | The payment detail is returned and the name of the payer (debtorName) is NOT reported after the SCA ok [1] | X |
Yes | The payment detail is returned and IF the name of the payer (debtorName) is reported after the SCA ok [1] | X | ||
Authorize bulk payment initiation [1] POST bulk-payments/{payment-product}/{paymentId}/authorisations |
The TPP requires an explicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multilevel SCA (several PSU sign the operation) |
X | ||
Update PSU authorization data (scaMethod) PUT bulk-payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
The TPP can use this request to inform the ASPSP of the SCA method selected by the PSU in case of be more than one available | |||
Get list of authorization subresources [1] GET bulk-payments/{payment-product}/{paymentId}/authorisations |
The TPP can read the list of authorization subresource IDs that have been created | X | ||
Authorization SCA Status [1] GET bulk-payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
The TPP can use this request to obtain the SCA status of the authorization. | X | ||
Cancel bulk payment DELETE bulk-payments/{payment-product}/{paymentId} |
Functionality to cancel a bulk payment (if allowed by the ASPSP). | |||
Autorización implícita de cancelación | The TPP requires an implicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multilevel SCA (several PSU sign the operation) Note: mandatory if cancellation authorization supported |
|||
Authorize cancellation of bulk payment initiation POST bulk-payments/{payment-product}/{paymentId}/cancelation-authorisations |
The TPP requires an explicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multilevel SCA (several PSU sign the operation) Note: mandatory if cancellation authorization supported |
|||
Update PSU cancellation authorization data (scaMethod) PUT bulk-payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancelationId} |
The TPP can use this request to inform the ASPSP of the SCA method selected by the PSU in case of have more than one available Note: mandatory if SCA method selection is supported |
|||
Get Cancellation Authorization Sub-Resource List GET bulk-payments/{payment-product}/{paymentId}/cancelation-authorisations |
The TPP can read the list of cancellation authorization subresource IDs that have been created Note: mandatory if cancellation authorization supported |
|||
SCA status of cancellation authorization GET bulk-payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancelationId} |
The TPP can use this request to obtain the SCA status of the cancellation authorization Note: required if cancellation authorization supported |
Initiating a periodic/recurring payment | V1.1 | |||
Start periodic/recurring payment POST periodic-payments/{payment-product} |
Supported payment product | sepa-credit-transfers | Normal credit transfers within the euro zone (SEPA). It is indicated in the PATH of the request. | X |
instant-sepa-credit-transfers[3] | Immediate credit transfers within the euro zone (iSEPA). It is indicated in the PATH of the request. | |||
target-2-payments [2] | Payments through the TARGET2 system. It is indicated in the PATH of the request. | X | ||
cross-border-credit-transfers [1] | Cross-border credit transfers. It is indicated in the PATH of the request. | X | ||
Support start payment periodic/recurring multi-currency accounts | Applies to all paid products | Allows you to make a transfer from a sub-account identified by IBAN + currency | X | |
Regular/Recurring Payment Status GET periodic-payments/{payment-product}/{paymentId}/status |
Check recurring/recurring payment status | X | ||
Get regular/recurring payment GET periodic-payments/{payment-product}/{paymentId} |
Get the details of a recurring/recurring payment | X | ||
Authorize start of periodic/recurring payment POST periodic-payments/{payment-product}/{paymentId}/authorisations |
The TPP requires an explicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multi-level SCA (several PSU sign the operation) |
X | ||
Update PSU authorization data (scaMethod) PUT periodic-payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
The TPP can use this request to inform the ASPSP of the SCA method selected by the PSU in case of be more than one available | |||
Get list of authorization subresources GET periodic-payments/{payment-product}/{paymentId}/authorisations |
The TPP can read the list of authorization subresource IDs that have been created | X | ||
SCA authorization status GET periodic-payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
The TPP can use this request to get the SCA status of the authorization. | X | ||
Cancel periodic/recurring payment DELETE periodic-payments/{payment-product}/{paymentId} |
Functionality to cancel a periodic/recurring payment (if allowed by the ASPSP). | X | ||
Implied authorization to cancel | The TPP requires an implicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multi-level SCA (several PSU sign the operation) Note: mandatory if cancellation authorization supported |
X | ||
Authorize cancellation of periodic/recurring payment initiation POST periodic-payments/{payment-product}/{paymentId}/cancelation-authorisations |
The TPP requires an explicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multi-level SCA (several PSU sign the operation) Note: mandatory if cancellation authorization supported |
X | ||
Update PSU cancellation authorization data (scaMethod) PUT periodic-payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancellationId} |
The TPP can use this request to inform the ASPSP of the SCA method selected by the PSU in case of have more than one available Note: mandatory if SCA method selection is supported |
|||
Get Cancellation Authorization Sub-Resource List GET periodic-payments/{payment-product}/{paymentId}/cancelation-authorisations |
The TPP can read the list of cancellation authorization subresource IDs that have been created Note: mandatory if cancellation authorization supported |
X | ||
SCA status of cancellation authorization GET periodic-payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancellationId} |
The TPP can use this request to obtain the SCA status of the cancellation authorization Note: required if cancellation authorization supported |
X |
Account access service (AIS)
Trusted Beneficiaries | V1.1 | |||
Get list of trusted beneficiaries GET /trusted-beneficiaries?{account-id} |
Global list | Get the listing global the beneficiaries de confidence del PSU Note: if "Global Listing" is supported it cannot be supported the "Listing by account" |
||
List by account | Get the list of the beneficiaries de confidence del Specific PSU per account Note: if "Listing per account" "Global Listing" cannot be supported |
Fund Confirmation Service
Confirmation of funds | V1.1 | |||
Confirmation POST /funds-confirmation |
Without indicating the card number | The fund query is made on the account indicated in the account field | X | |
Multi-currency accounts | The ASPSP makes a distinction between multi-currency accounts. | |||
Indicating the card number. | "cardNumber" attribute | Card number issued by the PISP. Used for choosing the sub-account on which to check the balance. |
Consent for confirmation of funds
Signing basket | V1.1 | |||
Set Signing Basket POST signing-baskets |
PIS Operations | The ASPSP supports that a TPP can establish N payments and sign them all at once with the Signing Basket | ||
AIS operations | Set consent | The ASPSP supports that a TPP can establish N consents and sign them all at once with the Signing Basket | ||
PIS+AS operations | Payment operations + establish consent | The ASPSP supports that a TPP can establish N consents and N payments and sign them all at once with the Signing Basket | ||
Signing Basket Status GET signing-baskets/{basketId}/status |
Allows a TPP to know the state of the Signing Basket | |||
Retrieve contents of the Signing Basket GET signing-baskets/{basketId} |
Allows a TPP to retrieve the IDs of the operations to be signed in the Signing Basket | |||
Delete Signing Basket DELETE signing-baskets/{basketId} |
Allows a TPP to remove the structure from the Signing Basket (if it has not already been authorized) | |||
Authorize Signing Basket POST signing-baskets/{basketId}/authorisations |
The TPP requires an explicit authorization of the transaction or, the ASPSP has detected that the PSU has more than one SCA method available and it is necessary for the TPP to update the SCA method selected by the PSU. Also required in case the transaction requires multilevel SCA (several PSU sign the operation) |
|||
Update PSU authorization data (scaMethod) PUT signing-baskets/{basketId}/authorisations/{authorisationId} |
The TPP can use this request to inform the ASPSP of the SCA method selected by the PSU in case of be more than one available | |||
Get list of authorization subresources GET signing-baskets/{basketId}/authorisations |
The TPP can read the list of authorization subresource IDs that have been created | |||
SCA authorization status GET signing-baskets/{basketId}/authorisations/{authorisationId} |
The TPP can use this request to obtain the SCA status of the authorization. Note: required if Signing Basket is supported |
Added Value Services (SVA)
Start payment with list of available accounts | V1.1 | |
SVA payment start POST /sva/payments/{payment-product} |
Initiate a payment without informing the ordering account. In the SCA flow by redirection to the ASPSP, this will show the list of accounts available to the PSU so that it can select the one it wants to use. Note: for this start of payment, the same characteristics that the entity has selected in the start of CORE payment. |
X |
Start periodic/recurring payment with list of available accounts | V1.1 | |
SVA periodic/recurring payment start POST /sva/payments/{payment-product} |
Initiate a periodic/recurring payment without informing the ordering account. In the flow of SCA by redirection to the ASPSP, it will show the list of accounts available to the PSU so that it can select the which you want to use. Note: for this start of payment the same characteristics will apply selected the entity at the start of CORE payment. | X |
SCA flows
SCA Flows | V1.1 | |||
Redirect | Redirect only | The payment or consent authorization process is carried out through a redirection to the entity's authentication website and is executed after a correct SCA | X | |
Decoupled | The The payment authorization or consent process is carried out through a bank app and is executed after the correct SCA. | X | ||
Embedded | <Not supported> | <Not supported> | ||
Multilevel SCA | The ASPSP supports multi-level SCA Note: required if offered in Online Banking |
OAuth prestep
We inform you that from this moment on, the biometrics APP for the Sandbox environment. If you want to request access to it, you must send an email to the mailbox psd2.sandbox.soporte@redsys.es, with the subject "APP access request biometrics Sandbox", and facilitating the following access data:
- User with which the TPP has been registered in Sandbox.
Once your download invitation has been processed, you will receive a confirmation email with the who have registered in the Sandbox of the APP Center tool and another of the mailbox psd2.sandbox.support@redsys.es
Notes
Notas | |||
v1.1 | [1] Functionality not available for the following banks | ||
BBVA Reino Unido | |||
BBVA Francia | |||
BBVA Bélgica | |||
BBVA Italia | |||
BBVA Alemania | |||
[2] Functionality not available for the following banks | |||
BBVA Italia | |||
BBVA Alemania | |||
[3] Functionality available for the following banks | |||
BBVA Alemania | |||
General | [4] Functionality not available for the following banks bancos | ||
BBVA Italia |
PSU profiles
Standard PSU Profiles | |||||
Profile Code | Account properties | Account data | PSU-ID | Supported payment products | Special features |
PsuDefault-Private-1 | Particular account | AcctPsuDefPriv1 AcctPsuDefPriv2 AcctPsuDefPriv5 |
ID: user1 Pass: 1234 |
All supported by the ASPSP | SCA OK result |
PsuDefault-Private-2 | Particular account | AcctPsuDefPriv3 AcctPsuDefPriv4 |
ID: user2 Pass: 1234 |
All supported by the ASPSP | SCA KO Result |
PsuDefault-Corporate-1 [4] | Company account with multilevel SCA | AcctPsuDefCorp1 | ID: user1 Pass: 1234 |
All supported by the ASPSP | SCA OK result |
PsuDefault-Corporate-2 [4] | Company account with multilevel SCA | AcctPsuDefCorp1 | ID: user2 Pass: 1234 |
All supported by the ASPSP | SCA KO Result |
PSU profiles for SCA | |||||
Profile Code | Account properties | Account data | PSU-ID | Supported payment products | Special features |
RedirectSca-1a [4] | Company account with multilevel SCA | AcctPsuDefCorp1 | ID: user1 Pass: 1234 |
All supported by the ASPSP | SCA OK result |
RedirectSca-1b | Particular account | AcctPsuDefPriv1 AcctPsuDefPriv2 AcctPsuDefPriv5 |
ID: user1 Pass: 1234 |
All supported by the ASPSP | SCA OK result |
RedirectSca-1c | Particular account | AcctPsuDefPriv3 AcctPsuDefPriv4 |
ID: user2 Pass: 1234 |
All supported by the ASPSP | SCA KO Result |
PSU profiles for PIIS | |||||
Profile Code | Account properties | Account data | PSU-ID | ||
ConfFunds-1a | Particular account TPP activated for PIIS |
AcctPsuDefPriv1 AcctPsuDefPriv2 AcctPsuDefPriv5 |
NA | ||
ConfFunds-1b | Particular account TPP not activated for PIIS |
Debtor account (IBAN) required | NA |
BBVA Accounts | ||||||||
Profile Code | Account Properties | |||||||
bbvaes | bbvafr | bbvabe | bbvauk | bbvait | bbvade | |||
CredAcc-1 (Default creditor account) |
Particular account | Creditor Name required |
||||||
AcctPsuDefPriv1 (1st account of the PsuDefault-Private1) |
Particular account | ES2501822200160201933547 | FR7630006000011234567890001 | BE71096123456001 | GB63BBVA23591100045001 | IT27W0357601601015001460461 | DE87500319000010088305 | |
AcctPsuDefPriv2 (2nd account of the PsuDefault-Private1) |
Particular account | ES4901822200110201933554 | FR7630006000011234567890002 | BE71096123456002 | GB63BBVA23591100045002 | IT30E0357601601010000000013 | DE38500319000010087732 | |
AcctPsuDefPriv3 (1st account of the PsuDefault-Private2) |
Particular account | ES2701822200130201933561 | FR7630006000011234567890003 | BE71096123456003 | GB63BBVA23591100045003 | |||
AcctPsuDefPriv4 (2nd account of the PsuDefault-Private2) |
Particular account | ES1801822200120201933578 | FR7630006000011234567890004 | BE71096123456004 | GB63BBVA23591100045004 | |||
AcctPsuDefPriv5 (3rd account of the PsuDefault-Private1) |
Particular account | ES1801822200120201933578 | FR7630006000011234567890005 | BE71096123456005 | GB63BBVA23591100045005 | |||
Corporateaccount of PsuDefault-Corporate1 (Company account of PsuDefault-Corporate1) |
Company account | ES8401826450000201500191 | FR7630006000011234567890006 | BE71096123456006 | GB63BBVA23591100045006 | |||
Corporateaccount of PsuDefault-Corporate2 (Company account of PsuDefault-Corporate2) |
Company account | ES7301826208302012068108 | FR7630006000011234567890007 | BE71096123456007 | GB63BBVA23591100045007 |