Main page - Santander

Documentation Download:

Online API Spanish documentation English documentation YAML file download

Domains
API sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-entrada-xs2a/services/bancosantander	API OAuth-sandbox https://apis-i.redsys.es:20443/psd2/xs2a/api-oauth-xs2a/services/rest/bancosantander
API production https://psd2.redsys.es/api-entrada-xs2a/services/bancosantander	API oAuth-production https://hubpsd2.redsys.es/api-oauth-xs2a/services/rest/bancosantander

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
	Future payment start support (New field requestedExecutionDate)	sepa-credit-transfers
		cross-border-credit-transfers
Payment status GET /v1/payments/{payment-product}/{paymentId}/status
Get payment GET /v1/payments/{payment-product}/{paymentId}
Cancel payment DELETE payments/{payment-product}/{paymentId}

Permanent order to initiate periodic / recurring payments
Start of periodic payment POST /v1/periodic-payments/{payment-product}	Payment Product Supported	sepa-credit-transfers
	Payment Product Supported	cross-border-credit-transfers
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}

Account access service (AIS)

Manage consent
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
	Get dedicated account details (single account)	With Balance
	Get account details from the list of accessible accounts	No Balance
	Get account details from the list of accessible accounts	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
	Search Filters	DateFrom - dateTo support

Fund Confirmation Service

Confirmation of funds
Confirmation POST /v1/funds-confirmations	Without indicating the card number

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}
Autorizar establecemiento de consentimiento 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 through the current autorize endpoint

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

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	ES8400490001550000000001
AcctPsuDefPriv2 (2nd account of the PsuDefault-Private1)	Particular account	ES1400490001510000000002
AcctPsuDefPriv3 (1st account of the PsuDefault-Private2)	Particular account	ES9200490001540000000003
AcctPsuDefPriv4 (2nd account of the PsuDefault-Private2)	Particular account	ES4600490001590000000004
AcctPsuDefPriv5 (3rd account of the PsuDefault-Private1)	Particular account	ES0300490001530000000005
Corporateaccount of PsuDefault-Corporate1 (Company account of PsuDefault-Corporate1)	Company account	ES5400490001580000000006
Corporateaccount of PsuDefault-Corporate2 (Company account of PsuDefault-Corporate2)	Company account	ES1100490001520000000007