Getting started with Veriff

This will help you integrate Veriff into your application. For full Developer's Documentation, head developers.veriff.me.

  1. Create a Veriff account

    Sign up here
  2. Head to your inbox

    We’ll send you an email that contains a login link.

  3. Follow the link and authenticate

    Download Google Authenticator (iOS or Android). Follow the link we emailed and you’ll see a QR code. Scan it with Google Authenticator. You’ll see a 6-digit code.

  4. Log in to Veriff's back office

    Use the 6-digit code from Google Authenticator to finalize your account.
    Get 'API_KEY' (Management -> Vendor -> General -> API Key) from Veriff's back office.

  5. Integrate Veriff Javascript SDK into your front-end application

    Install using npm:

    $ npm install --save @veriff/js-sdk

    or download from CDN:

    <script src="https://cdn.veriff.me/sdk/js/veriff.min.js"></script>

    Finally, integrate:

    <div id="veriff-root"></div>
    const veriff = Veriff({
      env: "production",
      apiKey: "24748e88-a299-42c9-a2f2-2d44807e7e88",
      parentId: "veriff-root",
      onSession: function(err, response) {
        // Access verification ID through "response.verification.id"
        location.replace(response.verification.url);
      }
    });
    veriff.mount();
  6. Integrate Veriff Javascript SDK into your back-end application

    Go to Veriff's back office and set 'Notification url' webhook endpoint (Management -> Vendors -> Edit) to which Veriff will post decision notifications of verification results. Note that only https will be allowed.

    On your side, open an endpoint and set it to the same 'Notification url'. Once verification for a user has been completed, a POST request webhook with application/json media type will be heading to your way.

    Show JSON response:

    {
      "status": "success",
      "verification": {
        "id": "f04bdb47-d3be-4b28-b028-a652feb060b5",
        "status": "approved",
        "code": 9001,
        "reason": null,
        "acceptanceTime": "2017-01-18T12:22:50.239Z",
        "person": {
          "firstName": "John",
          "lastName": "Smith",
          "idNumber": null,
          "citizenship": null,
          "dateOfBirth": "1990-01-01",
          "gender": "M",
          "nationality": null
        },
        "document": {
          "number": "B01234567",
          "type": "PASSPORT",
          "country": "DE",
          "validFrom": "2015-11-11",
          "validUntil": "2021-12-09"
        },
        "comments": [],
        "additionalVerifiedData": {}
      },
      "technicalData": {
        "ip": "192.0.2.55"
      }
    }
  7. Well done!

    You’re now ready to use Veriff's back office on office.veriff.me.

  8. Create account