# Realtime Register SSL

https://docs.wisecp.com/en/realtime-register-ssl-module

Connect your Realtime Register account to sell its SSL certificates with automatic ordering and margin-based prices.

## Accessing the Screen

Go to **Products → Product Group Modules**, open **All Modules** and click the **Realtime Register SSL** card. Address: `{admin}/modules/product?module=RealtimeRegisterSSL`.

## Screen Overview

- **Settings**: Customer handle, API key, the OT&E switch and the connection test.
- **Catalog**: Creates products from the Realtime Register certificate catalog and keeps their prices current.
- **Import**: Links a certificate already issued at Realtime Register to a client as a service.

### Before You Start

Create an API key under Settings in your Realtime Register account. Note the customer handle your certificates are billed to, as shown in the control panel. Prices come from that customer's price list. This module is configured separately from the Realtime Register domain module.

## Settings Fields

- **Customer Handle**: Required. The customer handle your certificates are billed to.
- **API Key**: Required. Saved encrypted and shown masked. Leave it blank to keep the saved key.
- **OT&E Mode**: On by default. Orders go to the OT&E test environment. Turn it off only when you are ready to place billable orders.

## Tasks

### Connecting the Account

1. On the **Settings** tab, enter **Customer Handle** and **API Key**. Set **OT&E Mode** for that account.
2. Click **Test Connection**. It checks the API key from the form against the selected environment, without saving it.
3. Click **Save Changes** below the form. A confirmation message appears.

The test needs both values but verifies only the API key. The customer handle is checked when you import the catalog.

### Importing the Catalog

1. Save the settings first: the catalog uses the saved customer handle and key, not the form.
2. Open the **Catalog** tab and enter **Profit Margin (%)**. The default is 30.
3. Click **Import Catalog**. The message counts the products created and those that already existed.

When nothing can be imported, the message gives the reason. The customer handle may be missing or unknown, the account may offer no certificates, or its price list may have no prices for them.

The import creates the SSL Certificates category with DV, OV and EV subcategories. It also adds the order requirements, such as the CSR code and validation method. Certificates with SAN pricing get an **Additional SANs** add-on. Running it again only adds what is missing. Terms longer than three years are skipped.

### Keeping Prices Current

Click **Sync Prices** to reread the costs and reapply the margin to imported products and SAN add-ons. Turn on **Automatic Price Update** to repeat this every day through scheduled tasks.

### Importing an Existing Certificate

1. Open the **Import** tab. It requires at least one product that uses this module.
2. Enter the **Certificate ID** shown in your Realtime Register account. Choose **Client**, **Product** and **Billing Cycle**.
3. Click **Import**. The certificate becomes a service of that client.

### Products and the Client Area

Each product sells one certificate. On the product's **Automation** tab, **Module Configuration** holds **Realtime Register Certificate** and **Included SANs**. Imported products have **Automatic Setup** on, so a paid order is placed at Realtime Register without approval.

In the client area, the customer can reissue the certificate, resend or change domain validation, add or remove SANs and download the certificate. The service page shows **Certificate ID** and **Process ID**; validation details are read from the process.

## Important Notes

> **Live Orders Are Billed**
> 
> With OT&E Mode off, every paid order places a billable order at Realtime Register. Imported products are active and visible at once, so import into the live account when prices are ready.

> **Prices and Currency**
> 
> Costs and sale prices are saved in the currency of your Realtime Register price list. Keep its exchange rate current. If WISECP has no such currency, the amounts are saved in your default currency without conversion.

> **Suspension**
> 
> Suspending a service changes its status in WISECP only. The certificate stays valid at Realtime Register.

## Required Permissions

Requires **PRODUCTS_API** to open and configure the module.

## Related Articles

- [Product](https://docs.wisecp.com/en/product-modules)
- [Product Automation](https://docs.wisecp.com/en/product-automation)
- [Currencies](https://docs.wisecp.com/en/currencies)
- [RealtimeRegister](https://docs.wisecp.com/en/realtimeregister)