Main page - BBVA
Documentation Download:
Domains | |
API sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-entrada-xs2a/services/BBVA |
API oAuth-sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-oauth-xs2a/services/rest/BBVA |
API production |
API oAuth-production |
Entity Configuration:
Payment Initiation Service (PIS)
SIMPLE PAYMENT INITIATION | ||
Payment Start POST /v1/payments/{payment-product} |
Payment Product Supported | sepa-credit-transfers |
instant-sepa-credit-transfers | ||
target-2-payments | ||
cross-border-credit-transfers | ||
Support payment start multi-currency accounts | Applies to all payment products | |
Future payment start support (New field requestedExecutionDate) |
sepa-credit-transfers | |
target-2-payments | ||
cross-border-credit-transfers | ||
Future payment start support cuentas multi-moneda | Applies to all payment products | |
Payment status GET /v1/payments/{payment-product}/{paymentId}/status |
||
Get payment GET /v1/payments/{payment-product}/{paymentId} |
||
Authorize payment start POST /v1/payments/{payment-product}/{paymentId}/authorisations
|
||
Get list of authorized sub-resources GET /v1/payments/{payment-product}/{paymentId}/authorisations |
||
SCA authorization status GET /v1/payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
||
Cancel payment DELETE /v1/payments/{payment-product}/{paymentId} |
||
Authorize cancellation of payment start POST /v1/payments/{payment-product}/{paymentId}/cancelation-authorisations |
||
SCA status of cancellation authorization GET /v1/payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancelationId} |
Bulk payments | ||
Payment Start Bulk
|
Payment Product Supported | sepa-credit-transfers |
instant-sepa-credit-transfers | ||
Multi-currency account Bulk Payment Start Support |
Applies to all payment products de pago |
|
Payment status Bulk
|
||
Get payment Bulk
|
||
SCA authorization status GET /v1/bulk-payments/{payment-product}/{paymentId}/authorisations |
Permanent order to initiate periodic / recurring payments | ||
Start of periodic payment
|
Payment Product Supported | sepa-credit-transfers |
target-2-payments |
||
cross-border-credit-transfers |
||
Soporte de inicio de pago periodic/recurrente cuentas multi-moneda |
Applies to all payment products |
|
Periodic payment status
GET /v1/periodic-payments/{payment-product}/{paymentId}/status |
||
Get payment periodic
GET /v1/periodic-payments/{payment-product}/{paymentId} |
||
SCA authorization status GET /v1/periodic-payments/{payment-product}/{paymentId}/authorisations/{authorisationId} |
||
Cancel periodic payment
DELETE /v1/periodic-payments/{payment-product}/{paymentId} |
||
Authorize cancellation of periodic payment start
POST /v1/periodic-payments/{payment-product}/{paymentId}/cancelation-authorisations |
||
SCA status of cancellation authorization
GET /v1/periodic-payments/{payment-product}/{paymentId}/cancelation-authorisations/{cancelationId} |
Account access service (AIS)
Manage consent | ||
General |
Sessions | combinedServiceIndicator |
Request consent POST /v1/consents |
Detailed consent (Detailed consent) |
Request access type "accounts", "balances" and / or "transactions" indicating the accounts related to the requested consents |
Request type of access "accounts", "balances" and / or "transactions" indicating the card accounts related to the requested consents | ||
Bank offered consent (Bank offered consent) |
Request access type "accounts", "balances" and / or "transactions" without indicating the related accounts | |
Request type of access "accounts", "balances" and / or "transactions" without indicating the related card accounts | ||
Global consent (Global consent) |
Consent with access type "availableAccounts" for list of accounts available without balances | |
Consent with access type "availableAccounts" for a list of available card accounts without balances | ||
Consent with access type "availableAccountsWithBalance" for list of accounts available with balances | ||
Consent with access type "allPsd2" | ||
Consent status GET /v1/consents/{consentId}/status |
||
Get consent GET /v1/consents/{consentId} |
||
Remove consent DELETE /v1/consents/{consentId} |
||
SCA authorization status GET /v1/consents/{consentId}/authorisations/{authorisationId} |
Account Reading | ||
Get list of available accounts
GET /v1/accounts{query-parameters}
|
No balance | |
With balance | ||
Get account detail GET /v1/accounts{query-parameters} |
Get dedicated account details (single account) | No Balance |
With Balance | ||
Get account details del listado de cuentas accesibles | No Balance | |
With Balance | ||
Get balances for a given account
GET /v1/accounts/{account-id}/balances
|
||
Get transaction information for a specific account GET /v1/accounts/{account-id}/transactions{query-parameters} |
Include balances | No Balance |
With balance | ||
Search Filters |
DateFrom - dateTo support |
|
List standing orders |
bookingStatus=information |
Fund Confirmation Service
Confirmation of funds | ||
Confirmation POST /v1/funds-confirmations |
Without indicating the card number |
|
Version with consent through the API |
Consent for confirmation of funds
Confirmation of funds | ||
Request consent POST /v2/consents/confirmation-of-funds |
||
Consent status GET /v2/consents/confirmation-of-funds/{consentId}/status |
||
Get consent GET /v2/consents/confirmation-of-funds/{consentId} |
||
Remove consent DELETE /v2/consents/confirmation-of-funds/{consentId} |
||
Authorize consent establishment POST /v2/consents/confirmation-of-funds/{consentId}/authorisations |
||
Get list of authorization sub-resources GET /v2/consents/confirmation-of-funds/{consentId}/authorisations |
||
SCA authorization status GET /v2/consents/confirmation-of-funds/{consentId}/authorisations/{authorisationId} |
Added Value Services (SVA)
PAYMENT START WITH LIST OF ACCOUNTS AVAILABLE FOR PISP | ||
SVA payment start POST /v1/sva/payments/{payment-product} |
Payment Product Supported | sepa-credit-transfers |
instant-sepa-credit-transfers | ||
target-2-payments | ||
cross-border-credit-transfers |
SCA flows
SCA flows | ||
Redirect | Only redirect |
OAuth prestep
OAuth prestep | ||
Biometrics | ||
Offer biometrics for endpoints in addition to authorize | Particulars | |
Business |
Please be informed that from this moment on, the biometric APP for the Sandbox environment is available upon request. If you want to request access to it, you must send an email to the mailbox psd2.sandbox.soporte@redsys.es, with the subject "request access to the APP biometrics Sandbox", and providing the following access data:
-User which has been used to register the TPP in Sandbox.
Once your invitation to download the APP has been processed, you will receive two confirmation emails in the mail provided at the registration in Sandbox, one from APP Center tool and another one from the mailbox psd2.sandbox.soporte@redsys.es
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 | Company account with multilevel SCA | AcctPsuDefCorp1 | ID: user1 Pass: 1234 |
All supported by the ASPSP | SCA OK result |
PsuDefault-Corporate-2 | 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 | 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 |
Account profiles:
Standard accounts | |||||
Profile Code | Account properties | Account data | |||
CredAcc-1 (Default creditor account) |
Particular account | Creditor Account (ES0040000000000000000001) required Creditor Name required |
|||
AcctPsuDefPriv1 (1st account of the PsuDefault-Private1) |
Particular account | ES2501822200160201933547 | |||
AcctPsuDefPriv2 (2nd account of the PsuDefault-Private1) |
Particular account | ES4901822200110201933554 | |||
AcctPsuDefPriv3 (1st account of the PsuDefault-Private2) |
Particular account | ES2701822200130201933561 | |||
AcctPsuDefPriv4 (2nd account of the PsuDefault-Private2) |
Particular account | ES1801822200120201933578 | |||
AcctPsuDefPriv5 (3rd account of the PsuDefault-Private1) |
Particular account | ES1801822200120201933578 | |||
Corporateaccount of PsuDefault-Corporate1 (Company account of PsuDefault-Corporate1) |
Company account | ES8401826450000201500191 | |||
Corporateaccount of PsuDefault-Corporate2 (Company account of PsuDefault-Corporate2) |
Company account | ES7301826208302012068108 |