CertMetrics Integration

CertMetrics Eligibility & Results Integration

Overview

The Certiverse–CertMetrics integration lets CertMetrics (CM Connect, operated by Alpine Testing Solutions) stay the system of record for candidates and eligibility, while Certiverse handles exam booking and delivery. Certiverse checks eligibility in CertMetrics in real time when a candidate books, then sends results back to CertMetrics in scheduled batch files.

The integration consists of four components:

CertMetrics then processes the results and updates the candidate's eligibility (for example, closing the current eligibility and opening a retake or recertification window).

Certiverse Configuration

Eligibility is set up by your Organization Admin in two steps: create a CertMetrics connector, then assign it to each store exam. Results delivery is configured by the Certiverse team.

Step 1: Create the CertMetrics eligibility connector

Available to Super Admin, Certiverse Admin, and Organization Admin roles.

1. In the Admin Portal, go to Connectors.
2. Select the CertMetrics tile and click Connect.
3. Click Add Connector
4. Enter a Connector Name. It must be unique within your organization across all providers.
5. Enter the API key issued by CertMetrics/Alpine for your program.
6. Click Validate
7. Save. The connector is created only if the API key is valid.

Once saved, the API key is stored encrypted and can be replaced but never viewed in full. A connector that is assigned to a store exam cannot be deleted.

Step 2: Assign the connector to a store exam

1. Navigate to the Store tab
2. Click EDIT for the desired exam
3. Locate the Eligibility Configuration tab within the Exam
4. Under Eligibility Type, select Certmetrics.
5. Select the Organization Connector you created.
6. Enter the CertMetrics exam code (the course/exam identifier in CertMetrics). It defaults to the store exam code; change it if CertMetrics uses a different code.
7. Click Save.

Several store exams can point to the same CertMetrics exam code. For example, a test center exam and an online proctored exam can share one CertMetrics code. There is no exam code search, so confirm the exact code with your CertMetrics administrator.

Step 3: Results delivery (configured by Certiverse)

CertMetrics Batch Results are set up by the Certiverse team because each program's file mapping is specific to its CertMetrics configuration. To start, send your Certiverse contact:

• SFTP host, port, user ID, and password for the CertMetrics drop location
• Target folder (for example, a To-Alpine/ sub-folder)
• Preferred delivery schedule (for example, daily at 07:00 UTC)
• Any program-specific fields CertMetrics expects (see Results Flow)

The batch result type is then assigned to each exam under Exam Management > Summary > Results Configuration.

Candidate Flow & Eligibility Verification

Candidates start in CertMetrics and are checked for eligibility the moment they select an exam in Certiverse.

1. The candidate logs in to the CertMetrics candidate portal and clicks the exam link.
2. CertMetrics SSO signs the candidate in to Certiverse, passing their CertMetrics candidate ID, first name, last name, and email.
3. Certiverse opens the store exam from the deep link (or the candidate selects it from the org landing page or test center page).
4. Certiverse calls the CertMetrics API with the candidate ID and the store exam's CertMetrics exam code.
5. If the exam code is in the candidate's eligible exam list, booking continues. If not, the candidate sees a Not Eligible message and cannot book.
6. Certiverse stores the CertMetrics exam authorization ID as the booking's eligibility ID.
7. The candidate schedules (or, for unscheduled exams, starts) the exam within the eligibility dates returned by CertMetrics.

The CertMetrics candidate ID is saved as the candidate's Client Candidate ID in Certiverse. It cannot be edited by the candidate, and it is carried through to exam delivery and results so CertMetrics can match the result back to the right record.

Eligibility Flow

CertMetrics owns the eligibility lifecycle; Certiverse reads it at booking and never closes it. Eligibility is updated in CertMetrics only after it processes the results file.

Eligibility dates. If CertMetrics returns a start date, the candidate cannot book or schedule before it. If it returns an end date, the appointment must fall before it, and an unscheduled exam expires no later than that date. If either date is empty, Certiverse applies the store exam's own date rules.

No shows and cancellations release the authorization ID, so the candidate can book again with the same eligibility. Your program can choose whether no shows are also reported to CertMetrics in the results files.

Results Flow

Certiverse sends results to CertMetrics as a set of CSV files in the CM Connect Standard Data Exchange format, uploaded by SFTP on a fixed schedule (typically once a day). Results are not sent in real time.

Each batch file name includes a date and time stamp, down to minutes and seconds, so files never overwrite each other.

Program-specific mapping. Field values such as the scaled score, section IDs (root or leaf topic), and how multiple-response answers are written are agreed with each program and CertMetrics during setup. Changing your exam blueprint or item topics can change what appears in the Section file.

CertMetrics Configuration

Your CertMetrics/Alpine administrator completes these items; Certiverse needs the outputs from each.

SSO

CertMetrics is the OIDC identity provider. Provide Certiverse with the Client ID, Client Secret, and well-known (discovery) URL, and add the Certiverse redirect URI supplied by your Certiverse contact. Each login must pass the CertMetrics candidate ID plus first name, last name, and email.

When a candidate signs in, Certiverse matches accounts in this order:

1. An existing account with the same SSO ID: the candidate is logged in to it.
2. No SSO match, but an account with the same email: the SSO login is linked to that account.
3. No match: a new Certiverse account is created.

The SSO connection is set to store the CertMetrics candidate ID as the Client Candidate ID, which the eligibility check depends on.

Exams and eligibility

• Make sure each exam exists in the CertMetrics exam catalog with an exam code (external ID).
• Share the list of exam codes with the person configuring store exams in Certiverse.
• Issue a CertMetrics API key for Certiverse to use in the eligibility connector.
• Configure your CertMetrics rules for retake and recertification eligibility, since CertMetrics opens new eligibility after it processes results.

Deep links

Add a link to the Certiverse store exam in the CertMetrics candidate portal for each eligible exam. Your Certiverse contact will provide the store exam deep link URL; the candidate is signed in through SSO on the way.

Troubleshooting

Most issues come from a mismatch between the candidate ID or exam code in CertMetrics and what Certiverse sends.

Connector errors (admins). If the connector will not save, the API key is invalid or expired; request a new key from CertMetrics. If a connector cannot be deleted, remove it from every store exam first.

Contact Us

If you have any questions or need additional assistance, please contact us by either emailing support@certiverse.com or by submitting a ticket from this article.

Updated October 13, 2026 17:26