This document describes the onboarding process and responsibilities of a Payer Admin within the OnyxOS Registration Portal. A Payer Admin is authorized to review, approve, reject, or revoke application access requests submitted by developers, payers, and providers for a specific data provider.

Role Overview: Payer Admin

A Payer Admin manages application approvals on behalf of a data provider. This role includes:

  • Reviewing submitted applications
  • Making approval or rejection decisions
  • Managing visibility of approved credentials
  • Revoking access when necessary

Becoming a Payer Admin

Requesting Payer Admin Access

To be designated as a Payer Admin for a data provider, you or a member of your organization must share the following details with Onyx:

  • First Name
  • Last Name
  • Email Address
  • Organization
  • Nickname (optional)
  • Middle Name (optional)

Once the request is received, Onyx performs the following actions:

  1. Creates a user profile for the Payer Admin
  2. Sends the username and temporary password to the registered email address

Payer admin Login

To access the Payer Admin portal for the first time:

  1. Navigate to the Registration Portal login page
  2. Enter the username and password or temporary password provided by Onyx

Note: If you are logging in for the first time using a temporary password, you must reset your password immediately after login to comply with security requirements.

Password Management

There are two ways to reset your password, depending on whether you are logged in or not.

Option 1: Reset Password from Profile (Authenticated User)

If you are already logged in and want to change your temporary or existing password:

  1. Go to the Profile section
  2. Click Reset Password
  3. Enter and confirm the new password

Note: No identity verification is required since the user is already authenticated.

Option 2: Reset Password via Forgot Password (Unauthenticated User)

If you have forgotten your password or need to reset a temporary password without logging in:

  1. Go to the Registration Portal login page
  2. Click Forgot Password
  3. Enter your username or registered email address
  4. A password reset link will be sent to the registered email address if a match is found
  5. Open the link and set a new password

Payer Admin Dashboard

Dashboard Overview

After successful login, a Payer Admin can view all applications from organizations where they are designated as Payer Admin for that data provider.

The dashboard contains four main tabs, Clicking on each tab will navigate to the respective pages:

  • Pending Approval
  • Approved
  • Rejected
  • Revoked

Application Categories

Each primary tab is further divided into application-specific sub-tabs. Only applications relevant to the selected tab are shown.

Application Types:

  • Patient Access API
  • Payer-to-Payer Data Exchange
  • Provider Access API

Application Review and Management

Pending Approval

  • As a Payer Admin, under the Pending Apps tab, you’ll see all applications awaiting your review.

  • For applications belonging to data providers you have approval privileges for, clicking on an entry will display the Registration Details, Approve, and Reject buttons, allowing you to review and take action accordingly.

  • Payer Admins can review each application’s registration details and choose to approve or reject the request.

  • When a Payer Admin approves an application , the application is registered in the data provider’s backend and retrieves the registration credentials. These credentials are then used to authenticate with the data provider when attempting to retrieve data.

  • When a Payer Admin rejects an application, the application is moved to the Rejected tab.

  • The approved application will be added to the master list of approved applications, which is displayed on the APPS page.

Notes:

  • Selecting either to approve or reject will refresh the page and after a few seconds a confirmation message will appear under the navigation bar.

  • An application approval/rejection generates an email notification to the application creator. The email does not contain any identity information about the Payer who approved/rejected the application.

Approved

This section displays applications that have been approved.

  • Payer Admins can view application credentials and revoke application access for any applications created under the data provider(s) for which they have approval privileges.

  • The Application Credentials modal displays Client ID, Client Secret, and other credentials required to connect to OnyxOS APIs.

Note: The Payer Admin can view full application details, but only the client ID is visible. The client secret is not exposed.

Tip: Left-click on any field to copy its value to your clipboard.

Rejected

This section lists applications that were denied approval.

Revoked

This section lists applications whose access was revoked after approval.

Best Practices for Payer Admins

  1. Regularly monitor the Pending Approval tab to avoid processing delays
  2. Keep login credentials secure and do not share them with anyone
  3. Periodically review approved applications for ongoing security compliance
  4. Verify application details thoroughly before approving access
Tags: documentation onyxos