Developer Dashboard

Developers Dashboard - Signing Up

With the Developers Dashboard, we provide an easy way to create and manage applications that integrate with the PDA. In short, it offers:

  • Creating a Developers account that can be used to manage applications

  • Creating a Testing PDA that can be used in order to interact with applications during testing

  • Creating a new Project that encapsulates the entire life cycle of an application - from Development to Testing to Going Live.

  • Updating information about an existing Project

  • Submitting the Project for review in order to release the application in the HATDeX platform for public consumption

  • Creating test application to test new features without affecting the application that is already available to the public

  • Offering developer support to achieve all the above either through documentation/guides or by contacting us directly

Signing up for a New Developer Account

You can sign up for a new Developer Account by clicking Create Account in the top right corner of the Developers Dashboard.

When getting a new developer account, you will be asked for the following profile information:

  • First Name — First name of the main developer

  • Last Name — Last name of the main developer

  • Email — Email Address.

  • Terms of Service — Read and agree to the terms of Service

If you do not already have a PDA, one will be created for you with this Email address.
Please use a valid email address, or else, the verification process will fail.

What happens when a new PDA is created for you

After filling out the information needed, click Next to have your PDA created. At this point, you will be presented with a screen asking you to verify your account. An email would have been sent to your registered address.

Upon click on the link within. you will be asked to set a password for the new PDA. The password must achieve a strength rating of good or above otherwise the process will not continue. You can find our password policy here.

In the next screen after clicking Next, you will be redirected back to the Developers Dashboard application, which will ask permissions to have access to the new PDA account.

Your final confirmation click will bring you to the Developers Dashboard home page.

Logging in for Existing Developers

To log in click Log in in the top right corner of the Developers Dashboard.

Then enter the email address of your PDA, and click Next. If your PDA is located, you will be brought to your PDA's password screen. Input your password, and you will be signed into the Developers Dashboard.

Existing PDA users logging in to the Developers Dashboard for the first time will be asked for the same profile information as in "Signing up for a New Developer Account"

Using the Developers Dashboard

Dashboard Overview

The Dashboard contains the following sections.

1. Overview

  • Contains shortcuts to various dashboard functions

  • Status Overviews of current Projects

    2. Projects

  • Status Overviews of current Projects

  • Allows the creation of new Projects

    3. Docs

    Contains documentation sich as

  • Platform Overview

  • API information

  • Link to the PDA code repository

    4. Test Account

  • Shows the URL and credentials of the Test PDA.

  • The Test PDA is created when the Developers Account is created.

    5. Support

  • Use this online form to get technical support from Dataswift.

    6. Profile

  • the Developer Account information of the logged in user.

Creating the Project

Creation of a new Project is done by either clicking 1. the Start Here button in the Quick start your project card in the Overview section. 2. the New Project button in the Create a new project card found in both the Overview and Projects sections.

A new window with all necessary information needed to create a new application will appear. This list contains:

  • Company Name — The name of the company who owns the application. Only appears if Company Name has not been set.

  • Country — The country of operation of the Company. Only appears if Country has not been set.

  • Application Name — A human-readable name of the application. It can be the same with other applications

  • Application Website — A URL where more information about the application can be found

  • Application Namespace — The unique application namespace. This will define the domain

    under which the application will be able to read/write data. Must not contain spaces or special characters

  • Platforms — The platforms this application will support. Currently, we offer 3 options Web, Android and iOS

These are the minimum information needed to create a Project

Please note that the new Project can take up to 30 minutes to be visible in the PDA

Updating the Project and/or Submitting it for Review

By clicking any Project under Projects section, all the information about it can be seen. The information can also be edited under certain conditions.

Please note this image also showcases how its possible for two applications to have the same name
by having different application ids.

By clicking a Project is possible to fill even more information about the application. These information are grouped into

1. General Settings

  • Application Name — A human-readable name of the application. It can be the same with other applications

  • Application Website — A URL where more information about the application can be found

  • Support Email — An email users can ask support if there is a problem with the application

  • Application ID — System assigned and non-editable.

  • Application Namespace — The unique application namespace. This will define the domain

    under which the application will be able to read/write data. Once set, it is non-editable.

    2. Platforms

  • The platforms this application will support. Currently, we offer 3 options Web, Android and iOS

  • OAuth Redirect URI(s) — the permitted links you will like your user to be redirected to upon logging in or on completion of sign up. A comma-separated list is accepted.

    3. Privacy & Terms of Use

  • Link to Privacy Policy — A URL where users can see the application's privacy policy

  • Link to Terms of Use — A URL where users can see the application's terms and conditions

    4. Rating

  • A 3 lettered system indicating how the application uses the data

    5. Description and Previews

  • Short Preview Description — A preview description of the application`

  • Long Description — A description of what the application offers to the users

  • Application Purpose — What the application is for

  • Application Icon — An image to use as the application logo.

    6. Data Attributes

  • This is the section that allows you to download the Transaction Request Form

  • A completed Transaction Request Form (TRF) is required for the application to be reviewed and be connected to the Dataswift One live platform.

  • Upload the completed TRF here

Please note that in order to submit an application for review, all of the fields must be filled.

Once the necessary changes have been made, clicking Save in the bottom right corner of the screen will save the changes without Submitting the application.

Submitting an application is possible by clicking the Submit button. Please note that any changes must be saved first in order to submit the application for review. After submitting the application for review, a new one will be created for test purposes. Please use that one from now one to make any further changes/updates to the application. By creating a second, separate, application we ensuring that any changes made will not affect the current live application.

Pushing an update

After submitting the application, the application will lock and it will not be possible to make any more changes. Any changes from this point onward will have to be done in the test application. In order to submit a new version of the application, just submit the test application for review. The currently live one will be replaced by the new one once a manager approves your update.

App rejections or suspensions

A manager can reject or suspend an application at any time. This can be due to problems with the application or for security reasons. A rejection or suspension message will be sent to your email with more information about the reason that led to this.

App statuses

The possible application statuses are:

  • draft — Application not submitted for review yet. It's currently live in the staging

    environment, hubat.net and able to be tested with a hubat.net HAT

  • test — This application is the test version of a currently review or live application.

    Its purpose is to provide a testing ground for further updates to the live application.

  • review — Application has been submitted for review by a manager.

  • live — Application is currently live on all HATs

  • rejected — Application has be rejected. Please look at your emails for further details as to why it has happened.

  • submitted — Application has be suspended. Please look at your emails for further details as to why it has happened.

Editing Profile information

The Profile section holds the basic information of user/organisation. Some information is possible to edit and some not. The following can be edited at any time:

  • First Name — Developers first name, stored in the PDA

  • Last Name — Developers last name, stored in the PDA

  • Personal Website — Developers website, stored in the PDA

  • Company — Company name. This has to be unique

  • Country — Country the company is based

  • Company Website — Company's website URL

  • Company Logo — Company's logo

Other information provided in this section includes:

  • Reset Password — Reset password option

Test Account

During sign up a test PDA is created. The credentials can be found under Test Account.

Please note that the test account will always be hubat.net account