# RealtimeRegister

https://docs.wisecp.com/fr/realtimeregister

Connect RealtimeRegister to bring domain costs, existing domains and service management into WISECP.

## Access the Screen

Open **Products → Domains → Domain Name Registrars → All Modules → RealtimeRegister**: `{admin}/module/registrars?module=RealtimeRegister`.

## What Is on the Screen

**Module Settings** contains account, nameserver and pricing options. **Import** lists existing domains. **Import Extensions** retrieves extension costs.

### Prepare the API Account

1. In the provider portal, open **Account details → Users**. Create a dedicated API user and assign roles for domains, contacts, hosts, DNS templates and price information.
2. Generate its API key from the user page or your profile. Store the key securely when shown. See [Access and Authentication](https://dm.realtimeregister.com/docs/api/access).
3. If using an IP whitelist, allow the WISECP server's outgoing IP. Review [user permissions](https://kb.realtimeregister.com/article/23-users); API keys support users with MFA.
4. Confirm your customer handle and balance. Request a separate OT&E account for provider testing; production credentials and domain data are separate.

## Settings

- ****Customer****: Required for customer-specific operations; initially empty. Enter the customer handle, not your user's login name.
- ****API Key****: Required; initially empty. Key belonging to your authorized API user.
- ****Default Nameservers****: Four initially empty fields; the first two have required markers. Use ns1.yoursrs.com and ns2.yoursrs.com for the module's DNS template path.
- ****Automatic Cost Updates****: Disabled by default. Daily updates can also calculate selling prices from your configured profit rate.
- ****Cost Currency****: Review the selected system currency before importing. The module converts provider costs into this currency.

## Tasks

### Connect and Check Access

1. Enter **Customer** and **API Key** in **Module Settings**. The supplied configuration uses the live api.yoursrs.com/v2/ service.
2. Click **Test Connection** at the bottom. This reads the domain list without purchasing; it does not verify customer-specific price or write permissions.
3. Click **Save Changes**, then reopen the form. No separate WISECP server record is required.
4. Keep sales disabled until service operations are verified. This form has no test switch: entering an OT&E key alone does not select api.yoursrs-ote.com.

### Import and Assign Extensions

1. Open **Import Extensions**, review costs, select rows and click **Import**. Existing prices can change; verify each result before enabling sales.
2. Under **Products → Domains**, select **RealtimeRegister** in the extension's **Registrar** field. Click **Update Extensions**.
3. Open the row's **Pricing** window and review periods, currency and selling prices. Click **Save Changes**.

Costs include registration, renewal and transfer. Effective price changes and active promotions can replace the base cost. Check promotion expiry and your profit rate before enabling automatic updates.

### Import Existing Domains

In **Import**, find a domain, assign its customer and click **Import**. Define its extension first. Confirm the resulting service, contacts and dates. This creates a local service without transferring the domain. The module fetches only the first 250 domains; local pagination does not retrieve the rest.

### Manage Domains and DNS

Registration, incoming transfer, renewal and synchronization are implemented. Registration periods are sent as months; transfer periods follow registry rules. Complete extension-specific contact requirements. New registrations and transfers disable provider auto-renewal, so renew through WISECP on time.

Open the domain under **Orders → Services**. **DNS** offers nameservers, IPv4 child nameservers and DNS template records. Changing a child nameserver deletes and recreates its host; check dependencies first.

Provider DNS requires a template linked to the domain. When ns1.yoursrs.com is selected, the module can create one automatically. Its initial A record points to 127.0.0.1; replace the sample A, MX, CNAME and SPF contents before using the domain.

DNS edits replace the template's records and can affect other domains sharing it. New records with a missing TTL or a TTL below 3600 use 7207 seconds. Priority applies to MX and SRV. Editing does not change a record's type.

**WHOIS** provides contact and supported privacy changes. Shared contacts affect other domains. **Transfer** offers locking and **Get Transfer (EPP) Code**. Customer controls depend on permissions and active addons.

Dedicated URL/email forwarding, DNSSEC and restore operations are not implemented here. URL/MBOXFW record types in the DNS list are provider-specific records, not separate forwarding controls. Verify pending transfer status in the provider portal.

## Things to Consider

> **Charges and Premium Prices**
> 
> Live registration, transfer and renewal can incur charges. Premium availability prices are returned in cents, but this module passes the amount without conversion. Do not rely on that price for billing; confirm premium acquisition and renewal costs with the provider.

> **Troubleshooting**
> 
> Check the environment, API user roles, IP whitelist and customer handle. A successful list test does not validate all permissions. Check templates when DNS is empty, and review registry status before treating a synchronized transfer as complete.

## Required Permissions

Setup requires **Domain Name Registrars** permission. Service actions require their corresponding permissions.

## Related Guides

- [Registrar Configuration](https://docs.wisecp.com/en/registrar-modules)
- [Domain Extensions](https://docs.wisecp.com/en/domain-extensions-and-pricing)
- [Service DNS Management](https://docs.wisecp.com/en/service-dns-management)
- [Service WHOIS Records](https://docs.wisecp.com/en/service-whois-records)
- [Service Transfer](https://docs.wisecp.com/en/service-transfer)