Merchant Setup

How to configure your merchant at 0xpay.app before integration

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 with 0xpay first.

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.

Merchant creation form

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.

• Email for notifications - used to notify you about your merchant's activities: replenishments, withdrawal transactions.

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 notifiers.

Setting up Merchant

Prior to the integration, you should configure your merchant properly. You can access merchant settings through your merchant list.

Settings button on merchants list

Getting API Key

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.

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.

API Keys tab

Let's detail the fields above:

• Merchant ID – your merchant identifier, which is used in Merchant API for identification.

• Private key – used for authorization in Merchant API.

Receiving notifications

You won't receive any callback notifications until the Notifications URL field is set.

Notifications tab

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