> For the complete documentation index, see [llms.txt](https://docs.wynta.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wynta.com/knowledge-base/affiliate-platform/getting-started-and-configuration.md).

# Getting Started & Configuration

When a workspace is first created, the **Primary Owner** is the first user added to the programme by the Wynta team. The Primary Owner has full access to the workspace and is responsible for completing the initial configuration.

As a first step, configure the **Workspace Settings**, followed by the **Affiliate Platform Settings**, to ensure the programme is correctly set up before users and affiliates begin working with it.

***

## 1. Workspace Settings

Access **Workspace Settings** from the **Workspace** section of the left-hand navigation panel.

Workspace Settings contains the following tabs:

* General
* Products
* Rules & Permissions
* Users
* Connectors
* AI Model

### General

The **General** tab contains your workspace identity and time zone settings.

#### User Avatar

Set your personal workspace avatar by uploading an image.

**Requirements:**

* Minimum dimensions: **200 × 200 pixels**
* Format: **PNG or JPG**
* The image should be square.

#### Workspace Logo

Upload your organisation or workspace logo. For best visibility across the platform, avoid uploading logos that are entirely white.

#### Time Zone

Select the time zone in which your programme operates.

The selected time zone determines when the platform considers a calendar day to begin and end. For example, the programme's daily rollover at midnight will occur according to the configured time zone.

***

### Products

The **Products** tab displays the Wynta products included in your workspace subscription.

You can:

* View the products currently included in your monthly subscription.
* Discover additional Wynta products.
* Access the settings for each subscribed product.

Available products may include **Affiliate Platform, CRM, Gamification, Bonus Engine**, and other products available through Wynta.

Select **Settings** for a product to configure its individual programme settings.

***

### Rules & Permissions

The **Rules & Permissions** tab allows the Primary Owner to control what different user roles can access and perform within the workspace.

#### Standard Roles

Wynta provides the following standard roles:

| Role              | Access Level                                   |
| ----------------- | ---------------------------------------------- |
| **Primary Owner** | Full workspace access                          |
| **Owner**         | Broad access, second only to the Primary Owner |
| **Manager**       | Operational access                             |
| **Analyst**       | Read and export access                         |
| **Viewer**        | Read-only access                               |

You can also create **one custom role** for your workspace.

#### Permissions

Permissions are organised by individual actions within the platform. For example, the Dashboard may have a **View Dashboard** permission.

Each permission can be enabled or disabled for each applicable role using the corresponding toggle.

This allows the Primary Owner to customise access based on the responsibilities of each user. If an action is disabled for a role by default, the Primary Owner can enable it where required.

Certain permissions are restricted to Wynta and cannot be modified by workspace users. These restrictions apply to functions that require backend configuration or could significantly affect the workspace if changed incorrectly.

**Recommendation:** Configure roles and permissions at the beginning of your subscription to ensure that users have the appropriate level of access from the outset.

***

### Users

The **Users** tab provides a centralised list of all users in the workspace.

#### Add a User

Select **Add User** in the top-right corner to create a new workspace user.

Enter:

* First Name
* Last Name
* Email Address

The **email address is mandatory**.

You can then assign the user one of the available roles:

* Owner
* Manager
* Analyst
* Viewer

You can also determine which Wynta products the user can access. Only products included in the workspace's active subscription will be available for selection.

A user can be given access to:

* One product
* Multiple products
* All subscribed products

#### Manage Users

The Users table provides an overview of existing workspace users, including their:

* Name
* Email Address
* Workspace Role

Users can also be **edited or deleted** from this page.

***

### Connectors

The **Connectors** tab allows you to connect external email service providers to your workspace.

Available email connectors include:

* Google
* Mailgun
* SendGrid
* Microsoft Exchange

To configure a connector, select **Connect** next to the relevant provider and enter the required account credentials.

Once the credentials have been entered, you can use **Test Credentials** to verify the connection before saving it.

For example, a Mailgun connection requires:

* Domain
* API Key
* Region — US or EU

Once successfully configured, the connector will display as **Connected**.

#### Manage or Disconnect a Connector

Select **Manage** to update the credentials or account information associated with an existing connection.

You can also disconnect the connector from this screen.

Additional connectors will be made available in future releases.

***

### AI Model

If your subscription includes the **AI add-on**, you can configure your own AI provider for use within the workspace.

Currently supported providers include:

* ChatGPT
* Claude
* Gemini

Select your preferred provider and enter the API key associated with your account.

Once configured, AI-powered functions and features within your workspace will use the selected AI provider and your associated account.

***

## 2. Affiliate Platform Settings

Once your workspace settings are configured, navigate to the **Affiliate Platform** section of the left-hand navigation and select **Settings**.

Affiliate Platform Settings provides the controls required to configure your affiliate programme, including programme information, commissions, reporting, affiliate access, communications, API access, and brand integrations.

The available configuration tabs are:

* General
* Deductions
* Dashboard
* Managed Parameters
* Assign Affiliates
* Registration Fields
* Menu Access
* Email Templates
* API
* Brand Mapping
* Software Provider Authentication

***

## General

The **General** tab contains the core configuration for your affiliate programme.

#### Programme Domain

View the domain associated with your affiliate programme.

#### Programme Description

Add a short description of your programme. This description can be used by Wynta to feature your programme in the **Wynta Marketplace**.

#### Website

Enter the URL of the website you would like affiliates to visit after completing the registration process.

If this field is left blank, the programme's login URL will be displayed on the registration confirmation page instead.

#### Terms & Conditions

Add the URL of your affiliate programme's Terms & Conditions.

Enter the complete URL, including `http://` or `https://`.

Affiliates will be required to accept these Terms & Conditions by selecting the corresponding checkbox during registration.

#### Automatic Affiliate Approval

Enable this option if you want newly registered affiliates to be approved automatically.

By default, affiliates registering for a Wynta Affiliate Platform programme are subject to manual review, after which an administrator can approve, reject, suspend, or assign another applicable status.

When automatic approval is enabled, registered affiliates are approved without manual intervention.

#### Assign Affiliates to Individual Admin Users

Enable this option if specific affiliates need to be assigned to individual admin users.

Once enabled, affiliates can be allocated to specific administrators for dedicated management.

#### Allow Admin Users to View Other Users' Affiliates

When enabled, admin users can view and filter **reports** for affiliates assigned to other admin users.

This permission applies to reporting only. Affiliates assigned to another admin user will not become visible in the **Manage Affiliates** section.

#### Check Campaign Links Every Hour

Enable this option to have Wynta automatically check the health of campaign links every hour.

Campaigns with functioning links will return a successful health status. If a campaign link is not working—for example, because of a broken or invalid link—the campaign will display a failure status on the **Campaign Health**page.

#### Email Notification on Campaign Link Failure

When automatic campaign health checks are enabled, this option allows Wynta to send an email notification to the **Primary Owner** when a campaign link fails a health check.

***

## Languages

Select the languages that should be available across your affiliate programme.

Use the search field to locate a language, select it from the available list, and move it to **Selected Languages** using the right-facing arrow.

The languages selected here will be available across the relevant language dropdowns throughout the programme.

#### Default Language

Select the default language for your programme.

English is selected by default. To use another language as the default, first ensure that it has been added to the list of selected languages.

***

## Countries

Configure the countries that are available throughout your affiliate programme.

Use the search and selection controls to move countries into the selected list.

The countries selected here will be available across the relevant country dropdowns within the programme.

Countries that are not specifically selected will be grouped under **Rest of World**.

***

## Payment Settings

Payment settings determine how affiliate payments are calculated and which payment methods are available within the programme.

### Payment Cycle

Choose the payment cycle that applies to your programme.

#### Weekly

Payments are calculated every **7 days**.

You must select the day on which each payment cycle ends.

For example, if Friday is selected, the payment report will cover the period from the previous Friday through Thursday.

#### Biweekly

Payments are calculated every **14 days**.

You must select:

* The day of the week on which the cycle ends
* The date of the first payout

The initial cycle begins on the first day of the current month and ends on the selected date. Subsequent payment cycles occur every two weeks on the selected day.

#### Semi-Monthly

Payments are calculated twice per month:

* First cycle: 1st–15th
* Second cycle: 16th–last day of the month

#### Monthly

Monthly is the **default payment cycle**.

The payment period runs from the first through the last day of each month. Payment reports become available for viewing on the **3rd day of the following month**.

> **Important:** Once the payment cycle has been selected, this setting is permanent.

### Payment Methods

Select the payment methods that affiliates can use to provide their payment details.

Enable the methods you support and disable those that are not applicable.

If your programme requires an additional region-specific payment method that is not available, contact the Wynta Support team.

### Minimum Payout

Set the minimum payout amount for each enabled payment method.

If an affiliate's balance does not reach the configured minimum payout, the balance is carried forward to the next payment period.

The payment report will indicate when an affiliate has reached the minimum threshold and is eligible for payment. Until then, the balance will be recommended for carry-over.

Refer to **Payment Reports** for further information about payment calculations and reporting.

### Tax

Enter the applicable tax percentage if tax deductions apply to your programme.

***

## KYC

The **KYC** section allows you to define the documents affiliates must provide for verification.

Default document types include:

#### Companies

* Certificate of Incorporation
* Bank Statement
* Passport

#### Individuals

* Passport
* Bank Statement
* National Identity Card (NIC)

If your programme requires region-specific KYC documents, contact Wynta Support to have the required document types added.

***

## Deductions

The **Deductions** tab provides a list of deductions configured for your programme.

Select **Add Deduction** to create a new deduction.

You can configure:

* Point of Consumption Tax (POCT)
* Administrative Fee
* Percentage
* Applicable brand
* Applicable countries
* Start Date
* End Date
* Deduction level

Deductions can be applied at different levels, including:

* Product
* Brand
* Product + Brand
* Affiliate
* Affiliate + Product
* Affiliate + Brand
* Affiliate + Brand + Product

If no start or end date is specified, the deduction becomes effective when submitted and remains active indefinitely.

#### POCT

Point of Consumption Tax (POCT) is a deduction applied by the relevant gambling commission or licensing authority.

The percentage entered here is deducted from the revenue share amount configured for the programme.

The deduction can also be excluded at the commission level by disabling the relevant option on the **Commissions**page.

#### Administrative Fee

Configure a standard administrative fee deduction as required by the operator.

Enter the percentage to be deducted from the revenue displayed in the programme.

If no administrative fee applies, leave the field blank.

***

## Dashboard

The **Dashboard** settings tab allows you to control which widgets and metrics are displayed on the Affiliate Platform Dashboard.

Each available widget can be individually enabled or disabled. Select the relevant checkbox to determine which information should appear on the Dashboard.

Available Dashboard components include:

* Quick Stats and its individual metrics
* Brand Statistics
* User Acquisition Trend
* Top 5 Affiliates
* Expiring Commissions
* Get Code
* Top 5 Campaigns
* Conversion Rate
* Traffic Source Split
* Top Depositors
* Pending Affiliates
* Affiliate Status

This allows each programme to tailor the Dashboard to the information most relevant to its operational requirements.

***

## Managed Parameters

The **Managed Parameters** tab allows you to configure the tracking parameters used by your affiliate programme.

Select the relevant **software provider** to view the standard parameters configured during integration.

Additional parameters can be enabled where required. Selected parameters are incorporated into the relevant redirection or tracking links.

To create a new parameter, select the **+** button and enter the parameter name when prompted.

***

## Assign Affiliates

The **Assign Affiliates** tab is available when **Assign Affiliates to Individual Admin Users** has been enabled in the General settings.

To assign affiliates:

1. Select an admin user from the dropdown.
2. Select the required affiliates from the available list.
3. Use the right-facing arrow to move them into **Selected Affiliates**.
4. Select **Submit** to save the assignment.

This allows individual admin users to manage designated affiliate portfolios.

***

## Registration Fields

The **Registration Fields** tab controls the information displayed on the affiliate registration page.

You can choose which fields affiliates are required to complete by enabling or disabling the relevant options.

Available information categories include:

#### Account Login Details

* First Name
* Last Name
* Account credentials

#### Profile Details

* Address
* Date of Birth
* Communications ID / Chat ID

#### Payment Details

Payment fields corresponding to the payment methods configured for the programme can be enabled as required.

#### Contact Information

* Email
* Phone
* Instant Messaging (IM)

#### Wynta Communications Consent

You can also enable consent options for Wynta communications, including **Marketplace and Product Updates**.

When selected, affiliates can opt in to receive relevant communications from Wynta about marketplace opportunities and product updates.

***

## Menu Access

The **Menu Access** tab controls which sections of the Affiliate Platform are visible to affiliates within their accounts.

You can control access to areas including:

* Dashboard
* Campaigns
* Reports
* Earnings Reports
* Player Reports
* Payment Reports
* Refer an Affiliate
* Marketplace
* Logs

Individual permissions and parameters within each section can also be controlled.

For example, an administrator may enable access to the **Reports** section while disabling selected report types or individual parameters that should not be visible to affiliates.

This provides granular control over the information and functionality available within the affiliate portal.

***

## Email Templates

The **Email Templates** tab allows you to configure the automated emails sent by your affiliate programme.

Templates can be configured for different event triggers, including:

* Password resets
* Affiliate approval
* Affiliate rejection
* Payment updates
* Other supported system events

Select the relevant event trigger and configure the:

* Subject
* CC recipients
* BCC recipients
* Email message

Use commas to separate multiple email addresses in the CC and BCC fields.

**Placeholders** available below the message editor can be inserted into the email to automatically populate dynamic information from the system.

***

## API

The **API** tab provides access to the API endpoint and authentication credentials required to expose affiliate and commission data outside the Wynta platform.

The page displays the relevant **Commission Details endpoint**, which can be copied for use in your integration.

#### X-API-Key

The X-API-Key is passed in the `X-API-Key` header of API requests.

To generate a key, select **Generate**.

Use **Refresh** to rotate the existing key. When a key is rotated, the previous key stops working immediately.

You can also temporarily deny or allow API access without rotating the key.

> **Important:** Enabling API access makes the programme's affiliate and commission data accessible outside the Wynta platform. Ensure that API credentials are stored and managed securely.

***

## Brand Mapping

The **Brand Mapping** tab lists the brands configured within your affiliate programme.

To add a new brand, select **Add Brand Mapping**.

Enter the following information:

#### Software Provider

Select the software provider associated with the brand from the list of providers integrated with Wynta.

#### Site Name

Enter the name by which the site should be displayed across Wynta.

For example, if the website is `mycasino.com`, enter **My Casino**.

#### Domain

Enter the domain of the website being mapped.

For example:

`www.mycasino.com`

#### Brand Logo

Upload the brand logo to be displayed in thumbnails and other applicable areas.

**Requirements:**

* JPG, PNG, or GIF
* **120 × 60 pixels**

#### Redirection Link

Enter the redirection link provided by your software provider.

This is the URL used to redirect Wynta tracking links when players click them.

The correct redirection URL should be available in the technical documentation provided by your software provider. If you cannot locate it, contact your software provider.

#### Currency

Select the currency in which the software provider sends financial data for this brand.

***

## Software Provider Authentication

After completing the **Brand Mapping** configuration, use the **Software Provider Authentication** tab to configure the authentication credentials required to connect Wynta with your software provider.

Select **Add Software Provider Authentication** in the top-right corner.

Then:

1. Select the software provider.
2. Select the relevant brand.
3. Enter the authentication details provided by your software provider.
4. Save the configuration.

The authentication fields displayed will vary depending on the selected software provider. Use the credentials and information supplied by the provider to complete the integration.
