- Created by PAYONE Admin on 2019-05-03
The BankAccountCheck checks the plausibility of German account details according to the current check digit algorithms and carries out a POS blacklist inquiry if required.
Request "bankaccountcheck" | ||||||||||||||||||
Common Parameter | Required | Format | Comment | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+ |
Sub-Account ID, defined by PAYONE Format NUMERIC(5..6)
| |||||||||||||||||
- |
Specifies type of check to be performed, e.g. creditcardcheck or bankaccountcheck Format LIST
| |||||||||||||||||
- |
Language indicator (ISO 639) to specify the language that should be presented to the customer (e.g. for error messages, frontend display). If the language is not transferred, the browser language will be used. For a non-supported language English will be used. Format LIST Permitted values ISO 639-1 (Language) 2-letter-codes
| |||||||||||||||||
Check of international bank account | ||||||||||||||||||
o |
Account type/ country for use with BBAN (i.e. bankcode, bankaccount): DE DE: Mandatory with bankcode, bankaccount, optional with IBAN For other countries than DE please use IBAN or IBAN/BIC Format LIST
| |||||||||||||||||
o |
IBAN to be used for payment or to be checked Format CHAR(10..34) Permitted Symbols
[0-9][A-Z]
| |||||||||||||||||
| o |
Bank Identifier Code to be used for payment or to be checked Format CHAR(8 or 11) Only capital letters and digits, no spaces Permitted Symbols
[0-9][A-Z] BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required.
| |||||||||||||||||
Check of national bank account (only DE – with IBAN-calculation) | ||||||||||||||||||
+ |
Account type/ country for use with BBAN (i.e. bankcode, bankaccount): DE DE: Mandatory with bankcode, bankaccount, optional with IBAN For other countries than DE please use IBAN or IBAN/BIC Format LIST
| |||||||||||||||||
+ |
Account number (BBAN)
Format NUMERIC(1..10)
| |||||||||||||||||
+ |
Sort code (BBAN) (only in DE)
Format NUMERIC(8)
| |||||||||||||||||
Response "bankaccountcheck" | |||
Common Parameter | Required | Format | Comment |
|---|---|---|---|
status | + | Default | VALID / INVALID / ERROR / BLOCKED |
Parameter (VALID) - account details valid | |||
o |
Account type/ country for use with BBAN (i.e. bankcode, bankaccount): DE DE: Mandatory with bankcode, bankaccount, optional with IBAN For other countries than DE please use IBAN or IBAN/BIC Format LIST
| ||
o |
Sort code (BBAN) (only in DE)
Format NUMERIC(8)
| ||
o |
Account number (BBAN)
Format NUMERIC(1..10)
| ||
bankbranchcode | o | N..5 | Branch code |
bankcheckdigit | o | AN..2 | Check digit |
o |
IBAN to be used for payment or to be checked Format CHAR(10..34) Permitted Symbols
[0-9][A-Z]
| ||
o |
Bank Identifier Code to be used for payment or to be checked Format CHAR(8 or 11) Only capital letters and digits, no spaces Permitted Symbols
[0-9][A-Z] BIC is optional for all Bank transfers within SEPA. For Accounts from Banks outside of SEPA, BIC is still required.
| ||
Parameter (BLOCKED) - account details found on blacklist or NCA list (checktype = 1 or 2 only) | |||
+ |
In case of error the PAYONE Platform returns an error code for your internal usage. Format NUMERIC(1..6)
| ||
+ |
In case of error the PAYONE Platform returns an error message for your internal usage. Format CHAR(1..1024)
| ||
- |
The customermessage is returned to your system in order to be displayed to the customer. (Language selection is based on the end customer's language, parameter "language") Format CHAR(1..1024)
| ||
Parameter (INVALID) - account details invalid | |||
+ |
In case of error the PAYONE Platform returns an error code for your internal usage. Format NUMERIC(1..6)
| ||
+ |
In case of error the PAYONE Platform returns an error message for your internal usage. Format CHAR(1..1024)
| ||
- |
The customermessage is returned to your system in order to be displayed to the customer. (Language selection is based on the end customer's language, parameter "language") Format CHAR(1..1024)
| ||
Parameter (ERROR) - request faulty | |||
+ |
In case of error the PAYONE Platform returns an error code for your internal usage. Format NUMERIC(1..6)
| ||
+ |
In case of error the PAYONE Platform returns an error message for your internal usage. Format CHAR(1..1024)
| ||
- |
The customermessage is returned to your system in order to be displayed to the customer. (Language selection is based on the end customer's language, parameter "language") Format CHAR(1..1024)
| ||
- No labels