# Merchant Setup

{% hint style="info" %}
**Merchant** is an entity that represents a **store** in our system, it can be your **online goods shop, trading platform, exchange, etc.** 

To start using merchants, you have to create a [personal account](https://docs.0xpay.app/integration-cookbook/getting-started/broken-reference) with 0xpay first.
{% endhint %}

In this section we provide details regarding the available Merchant features, operational workflow and service fees, alongside with info on how to set up your Merchant for integration on your website.

## Creating a Merchant

To start integration, you have to create a merchant at the [merchants' page](https://my.0xpay.app/merchants).

<div align="center"><img src="https://2737865518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbNCo9robuqu6TlFzrmb0%2Fuploads%2FLyU4y3lOAaYQtVHPdhnZ%2Fimage.png?alt=media&#x26;token=a0565e4e-1a51-4e70-a9a3-930a7b85ff4b" alt="Merchant creation form"></div>

> Let's describe the fields above:
>
> * **Merchant name** – description field, it can be the shop's name or anything that fits you.
> * **Company name** – regulatory field, this field has to match your company name.
> * **Domain** – used to verify your website, **cannot be changed later**.&#x20;
> * **Email for notifications** - used to notify you about your merchant's activities: replenishments, withdrawal transactions.

{% hint style="warning" %}
The **Domain** field cannot be changed later, so pay attention when entering your website info into it. Also, this domain will be used in [webhook](https://docs.0xpay.app/public-api/notifications) notifiers.
{% endhint %}

## Setting up Merchant

Prior to the integration, you should configure your merchant properly. You can access merchant settings through your [merchant list](https://my.0xpay.app/merchants).

![Settings button on merchants list](https://2737865518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbNCo9robuqu6TlFzrmb0%2Fuploads%2Fa38Eo1kqQKuCRx8fbMSN%2FScreenshot%202022-05-11%20at%201.03.25%20PM.png?alt=media\&token=7c376f3e-1c9f-47e6-a2b0-d1b2035142c3)

## Getting API Key <a href="#api-keys" id="api-keys"></a>

Sending requests to 0xpay API through a merchant requires authorisation with API keys. They are used for two purposes:

* Sending requests to 0xpay API.
* Verifying server-side notifications.

{% hint style="danger" %}
**DO NOT SHARE YOUR API KEYS!** API key grant access to manage funds within your 0xpay Merchant, hence the person with keys may transfer funds to any external addresses.
{% endhint %}

![API Keys tab](https://2737865518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbNCo9robuqu6TlFzrmb0%2Fuploads%2FX8UUeACLQ6WcXkh2m46T%2FScreenshot%202022-05-11%20at%203.44.19%20PM.png?alt=media\&token=48e82819-f5dc-4293-84c1-f7a8d0689050)

> Let's detail the fields above:
>
> * **Merchant ID** – your merchant identifier, which is used in [Merchant API](https://docs.0xpay.app/public-api) for identification.
> * **Private key** – used for [authorization](https://docs.0xpay.app/integration-cookbook/getting-started/broken-reference) in [Merchant API](https://docs.0xpay.app/public-api).&#x20;

## Receiving notifications

{% hint style="warning" %}
You won't receive any callback notifications until the **Notifications URL** field is set.
{% endhint %}

![Notifications tab](https://2737865518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbNCo9robuqu6TlFzrmb0%2Fuploads%2FEoDycPF6yQSFYF7Jndgg%2FScreenshot%202022-05-11%20at%203.51.11%20PM.png?alt=media\&token=33b91f10-2e0c-45ea-a81b-b03c34e66e74)

You have to specify the **Notifications URL** to start receiving notifications about your incoming and outgoing payments.