Network Registry

To use the Vonage Network Features in production, you will need to register for approval to access Operator networks from one or more applications.

To streamline this process for you, Vonage manages registration with numerous operator partners behind the scenes for all supported Network Features, in any country made available by Vonage. This process is dependent on each Operator’s approval, which may come through to the Vonage Network Registry at different times.

The Process

To start the Vonage Network Registry process, you must have a Vonage account; if you do not already have one, you can register for an account here.

Once you're logged in, go to the Build & Manage section and click on Network Registry to get started:

There are three main steps to complete your registration for the Network Features:

1. Add a business profile: Tell us a little about the organization that owns the application.
2. Create a Network Application profile: Select the Network Features you wish to use, describe your use case, and submit for approval.
3. Connect your Vonage application: Link your profile to a new or existing Vonage Application for authentication.

Add Business Profile

A Business Profile helps Vonage and its operator partners know which organization owns each application using Network Features.

Country selection

To ensure your registration is routed to the correct Operators, you'll first need to select where service is required by choosing from the list of available countries. Your registration will be shared with available Operators in each country you select. Available countries and Operators can be seen here.

Next, complete a business profile by providing more information about the organization that owns the applications. When filling out this section, you'll need the following information:

Business profile

• Please specify your role - the functional role you perform for, or your relationship with, the organization.
• Business Name - the name of the legal entity that owns the applications that will use Vonage Network Features.
• Business registered country - the country where the organization is registered.
• Business registration ID/number - If your organization has an additional registration you may include it here to simplify the process of validation.
• Organization type - select the most appropriate type from the dropdown list.
• Trading name - If different, include the name the organization trades under.
• Business Tax number - the tax reference for the organization in the registered country will be used by Vonage and Operators to validate the organization.
• Issuing Authority - If applicable, select from the list, or specify which authority issued your Business Registration ID.

Privacy Details:

• Are you required by law to have a Data Protection Officer? - Select Yes/No if your organization is required by law to have or not a Data Protection Officer.
• Is your Organization ISO 27001 certified? - Select Yes/No if your organization is certified or not. If not, but hold equivalent certificate, a State the equivalent certification if you have one field appears. Enter the name of the certificate, or leave it empty.
• Privacy policy URL - Vonage and its Operator partners require that anyone using Network Features has a privacy policy, publicly available on the Internet - provide the address for the organization’s policy.
• Privacy Manager’s email address - include an email address that can be used for any questions relating to the privacy policy.
• Data Protection Officer’s email address - if required by law to have a DPO, include an email contact if it differs from that of the Privacy Policy Manager.

Business location

In the next section, you'll need to enter the registered address of the organization.

Once submitted you will see a summary of your Business Profile, through which you can view and track the status of your registration. You may receive email notifications when the status of your registration changes; notification settings can be changed here.

Onward provider

This section is required if you intend to resell the Vonage Network Features to other businesses. If you don't, you can select "No" to confirm that any access provided may not be used for the resell of Vonage Network Features.

If you select "Yes", you'll need to provide some information about how you will process user data, along with details on any third-party subprocessors who help you handle any data associated with the use of Network Features.

Create a Network Application Profile

A Business Profile can have any number of Application profiles, which are used to map Network Features to your use case and track Operator approval.

From the Business profile of the application owner, click the "Add application profile" button.

When filling out this section, you'll need the following information:

• Profile name - give the application a name to easily identify it.
• Category - select an application category from the drop down list.
• Infrastructure locations - select all countries where you may process personal data related to the use of requested Network Features.
• Select Network Features - select one or more Network Features that you may want to use.
• Use case description - describe your application from a consumer's point of view. Include an explanation of how the selected Network Features will help the application meet the selected purpose.
• Purpose - for each Network Feature selected, confirm the purpose from the drop down list, e.g. “Fraud Prevention and Detection”.
• Purpose Reason - explain how the selected network features will help your application meet the selected purpose.
• Privacy policy URL - provide the address for the organization’s policy.
• Terms and Conditions URL - provide the URL of the online terms and conditions for your application.

Once submitted, you will see an updated summary, including Network Application profiles. You may receive email notifications when your application status changes; notification settings can be changed here.

Connect your Vonage Application

Once your registration is approved by at least one Operator, you can link it to one or more Vonage Applications to start using Network Features. The Vonage application contains the credentials needed to make API calls.

Navigate to the Applications page on the dashboard and click 'Create a new application', then follow these steps:

• Name - Give a name to your application.
• Authentication - Either provide your own keys, or click on "Generate public and private key" to generate the keys needed during the authentication process; a new public key will appear on the text box, while your browser will automatically download the private key.
• API key - application is connected to your account API key.
• Under the privacy section, enable "Artificial intelligence" to allow use of data for AI training.
• Under the capabilities section, enable "Network Registry" and select the access type required: Playground or Production.
  • For more information about testing from the Vonage Network Registry Playground, see here.
  • For Production access, select the business profile and the application profile you created in the previous steps.

You may be prompted to configure options depending on the Network Features included in your registration.

Managing Your Registrations

Registration Status

To see the status of your Network Feature Registration, navigate to Vonage API Dashboard→Network Registry.

Select a Business Profile and expand the Application profile to show status from each of Vonage’s operator partners in the countries you selected.

There are a number of states that registration components can be in, which can vary between components and between each of Vonage’s operator partners at any given time. Expanded views will include a summary description of each state:

• PROCESSING: Vonage is working with Operator(s) to enable your access request
• ACCEPTED: accepted by Operator(s)
• PARTIALLY-ACCEPTED: accepted by some Operators, rejected by others
• REJECTED: rejected by Operator(s)

In a Production mode, Network Feature requests will only be forwarded to an Operator if sent from an Application linked to a profile that has been accepted by that Operator.

Using Multiple API Keys

When an application profile is created, it is owned by the active key you were using in the dashboard. While this key cannot be edited, you can assign other API Keys to your application profile to enable approved Network Features across your account.

To do so, navigate to the application profile you want to assign keys to and select the Assign API Keys button. Once clicked, you'll see a list of API keys from your account:

The first key in the drop down will be the key that owns the application profile - this cannot be changed. The other keys in the list will be any other API keys in the same account as that owning key. To assign, or unassign another API Key, select it in the dropdown. When creating an application using the network features approved in your application profile, you'll be able to use any of the API keys selected in the list.

Vetting

Some Operators require additional background checks, conducted by an independent agent, on organizations requesting access to their Network Features. If these checks are required by one or more Operators in the countries you select in your Business Profile, you will be prompted to consent to vetting before your request can be submitted to them.

In addition to the information described above, you will be required to specify a point of contact in the event that the vetting agent needs to contact your organization about the information provided.

• Name: The individual who should be contacted by the vetting agent, if required
• Phone Number: The contact number of the named individual
• Email Address: The email address of the named individual

If you do not consent to vetting, those Operators that require it will be excluded from your registration and their network will not be accessible to you. If you change your mind, you can at any time request a change to your Business Profile and add your consent, which will trigger the provisioning and vetting processes with those Operators.

Notifications

When a Network Feature Registration is submitted, you will be prompted to subscribe to notifications, if not already subscribed. At any time, you can unsubscribe, or change notification settings by navigating to Vonage API Dashboard→API Settings→Notifications

Notifications, as well as any related status changes, are also visible in your Network Registry dashboard, where you may be prompted to take further action.

Support

For help with Network Features, including this registration process, see the API Support Help Center.

Next Steps

Once you've registered and have been approved, you are ready to start using the APIs!