Authenticating with Venly

Authenticating with Venly and types of authentication


Authenticating to Venly is done using OpenID Connect, which combines the OAuth 2.0 protocol together with a simple identity layer. We use OpenID Connect's Authorization Code Flow for our authentication and authorization.


An application requires a specific Client ID to connect to our environments. This not only improves security but also allows custom branding.

You will receive a clientId that is linked to your specific domain (URI).

Only calls initiated from this whitelisted domain (in combination with the clientId) will be accepted.

Authentication code

If you provide your own implementation of bearerTokenProvider, the web3 provider will not attempt to obtain an authentication code but rather use the one provided by you.

Client ID

In order to communicate with Venly, a Client ID is required.

  1. You need a Venly business account, if you don't have one, click here to register in our Developer Portal, or follow our step-by-step guide, Getting Started with Venly.
  2. You need an active trial or paid subscription of the Wallet Widget. You can start a 30-day free trial for the Wallet Widget as shown below.
  3. You need your Client ID which can be obtained from the Portal as shown below.
Starting a trial subscription and obtaining a Client ID

Starting a trial subscription and obtaining a Client ID

  1. You will also need to define valid redirect URLs, you will be using as shown below:
Starting a trial subscription and obtaining a Client ID

Whitelist domains


Connecting to the production environment and the different mainnets allows for custom branding of the Widget.