Confirm the reliability of the given bank account against the CDQ Whitelist (trust score based on transactions) and the Blacklist (fraud cases).

The BankAccount that is sent in the request needs to uniquely identify a bank account. Minimal sets of attributes that are considered valid to identify a bank account are:

1. Only the IBAN (= internationalBankAccountIdentifier):

   {
     "bankAccount": {
       "internationalBankAccountIdentifier": "CH8800781619278412000"
     }
   }
   

2. The bank account number (= nationalBankAccountIdentifier) and the BIC (= internationalBankIdentifier):

   {
     "bankAccount": {
       "nationalBankAccountIdentifier": "619278412000",
       "internationalBankIdentifier": "KBSGCH22XXX"
     }
   }
   

3. The bank account number (= nationalBankAccountIdentifier), bank code/number (= nationalBankIdentifier) and bank country code (= bankCountryCode):

   {
     "bankAccount": {
       "bankCountryCode": "CH",
       "nationalBankIdentifier": "00781",
       "nationalBankAccountIdentifier": "619278412000"
     }
   }
   

If attributes are missing to uniquely identify a bank account an ApiError will be returned.

The response will always contain the BankAccount provided in the request and depending on the result found in the Whitelist or the Blacklist or neither, the following:

1. A whitelist entry and no fraud case was found:

   {
     "bankAccountRequest": {
       "internationalBankAccountIdentifier": "CH8800781619278412000"
     },
     "bankAccountConfirmed": {
       "bankCountryCode": "CH",
       "nationalBankIdentifier": "00781",
       "nationalBankAccountIdentifier": "619278412000",
       "internationalBankIdentifier": "KBSGCH22XXX",
       "internationalBankAccountIdentifier": "CH8800781619278412000"
     }
     "numberOfCompanies": "5",
     "numberOfPayments": "42",
     "lastPaymentAt": "2019-01-24",
     "trustScore": "7"
   }
   

2. A fraud case entry was found:

   {
     "bankAccountRequest": {
       "internationalBankAccountIdentifier": "CH8800781619278412000"
     },
     "associatedFraudCases": [
       {
         "cdlId": "123456",
         ...
       }
     ]
   }
   

3. The bank account is unknown (no trust score and no fraud case exists):

   {
     "bankAccountRequest": {
       "internationalBankAccountIdentifier": "CH8800781619278412000"
     }
   }