Account verification

Account verification⚓

The API allows you to compare the bank details provided by your customer to the information that the bank holding the account has. The API asks the bank if the account is opened and performs account's holder name and birthdate checks.

This service works for now only for French bank accounts (also known as SEPAMail service) and is an asynchronous process. You will need to wait a few minutes to get the check result from the account holder bank.

To perform an account verification, you need to POST both the Customer and the SEPA objects. Please note that existing objects can be replaced by their respective ids.

The SEPA check object is defined as follows:

Ask for validation check⚓

You can initiate a validation check by posting a SEPA object or by passing an already know SEPA object id.

HTTP request⚓

Data parameters⚓

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

curl -X POST "https://api.stancer.com/v1/sepa/check/" \
  --header "Content-Type: application/json" \
  --data '{
    "customer": {
      "name": "Pierre Martin",
      "date_birth": "1978-09-09"
    },
    "sepa": {
      "iban": "FR1420041010050500013M02606"
    }
}'

The above command returns a JSON structured as follows:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "customer":{
    "name": "Pierre Martin",
    "email": "pierre@martin.fr",
    "date_birth": "1978-09-09"
  },
  "sepa":{
    "iban": "FR1420041010050500013M02606",
    "name": "Pierre Martin"
  }
}

Return parameters⚓

The API will returns the following fields:

If the bank holding the account does not accept IBAN checks, the API returns a HTTP 400 Error. For testing purposes, all the IBAN samples work. However, bear in mind that so far, only French banks allow IBAN checks.

Get account verification check⚓

1

curl "https://api.stancer.com/v1/sepa/check/chck_fZvOCm7oDmUJhqvezEtlZwXa"

The above command returns JSON structured as follows:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
    "date_birth_valid": true,
    "id": "chck_fZvOCm7oDmUJhqvezEtlZwXa",
    "iban_type": true,
    "iban_valid": true,
    "verified": true,
    "response": null,
    "score_name": 90,
    "status": "checked"
}

HTTP request⚓

Query parameters⚓

Return parameters⚓

It will return the IBAN checked data asssociated with the id_chck you provided. If the id_chck does not exist, the API will return a 404 HTTP response code.