> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SellAuth Payment Automation

> Accept more crypto coins with your SellAuth shop in about 5 minutes with NowPayments, Heleket or Cryptomus.

Want to take more crypto payments in your SellAuth shop? You can set it up yourself in about **5 minutes**. You don't need a server and you don't write any code. You fill in one short form, and I run your checkout and keep it online.

* A **crypto checkout page** for your SellAuth shop
* Your choice of **Heleket, Cryptomus or NowPayments**
* **One processor at a time**. Switch to another one whenever you like.
* A simple dashboard with your status and **live logs**

![License page showing a running processor, the license details and the pay and webhook URLs](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

Your checkout is live: running status and your two URLs

## It takes 3 steps

**1. Get your license**

Buy a license. You receive a key that looks like `ECHO-XXXX-XXXX-XXXX-XXXX`.

**2. Create your account and connect a processor**

Register with your key, pick a processor and fill in one form.

**3. Paste 2 URLs. Done.**

Copy your pay URL into SellAuth and your webhook URL into your processor. Your shop now accepts crypto.

> [!TIP]
>
> Jump to: [Create your account](#1-create-your-account), [Connect a processor](#2-connect-a-processor), [Your two URLs](#3-your-two-urls-and-test-payment), [Switch processor](#4-switch-processor), [Add another license](#5-add-another-license), [Renewals](#6-renewals-and-expiry), [FAQ](#faq).

## What you need

> [!NOTE]
>
> **Have these ready:**
>
> * Your **license key** from your purchase
> * Your **SellAuth shop ID** and a **SellAuth API key**
> * An account at **Heleket, Cryptomus or NowPayments**, with its API credentials

> [!NOTE]
>
> The screenshots use fake example data (shop ID `12345`, keys like `test-api-key-xxxx`). Use your own values and never share them.

## 1. Create your account

**1. Open the register page**

Open the register page of your dashboard. Already registered? Click **Sign in** instead.

**2. Fill in the form**

Choose a username, add your email and pick a password with at least 10 characters. Paste your license key at the bottom, then click **Create account**.

![Create your account form with username, email, password and a placeholder license key](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

Register with your license key (the key shown here is a placeholder)

**3. You are in**

You are signed in right away. Your license is active and your time starts now.

> [!WARNING]
>
> Each key works only **once**. If you see "This license key is invalid or has already been used", check the key for typos. If it still fails, ask support. Keep your key private.

## 2. Connect a processor

A processor is the service that handles the crypto payment. Pick **one**. You can switch later.

**1. Open your license**

Click **Licenses** at the top, then your license, then **Set up processor**.

**2. Choose a processor**

![Choose a processor page listing Heleket, Cryptomus and NowPayments](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-12-swap-pick.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=37c8d5376e810510e3154b83a831249d)

Pick NowPayments, Heleket or Cryptomus

**3. Fill in the form**

Every form asks for your **SellAuth shop ID**, your **SellAuth API key** (Required Scopes: Invoice Read, Update, Process)\*\* \*\*and the credentials of your processor. See the tab below.

**4. Click the green button**

Setup takes up to a minute. Keep the page open until it finishes. Then you see your status and your two URLs.

> [tab] NowPayments
>
> You need your **NowPayments API key** and **NowPayments IPN secret**.
>
> ![NowPayments setup form with shop ID, SellAuth API key, NowPayments API key and IPN secret](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-07-form-nowpayments.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=39fed9e70b8671401993c77d8b68de88)
>
> NowPayments setup form

> [tab] Heleket
>
> You need your **Heleket API key** and **Heleket merchant ID**.
>
> ![Heleket setup form with shop ID, SellAuth API key, Heleket API key and merchant ID](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-05-form-heleket.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=bc33047c3633b689a025a94a80352bad)
>
> Heleket setup form

> [tab] Cryptomus
>
> You need your **Cryptomus API key** and **Cryptomus merchant ID**.
>
> ![Cryptomus setup form with shop ID, SellAuth API key, Cryptomus API key and merchant ID](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-06-form-cryptomus.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=be948733d2644f3232a5e31bb93118e2)
>
> Cryptomus setup form

> [!NOTE]
>
> Find your API credentials in your processor's own dashboard. Menu names can look different from time to time. The SellAuth shop ID is **locked to your license** after the first setup, so use the shop you really want to sell on.

> [!WARNING]
>
> **Common mistakes:** a typo in the SellAuth API key or shop ID, mixing up the API key and the merchant ID (or IPN secret), and spaces copied at the start or end of a key. If setup fails you see a red message and the form keeps what you typed. Enter your secret keys again.
>
> ![Setup form with a red error message about the SellAuth shop key](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> Example error: the SellAuth key was wrong

## 3. Your two URLs and test payment

This is the last step. Your license page shows **two URLs**. Each one goes in a different place.

![Your URLs card with a pay URL and a webhook URL, each with a Copy button](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

Use the Copy buttons

| URL | What it does | Where to paste it |
| - | - | - |
| **Pay URL** | Sends your buyer to the crypto checkout. | SellAuth, as the redirect URL of the payment method |
| **Webhook URL** | Tells the processor when a payment is done, so the order is marked as paid. | Your processor's dashboard, as the callback or IPN URL |

**1. Paste the pay URL into SellAuth**

Click **Copy** next to **Pay URL**. In SellAuth, open your payment methods and set the redirect URL to it. Your dashboard says: *SellAuth, Payment methods, redirect URL*.

**2. Paste the webhook URL into your processor**

Click **Copy** next to **Webhook URL**. In your processor's dashboard, set the callback or IPN URL to it. Your dashboard says for example: *NowPayments dashboard, callback / IPN URL*.

**3. Check the status**

The processor card on your license page shows a green **running** badge.

![Active processor card with a green running badge and the Swap processor, Start, Stop and Restart buttons](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

A running processor

**4. Make a small test order**

Buy one of your own products with crypto, with a small amount. Scroll to **Logs** on your license page. New lines appear live when a payment request comes in. After the payment is confirmed, the order is marked as paid and delivered.

> [!NOTE]
>
> Menu names in SellAuth and in your processor's dashboard may look slightly different from what is written here. Look for the redirect URL and the callback or IPN URL.

> [!WARNING]
>
> Keep `{unique_id}` **exactly as written** in the pay URL. SellAuth fills it in for every order.

If something seems stuck, try **Restart** on your license page first.

## 4. Switch processor

You can use **one processor at a time** per license and switch whenever you want, for example from NowPayments to Heleket.

* **Stays the same:** your license, your expiry date, your SellAuth shop ID and key.
* **Changes:** you enter the credentials of the new processor, and you get **new URLs** to paste again.

**1. Click Swap processor**

Open your license, click **Swap processor** and pick the new one.

**2. Fill in the new form**

The form warns you that your current checkout stops when the new one is live. Enter the new credentials and tick the box to confirm.

![Heleket setup form with a swap warning and a confirmation checkbox](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

Swapping from NowPayments to Heleket

**3. Paste the new URLs**

You see *Swap complete*. Update the redirect URL in SellAuth and the callback or IPN URL in the new processor.

> [!WARNING]
>
> After a swap, the **old URLs stop working right away**. Update SellAuth quickly so buyers do not hit a dead link.

> [!TIP]
>
> It is safe. The new checkout starts first and has to work before anything changes. If the swap fails, you see a message that your old checkout **is still active**. Nothing is lost. Fix the problem and try again.

## 5. Add another license

Each license gives you **one processor slot**. Add another license for a **second SellAuth shop** or a **second processor** at the same time.

**1. Click Add license**

Use **Add license** in the top menu. Paste the new key and choose **Add as new license**.

![Add license form with a placeholder key and options to add as new license or extend an existing one](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

Add a license (placeholder key)

**2. Set it up**

Your dashboard lists every license with its own status and expiry date. Open the new one and connect a processor. Each license has its own shop and its own URLs.

![Dashboard listing two crypto licenses with status and expiry](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

Dashboard with several licenses

Today licenses are for **crypto** payments. Other categories, like skins and card payments, are shown as **coming soon** and can't be used yet.

## 6. Renewals and expiry

Licenses come in **1, 3, 6 or 12 months**. The time starts when **you register or redeem the key**, not when you buy it. You get **2 bonus days** on top of every redemption, for setup and testing. Your expiry date is shown at the top of your license page and in your dashboard.

When a license expires:

* Your checkout **pauses**. Buyers can't pay with crypto until you renew.
* **Nothing is deleted.** Your settings and logs are kept.

![License page with an expired badge and a message to redeem a renewal key](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

An expired license with a renewal prompt

**1. Get a renewal key**

Buy a new license key.

**2. Redeem it**

Click **Redeem a renewal key**, or **Extend with a new key** on your license page, and paste the key.

**3. Done**

Your license is active again and your checkout starts again. Your URLs stay the same.

> [!TIP]
>
> You can renew **before** it expires. The new time is added to your current end date, so you lose nothing.

> [!WARNING]
>
> Treat a license key like a password. Don't post it in public. Your dashboard shows only the last 4 characters. You can change your password under **Settings**.

## FAQ

> [accordion] My license key is invalid or already used
>
> Check for typos and extra spaces. Each key works **once**. If you already registered with it, sign in instead. If you are sure it is new, ask Echo.

> [accordion] Setup shows a red error
>
> Most often a wrong SellAuth API key, shop ID or processor credentials. Check each field, remove spaces and try again. The form shows the last log lines of the failed attempt to help.

> [accordion] The order stays unpaid after the buyer paid
>
> Check the **webhook URL** in your processor's dashboard. It must be exactly the one on your license page. Then look at the **Logs** on your license page for errors.

> [accordion] Buyers land on an error page at checkout
>
> Check the **redirect URL** in SellAuth. It must be your pay URL, with `{unique_id}` kept as written. Also check that your license is active and the badge says **running**.

> [accordion] I switched processors and checkout stopped
>
> Paste the **new URLs** after a swap. The old ones stop working.

> [accordion] My swap failed
>
> Your old setup is **kept and still active**. Read the red message, fix the credentials and try again.

> [accordion] I can't sign in
>
> After several wrong passwords you are blocked for a while. **Wait about 15 minutes** and try again. Check your username or email.

> [accordion] I see a message to try again later
>
> There is a limit on how often you can set up, swap or change credentials per hour. Wait a bit and try again.

> [accordion] I want to change my SellAuth shop
>
> The shop is locked to the license after the first setup. Ask support to change it, or use another license for the other shop.

> [accordion] I forgot my password
>
> No email is sent. Ask support for a password reset. You can change your password later in **Settings**.

> [accordion] My license expired
>
> Your checkout is paused and nothing is lost. Redeem a renewal key. See [Renewals and expiry](#6-renewals-and-expiry).

Still stuck? Open a ticket in my [support server](https://discord.echoauth.dev).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.