# References

## What Are References?

In Payrexx, a reference is a code that serves two purposes: it enables tracking of merchant signups and, if desired, can be used as a discount code to offer merchants subscriptions at a reduced price.

## Overview of References

If you have already created reference codes, you can find them in your platform administration under **Referrals**.

<div align="left"><figure><img src="https://13947520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McKWr2N1ZENCggMlAH5%2Fuploads%2F73JzRgg1fcheJnF6kfw2%2Fimage.png?alt=media&#x26;token=661e80fe-c384-4f28-b422-da5bcbaea587" alt=""><figcaption><p>Overview of created reference codes in Payrexx</p></figcaption></figure></div>

#### 1. Finding references

To find a reference code, you can use the filter function to narrow search results by specific channels. Additionally, you can search for a specific code using the search field.

#### 2. List of created reference codes

Below is the list of already created reference codes. The following information is displayed:

* **Status**: Active (the code is valid) or inactive (the code is not valid)
* **Signups**: Number of merchants who have registered on the platform using the respective code
* **Sales**: Number of purchased and paid plans associated with the reference code
* **Validity**: Validity of the reference code (either unlimited or with an expiration date)
* **Discount**: Discount applied to the purchase of a plan

## Managing Reference Codes

In the following sections, you will learn how to [create](#creating-a-reference-code), [edit](#editing-a-reference-code), and [delete](#deleting-a-reference-code) reference codes.

### Creating a reference code

To create a reference code, click the green "Add" button at the top of the window and fill in the fields accordingly:

<div align="left"><figure><img src="https://13947520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McKWr2N1ZENCggMlAH5%2Fuploads%2FLheQZYfjlTZzhm5knAWl%2Fimage.png?alt=media&#x26;token=99fb127f-9769-4ba6-9198-0bc65528aa86" alt=""><figcaption><p>Creating a reference code in Payrexx</p></figcaption></figure></div>

#### 1. Status

Set whether the reference code is active or inactive.

#### 2. Reference code

Choose any name for the reference code. This name will be part of the URL you use in the respective campaign to enable tracking. Example:

* Discount code: ***test***
* URL: [https://signup.your-domain.com/?ref=***test***](https://signup.your-domain.com/?ref=test)

#### 3. Channel

Select a channel from the list to assign the reference code to a specific campaign or medium, enabling tracking.

#### 4. Comments

Describe the purpose of the reference code.

#### 5. Discount (Yes/No)

Specify whether merchants will receive a discount when registering using the reference code.

#### 6. Discount percentage

Enter the discount percentage if you selected "Yes" in the previous step. Please note that the discount cannot be changed after the reference code has been saved.

### Restrictions

#### 7. Expiration date

Leave this field empty to create a reference code with unlimited validity, or set an expiration date to limit its validity period.

#### 8. Products

Here you can select which products will be displayed during registration via your reference code. If you enable the toggle, the selected product will automatically be assigned to the registering merchant.

<div align="left"><figure><img src="https://13947520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McKWr2N1ZENCggMlAH5%2Fuploads%2FS8iUihhtjYg1wTSto5gN%2Fimage.png?alt=media&#x26;token=79b2a713-c6ab-4b4b-ab37-7c62c2d86818" alt=""><figcaption><p>Toggle activated</p></figcaption></figure></div>

### Editing a reference code

To edit a reference code, hover over the desired row and click on the "Edit" icon:

<div align="left"><figure><img src="https://13947520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McKWr2N1ZENCggMlAH5%2Fuploads%2FWgYoPbqrHsss8zby2ZcM%2Fimage.png?alt=media&#x26;token=ce897a28-7ed9-4540-a61e-343718f61dba" alt=""><figcaption><p>Editing a reference code in Payrexx</p></figcaption></figure></div>

### Deleting a reference code

To delete a reference code, hover over the desired row and click on the "Delete" icon:

<div align="left"><figure><img src="https://13947520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McKWr2N1ZENCggMlAH5%2Fuploads%2F8MAleEpJdt3eq3DI4Hba%2Fimage.png?alt=media&#x26;token=e1b07cfb-712b-4c0f-999f-f0a219e1f8d1" alt=""><figcaption><p>Deleting a reference code in Payrexx</p></figcaption></figure></div>

## How to Use Reference Codes

To use a reference code, click on the link next to the corresponding code in the [overview](#overview-of-references):

<div align="left"><figure><img src="https://13947520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McKWr2N1ZENCggMlAH5%2Fuploads%2F8BCdDT0jQZuZFsomQqsV%2Fimage.png?alt=media&#x26;token=7c5db2c6-0bf9-45bc-89d4-d285bb064b1a" alt=""><figcaption><p>Opening the link to the signup page including the reference code in the URL</p></figcaption></figure></div>

The registration page will open with the reference code included in the URL, ensuring that the merchant’s signup is attributed to the reference code and, consequently, to the assigned channel: <https://signup.your-domain.com/en?ref=test>

If a discount is linked to the reference code, it will be applied automatically. The discount takes effect as soon as the new merchant selects a plan or – in the case of a single product – adds it directly.

<div align="left"><figure><img src="https://13947520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McKWr2N1ZENCggMlAH5%2Fuploads%2FNJNU003V5jdctNW6Vxfb%2Fimage.png?alt=media&#x26;token=4978ccf3-fff5-43a3-b7f3-080d74d0bc34" alt="" width="563"><figcaption><p>The registration page where the merchant chooses their email address and instance name</p></figcaption></figure></div>

Links generated in this way can be used in all your campaigns to track and measure their success.
