- Created by PAYONE Admin, last modified by PAYONE Writer on 2021-11-24
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 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+ | Format | |||||||||||||||||
- | Specifies type of check to be performed, e.g. creditcardcheck or bankaccountcheck Format | |||||||||||||||||
- | 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 | |||||||||||||||||
o | Format | |||||||||||||||||
| o | Bank Identifier Code to be used for payment or to be checked Format 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 | |||||||||||||||||
+ | Account number (BBAN) Format | |||||||||||||||||
+ | Sort code (BBAN) (only in DE) Format | |||||||||||||||||
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 | ||
o | Sort code (BBAN) (only in DE) Format | ||
o | Account number (BBAN) Format | ||
bankbranchcode | o | N..5 | Branch code |
bankcheckdigit | o | AN..2 | Check digit |
o | Format | ||
o | Bank Identifier Code to be used for payment or to be checked Format 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 | ||
+ | In case of error the PAYONE Platform returns an error message for your internal usage. Format | ||
- | 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 | ||
Parameter (INVALID) - account details invalid | |||
+ | In case of error the PAYONE Platform returns an error code for your internal usage. Format | ||
+ | In case of error the PAYONE Platform returns an error message for your internal usage. Format | ||
- | 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 | ||
Parameter (ERROR) - request faulty | |||
+ | In case of error the PAYONE Platform returns an error code for your internal usage. Format | ||
+ | In case of error the PAYONE Platform returns an error message for your internal usage. Format | ||
- | 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 | ||
- No labels