Main page - BBVA
Documentation Download:
Domains | |
API sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-entrada-xs2a/services/BBVAPT |
API oAuth-sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-oauth-xs2a/services/rest/BBVAPT |
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 |
Support payment start multi-currency accounts | Applies to all payment products | |
Future payment start support (New field requestedExecutionDate) |
sepa-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} |
||
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} |
Permanent order to initiate periodic / recurring payments | ||
Start of periodic payment
|
Payment Product Supported | sepa-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} |
||
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 |
Bank offered consent (Bank offered consent) |
Request access type "accounts", "balances" and / or "transactions" without indicating the related accounts | |
Global consent (Global consent) |
Consent with access type "availableAccounts" for list of accounts available 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} |
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 from the list of accessible accounts | 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 |
Fund Confirmation Service
Confirmation of funds | ||
Confirmation POST /v1/funds-confirmations |
Without indicating the card number |
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 |
Multi-bank services
Multi-bank payment catalog query GET /v1/multibanco/catalogue/{multibanco-payment-type} |
||
Obtain amount to pay to social security POST /v1/multibanco/social-security/withholding |
||
Multi-bank payment start POST /v1/multibanco/payments/{multibanco-payment-type} |
||
Get multi-bank payment GET /v1/multibanco-payments/{multibanco-payment-type}/{paymentId} |
||
Delete multi-bank payment DELETE /v1/multibanco-payments/{multibanco-payment-type}/{paymentId} |
||
Multi-bank payment status GET /v1/multibanco-payments/{multibanco-payment-type}/{paymentId}/status |
||
Authorize multi-bank payment establishment POST /v1/multibanco-payments/{multibanco-payment-type}/{paymentId}/authorisations |
||
Get list of authorization sub-resources GET /v1/multibanco-payments/{multibanco-payment-type}/{paymentId}/authorisations |
||
SCA authorization status GET /v1/multibanco-payments/{multibanco-payment-type}/{paymentId}/authorisations/{authorisationId} |
||
Update PSU authorization data (scaMethod) PUT /v1/multibanco-payments/{multibanco-payment-type}/{paymentId}/authorisations/{authorisationId} |
Test users:
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 |
IBAN codes:
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 | PT50064200010020012800001 | |||
AcctPsuDefPriv2 (2nd account of the PsuDefault-Private1) |
Particular account | PT50064200010020012800002 | |||
AcctPsuDefPriv3 (1st account of the PsuDefault-Private2) |
Particular account | PT50064200010020012800003 | |||
AcctPsuDefPriv4 (2nd account of the PsuDefault-Private2) |
Particular account | PT50064200010020012800004 | |||
AcctPsuDefPriv5 (3rd account of the PsuDefault-Private1) |
Particular account | PT50064200010020012800005 | |||
Corporateaccount of PsuDefault-Corporate1 (Company account of PsuDefault-Corporate1) |
Company account | PT50064200010020012800006 | |||
Corporateaccount of PsuDefault-Corporate2 (Company account of PsuDefault-Corporate2) |
Company account | PT50064200010020012800007 |