Skip to main content

Bank Verification

Requirements
  • API key pair
  • Webhook set up
  • Bank verification credits
Image alt text

Bank Verification Service for Enhanced Compliance

  • Verify customers instantly using open banking integration.
  • Streamline onboarding by letting users log in with bank credentials.
  • Access identity data and transaction history from 2,500+ European banks.
  • Analyze transactions, assess risk profiles, and automate proof of funds.
  • Ensure compliance with detailed audit logs and secure data handling.
Read more

Bank Verification API Integration​

Generating a Bank Verification Token​

Generate bank verification token

Authorizations:
API key pair
Request Body schema: application/json
lifetime
integer [ 0 .. 2592000 ]
Default: 3600

The duration in seconds of bank verification token validity.

country
string or null
Enum: "AT" "BE" "BG" "HR" "CY" "DK" "EE" "FI" "FR" "DE" "GR" "HU" "IS" "IE" "IT" "LV" "LT" "LU" "MT" "NL" "NO" "PL" "PT" "RO" "SK" "SI" "ES" "SE"
bank
string or null <= 32 characters
object (BankAccessRequest)

Responses

Request samples

Content type
application/json
{
  • "lifetime": 3600,
  • "country": "AT",
  • "bank": "string",
  • "access": {
    }
}

Response samples

Content type
application/json
{
  • "tokenString": "string",
  • "expiration": "2019-08-24T14:15:22Z",
  • "isValid": true,
  • "country": "AT",
  • "bank": "string",
  • "access": {
    }
}
creating redirection link

Appended generated tokenString with the link https://bank-verification.ui.idenfy.com/?token= to provide to end-user.

URL: https://bank-verification.ui.idenfy.com/?token=LVS8YgSTTVuXAHiur10yCabIAWLizUlX

Webhook Response​

Once the end-user completes Bank Verification, you will receive a webhook notification with the response.

Bank verification Webhook

This notification is sent when a bank verification is completed.

Find info about webhook signing here.
header Parameters
Idenfy-Event-Type
required
string
Value: "BANK_VERIFICATION"
Idenfy-Signature
string

Webhook signature

Request Body schema: application/json
required
id
required
string <uuid>
country
string or null
Enum: "AF" "AX" "AL" "DZ" "AS" "AD" "AO" "AI" "AQ" "AG" "AR" "AM" "AW" "AU" "AT" "AZ" "BS" "BH" "BD" "BB" "BY" "BE" "BZ" "BJ" "BM" "BT" "BO" "BQ" "BA" "BW" "BV" "BR" "IO" "BN" "BG" "BF" "BI" "CV" "KH" "CM" "CA" "KY" "CF" "TD" "CL" "CN" "CX" "CC" "CO" "KM" "CG" "CD" "CK" "CR" "CI" "HR" "CU" "CW" "CY" "CZ" "DK" "DJ" "DM" "DO" "EC" "EG" "SV" "GQ" "ER" "EE" "SZ" "ET" "FK" "FO" "FJ" "FI" "FR" "GF" "PF" "TF" "GA" "GM" "GE" "DE" "GH" "GI" "GR" "GL" "GD" "GP" "GU" "GT" "GG" "GN" "GW" "GY" "HT" "HM" "VA" "HN" "HK" "HU" "IS" "IN" "ID" "IR" "IQ" "IE" "IM" "IL" "IT" "JM" "JP" "JE" "JO" "KZ" "KE" "KI" "XK" "KW" "KG" "LA" "LV" "LB" "LS" "LR" "LY" "LI" "LT" "LU" "MO" "MG" "MW" "MY" "MV" "ML" "MT" "MH" "MQ" "MR" "MU" "YT" "MX" "FM" "MD" "MC" "MN" "ME" "MS" "MA" "MZ" "MM" "NA" "NR" "NP" "NL" "NC" "NZ" "NI" "NE" "NG" "NU" "NF" "KP" "MK" "MP" "NO" "OM" "PK" "PW" "PS" "PA" "PG" "PY" "PE" "PH" "PN" "PL" "PT" "PR" "QA" "RE" "RO" "RU" "RW" "BL" "SH" "KN" "LC" "MF" "PM" "VC" "WS" "SM" "ST" "SA" "SN" "RS" "SC" "SL" "SG" "SX" "SK" "SI" "SB" "SO" "ZA" "GS" "KR" "SS" "ES" "LK" "SD" "SR" "SJ" "SE" "CH" "SY" "TW" "TJ" "TZ" "TH" "TL" "TG" "TK" "TO" "TT" "TN" "TR" "TM" "TC" "TV" "UG" "UA" "AE" "GB" "UM" "US" "UY" "UZ" "VU" "VE" "VN" "VG" "VI" "WF" "EH" "YE" "ZM" "ZW"
bank
string or null <= 32 characters
required
Array of objects or null (BankAccountWebhook)
riskLevel
required
string or null
Enum: "VERY_LOW" "LOW" "MEDIUM" "HIGH" "VERY_HIGH" "NOT_CHECKED"

Responses

Request samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "country": "AF",
  • "bank": "string",
  • "accounts": [
    ],
  • "riskLevel": "VERY_LOW"
}

Listing Account Transactions​

List bank verification account transactions

Authorizations:
API key pair
path Parameters
accountId
required
string
verificationId
required
string
query Parameters
page
integer

A page number within the paginated result set.

perPage
integer

Number of results to return per page.

Responses

Response samples

Content type
application/json
{}