> ## 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 支付自动化

> 通过 NowPayments、Heleket 或 Cryptomus，约 5 分钟即可让你的 SellAuth 店铺接受更多加密货币。

想让你的 SellAuth 店铺接受更多加密货币支付吗？你可以在大约 **5 分钟**内自行完成设置。不需要服务器，也不需要编写任何代码。你只需填写一份简短的表单，我来运行你的结账页面并保持在线。

* 为你的 SellAuth 店铺提供**加密货币结账页面**
* 可在 **Heleket、Cryptomus 或 NowPayments** 中任选
* **同一时间使用一个支付处理器**，随时可以切换到另一个
* 带有状态和**实时日志**的简洁控制面板

![许可证页面显示正在运行的处理器、许可证详情以及支付和 webhook URL](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

你的结账页面已上线：运行状态和你的两个 URL

## 只需 3 步

**1. 获取你的许可证**

购买一个许可证。你会收到一个类似 `ECHO-XXXX-XXXX-XXXX-XXXX` 的密钥。

**2. 创建账号并连接处理器**

用你的密钥注册，选择一个处理器并填写一份表单。

**3. 粘贴 2 个 URL，完成。**

将你的支付 URL 复制到 SellAuth，将你的 webhook URL 复制到你的处理器。你的店铺现在就可以接受加密货币了。

> [!TIP]
>
> 快速跳转：[创建账号](#1-create-account)、[连接处理器](#2-connect-processor)、[你的两个 URL](#3-your-two-urls)、[切换处理器](#4-switch-processor)、[添加另一个许可证](#5-add-license)、[续订](#6-renewals)、[常见问题](#faq)。

## 你需要准备什么

> [!NOTE]
>
> **请准备好：**
>
> * 购买时获得的**许可证密钥**
> * 你的 **SellAuth 店铺 ID** 和一个 **SellAuth API 密钥**
> * 一个 **Heleket、Cryptomus 或 NowPayments** 的账号，以及它的 API 凭据

> [!NOTE]
>
> 截图使用的是虚构的示例数据（店铺 ID `12345`，密钥类似 `test-api-key-xxxx`）。请使用你自己的值，并且绝不要分享它们。

## 1. 创建账号

**1. 打开注册页面**

打开你的控制面板的注册页面。已经注册过？请点击 **Sign in**。

**2. 填写表单**

选择用户名，添加你的电子邮箱，并设置至少 10 个字符的密码。在底部粘贴你的许可证密钥，然后点击 **Create account**。

![创建账号表单，包含用户名、电子邮箱、密码和占位符许可证密钥](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

使用你的许可证密钥注册（此处显示的密钥仅为占位符）

**3. 你已登录**

你会立即登录。你的许可证已生效，计时从现在开始。

> [!WARNING]
>
> 每个密钥只能使用**一次**。如果你看到 "This license key is invalid or has already been used"，请检查密钥是否有拼写错误。如果仍然失败，请联系支持。请保管好你的密钥。

## 2. 连接处理器

处理器是处理加密货币支付的服务。请选择**一个**，之后可以切换。

**1. 打开你的许可证**

点击顶部的 **Licenses**，然后点击你的许可证，再点击 **Set up processor**。

**2. 选择处理器**

![Choose a processor 页面，列出 Heleket、Cryptomus 和 NowPayments](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-12-swap-pick.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=37c8d5376e810510e3154b83a831249d)

选择 NowPayments、Heleket 或 Cryptomus

**3. 填写表单**

每份表单都需要你的 **SellAuth 店铺 ID**、你的 **SellAuth API 密钥**（所需权限范围：Invoice Read、Update、Process）以及你的处理器的凭据。请参阅下方标签页。

**4. 点击绿色按钮**

设置最多需要一分钟。请保持页面打开直到完成。然后你会看到你的状态和你的两个 URL。

> [tab] NowPayments
>
> 你需要你的 **NowPayments API 密钥**和 **NowPayments IPN secret**。
>
> ![NowPayments 设置表单，包含店铺 ID、SellAuth API 密钥、NowPayments API 密钥和 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 设置表单

> [tab] Heleket
>
> 你需要你的 **Heleket API 密钥**和 **Heleket 商户 ID**。
>
> ![Heleket 设置表单，包含店铺 ID、SellAuth API 密钥、Heleket API 密钥和商户 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 设置表单

> [tab] Cryptomus
>
> 你需要你的 **Cryptomus API 密钥**和 **Cryptomus 商户 ID**。
>
> ![Cryptomus 设置表单，包含店铺 ID、SellAuth API 密钥、Cryptomus API 密钥和商户 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 设置表单

> [!NOTE]
>
> 请在你的处理器自己的控制面板中查找 API 凭据。菜单名称有时可能会有所不同。首次设置后，SellAuth 店铺 ID 会被**锁定到你的许可证**，所以请使用你真正想要销售的店铺。

> [!WARNING]
>
> \*\*常见错误：\*\*SellAuth API 密钥或店铺 ID 拼写错误、混淆 API 密钥与商户 ID（或 IPN secret），以及复制密钥时在开头或结尾带入了空格。如果设置失败，你会看到红色提示，并且表单会保留你输入的内容。请重新输入你的密钥。
>
> ![设置表单，带有关于 SellAuth 店铺密钥的红色错误提示](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> 错误示例：SellAuth 密钥错误

## 3. 你的两个 URL 和测试支付

这是最后一步。你的许可证页面显示**两个 URL**，每个放在不同的地方。

![Your URLs 卡片，包含支付 URL 和 webhook URL，每个都有 Copy 按钮](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

使用 Copy 按钮

| URL | 作用 | 粘贴到哪里 |
| - | - | - |
| **Pay URL** | 将你的买家引导到加密货币结账页面。 | SellAuth 中，作为支付方式的重定向 URL |
| **Webhook URL** | 在付款完成时通知处理器，使订单标记为已支付。 | 你的处理器的控制面板中，作为 callback 或 IPN URL |

**1. 将支付 URL 粘贴到 SellAuth**

点击 **Pay URL** 旁边的 **Copy**。在 SellAuth 中打开你的支付方式，并把重定向 URL 设为它。你的控制面板会提示：*SellAuth, Payment methods, redirect URL*。

**2. 将 webhook URL 粘贴到你的处理器**

点击 **Webhook URL** 旁边的 **Copy**。在你的处理器的控制面板中，把 callback 或 IPN URL 设为它。你的控制面板会提示，例如：*NowPayments dashboard, callback / IPN URL*。

**3. 检查状态**

你的许可证页面上的处理器卡片会显示绿色的 **running** 标记。

![活动的处理器卡片，带有绿色 running 标记以及 Swap processor、Start、Stop 和 Restart 按钮](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

正在运行的处理器

**4. 下一个小额测试订单**

用加密货币、小额购买你自己的一件商品。滚动到你的许可证页面上的 **Logs**。当支付请求到达时，新的日志行会实时出现。支付确认后，订单会被标记为已支付并交付。

> [!NOTE]
>
> SellAuth 和你的处理器控制面板中的菜单名称可能与这里所写的略有不同。请查找重定向 URL 以及 callback 或 IPN URL。

> [!WARNING]
>
> 请让支付 URL 中的 `{unique_id}` **保持原样**。SellAuth 会为每个订单填入它。

如果感觉有什么卡住了，请先在你的许可证页面上尝试 **Restart**。

## 4. 切换处理器

每个许可证**同一时间可使用一个处理器**，你可以随时切换，例如从 NowPayments 切换到 Heleket。

* \*\*保持不变：\*\*你的许可证、到期日期、你的 SellAuth 店铺 ID 和密钥。
* **会改变：你需要输入新处理器的凭据，并且会得到需要重新粘贴的新 URL**。

**1. 点击 Swap processor**

打开你的许可证，点击 **Swap processor** 并选择新的处理器。

**2. 填写新表单**

表单会警告你，新的结账页面上线后，你当前的结账页面将停止工作。输入新的凭据并勾选复选框确认。

![Heleket 设置表单，带有切换警告和确认复选框](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

从 NowPayments 切换到 Heleket

**3. 粘贴新的 URL**

你会看到 *Swap complete*。请在 SellAuth 中更新重定向 URL，并在新处理器中更新 callback 或 IPN URL。

> [!WARNING]
>
> 切换之后，**旧的 URL 会立即失效**。请尽快更新 SellAuth，以免买家访问到失效链接。

> [!TIP]
>
> 这是安全的。新的结账页面会先启动，并且必须能正常工作，之后才会发生任何变化。如果切换失败，你会看到一条消息，说明你的旧结账页面**仍然处于活动状态**。不会丢失任何东西。修复问题后重试即可。

## 5. 添加另一个许可证

每个许可证为你提供**一个处理器名额**。可以添加另一个许可证，用于**第二个 SellAuth 店铺**或同时使用**第二个处理器**。

**1. 点击 Add license**

使用顶部菜单中的 **Add license**。粘贴新的密钥并选择 **Add as new license**。

![Add license 表单，包含占位符密钥以及添加为新许可证或延长现有许可证的选项](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

添加许可证（占位符密钥）

**2. 进行设置**

你的控制面板会列出每个许可证及其各自的状态和到期日期。打开新的许可证并连接处理器。每个许可证有各自的店铺和各自的 URL。

![控制面板列出两个加密货币许可证及其状态和到期时间](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

包含多个许可证的控制面板

目前许可证适用于**加密货币**支付。其他类别，如游戏皮肤和银行卡支付，显示为 **coming soon**，暂时无法使用。

## 6. 续订和到期

许可证有 **1、3、6 或 12 个月**可选。计时从**你注册或兑换密钥时**开始，而不是购买时。每次兑换，你还会额外获得 **2 天**，用于设置和测试。你的到期日期显示在许可证页面顶部以及控制面板中。

许可证到期时：

* 你的结账页面会**暂停**。在你续订之前，买家无法使用加密货币支付。
* \*\*不会删除任何内容。\*\*你的设置和日志都会保留。

![许可证页面，带有 expired 标记和兑换续订密钥的提示信息](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

已到期的许可证，带有续订提示

**1. 获取续订密钥**

购买一个新的许可证密钥。

**2. 兑换它**

点击你的许可证页面上的 **Redeem a renewal key** 或 **Extend with a new key**，并粘贴密钥。

**3. 完成**

你的许可证重新生效，你的结账页面再次启动。你的 URL 保持不变。

> [!TIP]
>
> 你可以在到期**之前**续订。新增的时间会加到你当前的结束日期上，所以你不会损失任何时间。

> [!WARNING]
>
> 请像对待密码一样对待许可证密钥。不要公开发布。你的控制面板只显示最后 4 个字符。你可以在 **Settings** 中更改密码。

## 常见问题

> [accordion] 我的许可证密钥无效或已被使用
>
> 检查是否有拼写错误和多余的空格。每个密钥只能使用**一次**。如果你已经用它注册过，请直接登录。如果你确定它是全新的，请询问 Echo。

> [accordion] 设置时显示红色错误
>
> 最常见的原因是 SellAuth API 密钥、店铺 ID 或处理器凭据有误。检查每个字段，去掉空格后重试。表单会显示失败尝试的最后几行日志作为参考。

> [accordion] 买家付款后订单仍显示未支付
>
> 检查你的处理器控制面板中的 **webhook URL**。它必须与你的许可证页面上的完全一致。然后查看你的许可证页面上的 **Logs** 是否有错误。

> [accordion] 买家在结账时进入错误页面
>
> 检查 SellAuth 中的**重定向 URL**。它必须是你的支付 URL，并且 `{unique_id}` 保持原样。同时检查你的许可证是否有效，以及标记是否显示 **running**。

> [accordion] 我切换了处理器，结账停止了
>
> 切换之后请粘贴**新的 URL**。旧的 URL 会失效。

> [accordion] 我的切换失败了
>
> 你的旧设置会被**保留并仍然处于活动状态**。阅读红色提示，修正凭据后重试。

> [accordion] 我无法登录
>
> 多次输入错误密码后，你会被暂时阻止。**等待大约 15 分钟**后重试。并检查你的用户名或电子邮箱。

> [accordion] 我看到一条请稍后再试的消息
>
> 每小时设置、切换或更改凭据的次数是有限制的。稍等片刻后重试。

> [accordion] 我想更换我的 SellAuth 店铺
>
> 首次设置后，店铺会被锁定到许可证。请联系支持更改，或为另一个店铺使用另一个许可证。

> [accordion] 我忘记了密码
>
> 系统不会发送电子邮件。请联系支持重置密码。之后你可以在 **Settings** 中更改密码。

> [accordion] 我的许可证到期了
>
> 你的结账页面已暂停，且不会丢失任何内容。请兑换续订密钥。参见[续订和到期](#6-renewals)。

仍然无法解决？请在我的[支持服务器](https://discord.echoauth.dev)中创建工单。


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