Whitelist

Auto-reject fraud reports on your whitelisted IBANs.

The whitelist holds IBANs your institution knows to be trusted. It drives automatic rejected qualification: when a whitelisted IBAN is reported by another organization, Qombo can auto-qualify the related alert with the confirmed rejected code you chose.

This is one of the three IBAN lists.

Endpoints

MethodPathPurpose
POST/sharing/v1/whitelist/searchList whitelisted IBANs, or search for one.
POST/sharing/v1/whitelistAdd one or more IBANs (up to 500).
DELETE/sharing/v1/whitelistRemove one or more IBANs.

Adding entries

Each entry is an { iban, qualification } pair. The qualification describes why the IBAN is trusted and is auto-applied on future checks:

  • GENUIN — genuine account
  • REGUL — regular / known counterparty
  • MERCHT — merchant
  • CLOSED — closed account

Searching

Send an empty body to list every entry, or pass an iban to look up a single one. Each result returns the iban, type, qualification, and the createdAt date it was added.

🚧

Conflicts

Adding an IBAN already present on the blacklist list returns 409.
Deleting an IBAN that isn't whitelisted returns 404.