Skip to main content

Management of B2B Device in PRODA

How to Register a PRODA device and enable it for MBSPro

Abby Verano avatar
Written by Abby Verano
Updated over 2 months ago

Managing B2B Devices in PRODA for MBSPro

This guide explains how to register, activate, and manage Business-to-Business (B2B) devices in Provider Digital Access (PRODA). This device can then be activated via MBS Pro to be used in calls to the Health APIs.

Steps

  1. Register for a PRODA Account

  2. Register your organisation in PRODA

  3. Add other members to your organisation for permissions

  4. Register subsidiary organisation

  5. Register a B2B device in PRODA

  6. Active the device in MBSPro

Before you begin, note that only members with the Device-Management attribute can register and manage B2B devices. If you need help with managing members or delegating management attributes, please contact MBSPro.

Please Note, As MBSPro uses a shared Minor ID, MBSPro manage the organisations and devices. Steps 1-4 are left out here as it this is performed by MBSPro administrators.

Step 1: Register and Activate a B2B Device

  1. Log in to PRODA.

  2. Select Organisations.

  3. Choose the organisation to which you want to register the B2B device.

  4. In the B2B Devices section, select Register New B2B Device.

  5. Enter a device name that is both descriptive and unique.

  6. Optionally, add details in the Description field.

  7. Select Register Device.

  8. A Device Activation Code will be displayed, ensure you take a note of this.

  9. To activate your device:

  • Provide the device name and code to MBSPro.

  • Remember that the device name and activation code are case sensitive.

Step 2 : Active the Device in MBS Pro

  1. The activation of the device in MBSPro is achieved through an API call to the active device endpoint

  2. Acquire a authentication token for MBSPro.

  3. Call the Device Activation endpoint with the device name and activation code

  4. Once activated, the device remains active until it’s expiry date. When the device is coming to the end of it’s expiry date an email will be sent to MBSPro and the device can be re-activated using the API call.

var client = new HttpClient(); var request = new HttpRequestMessage(HttpMethod.Post, "http://api-url-here/api/Proda/activate-device?deviceName=XSCTestingActivateDevice&activationCode=jDa6fArqmC"); request.Headers.Add("Authorization", "Bearer ey..."); var content = new StringContent("", null, "text/plain"); request.Content = content; var response = await client.SendAsync(request); response.EnsureSuccessStatusCode(); Console.WriteLine(await response.Content.ReadAsStringAsync());

FAQ and Ongoing Management Of Your B2B Device

  1. Regenerate Activation Code:

    • If you lose the activation code or it expires, select Generate New Code in the device details

  2. Reactivation:

    • If your device expires after six months, it will stop working with your service provider. Generate a new code to reactivate it. This is performed through the same API endpoint as the initial activation.

  3. Notifications:

    • You will receive automated email notifications before the device expires.

  4. Additional Actions:

You can:

  • Extend the expiry date,

  • Disable or remove a device,

  • View the device history, or

  • Assign device attributes if specific functions are required by the service provider.

  • If the device expires before the six-month period, contact your software developer or ICT manager.

Related Articles
Getting Started
Did this answer your question?