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

# Automatización de pagos de SellAuth

> Acepta más criptomonedas en tu tienda SellAuth en unos 5 minutos con NowPayments, Heleket o Cryptomus.

¿Quieres aceptar más pagos en criptomonedas en tu tienda SellAuth? Puedes configurarlo tú mismo en unos **5 minutos**. No necesitas un servidor y no escribes ningún código. Rellenas un formulario corto, y yo ejecuto tu checkout y lo mantengo en línea.

* Una **página de pago con criptomonedas** para tu tienda SellAuth
* A tu elección: **Heleket, Cryptomus o NowPayments**
* **Un solo procesador a la vez**. Cambia a otro cuando quieras.
* Un panel sencillo con tu estado y **logs en directo**

![Página de licencia con un procesador en ejecución, los detalles de la licencia y las URLs de pago y de webhook](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

Tu checkout está activo: estado en ejecución y tus dos URLs

## Son 3 pasos

**1. Conseguir tu licencia**

Compra una licencia. Recibes una clave con este aspecto: `ECHO-XXXX-XXXX-XXXX-XXXX`.

**2. Crear tu cuenta y conectar un procesador**

Regístrate con tu clave, elige un procesador y rellena un formulario.

**3. Pegar 2 URLs. Listo.**

Copia tu URL de pago en SellAuth y tu URL de webhook en tu procesador. Tu tienda ya acepta criptomonedas.

> [!TIP]
>
> Ir a: [Crear tu cuenta](#1-create-your-account), [Conectar un procesador](#2-connect-a-processor), [Tus dos URLs](#3-your-two-urls-and-test-payment), [Cambiar de procesador](#4-switch-processor), [Añadir otra licencia](#5-add-another-license), [Renovaciones](#6-renewals-and-expiry), [Preguntas frecuentes](#faq).

## Lo que necesitas

> [!NOTE]
>
> **Ten preparado lo siguiente:**
>
> * Tu **clave de licencia** de tu compra
> * Tu **Shop ID de SellAuth** y una **clave de API de SellAuth**
> * Una cuenta en **Heleket, Cryptomus o NowPayments**, con sus credenciales de API

> [!NOTE]
>
> Las capturas de pantalla usan datos de ejemplo falsos (Shop ID `12345`, claves como `test-api-key-xxxx`). Usa tus propios valores y no los compartas nunca.

## 1. Crear tu cuenta

**1. Abrir la página de registro**

Abre la página de registro de tu panel. ¿Ya te registraste? Haz clic en **Sign in** en su lugar.

**2. Rellenar el formulario**

Elige un nombre de usuario, añade tu correo electrónico y elige una contraseña de al menos 10 caracteres. Pega tu clave de licencia al final y haz clic en **Create account**.

![Formulario Create your account con nombre de usuario, correo, contraseña y una clave de licencia de ejemplo](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

Regístrate con tu clave de licencia (la clave que se muestra aquí es un marcador de posición)

**3. Ya estás dentro**

Has iniciado sesión de inmediato. Tu licencia está activa y tu tiempo empieza ahora.

> [!WARNING]
>
> Cada clave funciona **una sola vez**. Si ves "This license key is invalid or has already been used", comprueba que la clave no tenga errores tipográficos. Si sigue fallando, pregunta a soporte. Mantén tu clave en privado.

## 2. Conectar un procesador

Un procesador es el servicio que gestiona el pago en criptomonedas. Elige **uno**. Puedes cambiar más adelante.

**1. Abrir tu licencia**

Haz clic en **Licenses** arriba, luego en tu licencia y después en **Set up processor**.

**2. Elegir un procesador**

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

Elige NowPayments, Heleket o Cryptomus

**3. Rellenar el formulario**

Cada formulario pide tu **Shop ID de SellAuth**, tu **clave de API de SellAuth** (Required Scopes: Invoice Read, Update, Process) y las credenciales de tu procesador. Mira la pestaña de abajo.

**4. Hacer clic en el botón verde**

La configuración tarda hasta un minuto. Mantén la página abierta hasta que termine. Después ves tu estado y tus dos URLs.

> [tab] NowPayments
>
> Necesitas tu **NowPayments API key** y tu **NowPayments IPN secret**.
>
> ![Formulario de configuración de NowPayments con Shop ID, clave de API de SellAuth, clave de API de NowPayments e 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)
>
> Formulario de configuración de NowPayments

> [tab] Heleket
>
> Necesitas tu **Heleket API key** y tu **Heleket merchant ID**.
>
> ![Formulario de configuración de Heleket con Shop ID, clave de API de SellAuth, clave de API de Heleket y 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)
>
> Formulario de configuración de Heleket

> [tab] Cryptomus
>
> Necesitas tu **Cryptomus API key** y tu **Cryptomus merchant ID**.
>
> ![Formulario de configuración de Cryptomus con Shop ID, clave de API de SellAuth, clave de API de Cryptomus y 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)
>
> Formulario de configuración de Cryptomus

> [!NOTE]
>
> Encuentra tus credenciales de API en el propio panel de tu procesador. Los nombres de los menús pueden cambiar de vez en cuando. El Shop ID de SellAuth queda **bloqueado a tu licencia** tras la primera configuración, así que usa la tienda en la que de verdad quieres vender.

> [!WARNING]
>
> **Errores comunes:** un error tipográfico en la clave de API de SellAuth o en el Shop ID, confundir la clave de API con el merchant ID (o con el IPN secret) y espacios copiados al principio o al final de una clave. Si la configuración falla, ves un mensaje rojo y el formulario conserva lo que escribiste. Vuelve a introducir tus claves secretas.
>
> ![Formulario de configuración con un mensaje de error rojo sobre la clave de la tienda SellAuth](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> Ejemplo de error: la clave de SellAuth era incorrecta

## 3. Tus dos URLs y el pago de prueba

Este es el último paso. La página de tu licencia muestra **dos URLs**. Cada una va en un sitio distinto.

![Tarjeta Your URLs con una URL de pago y una URL de webhook, cada una con un botón Copy](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

Usa los botones Copy

| URL | Qué hace | Dónde pegarla |
| - | - | - |
| **Pay URL** | Envía a tu comprador al checkout con criptomonedas. | En SellAuth, como URL de redirección del método de pago |
| **Webhook URL** | Avisa al procesador cuando se completa un pago, para que el pedido se marque como pagado. | En el panel de tu procesador, como URL de callback o de IPN |

**1. Pegar la URL de pago en SellAuth**

Haz clic en **Copy** junto a **Pay URL**. En SellAuth, abre tus métodos de pago y define la URL de redirección con ella. Tu panel dice: *SellAuth, Payment methods, redirect URL*.

**2. Pegar la URL de webhook en tu procesador**

Haz clic en **Copy** junto a **Webhook URL**. En el panel de tu procesador, define la URL de callback o de IPN con ella. Tu panel dice, por ejemplo: *NowPayments dashboard, callback / IPN URL*.

**3. Comprobar el estado**

La tarjeta del procesador en la página de tu licencia muestra una insignia verde **running**.

![Tarjeta del procesador activo con una insignia verde running y los botones Swap processor, Start, Stop y Restart](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

Un procesador en ejecución

**4. Hacer un pedido de prueba pequeño**

Compra uno de tus propios productos con criptomonedas, por un importe pequeño. Desplázate hasta **Logs** en la página de tu licencia. Aparecen líneas nuevas en directo cuando llega una solicitud de pago. Una vez confirmado el pago, el pedido se marca como pagado y se entrega.

> [!NOTE]
>
> Los nombres de los menús en SellAuth y en el panel de tu procesador pueden verse algo distintos de lo que se escribe aquí. Busca la URL de redirección y la URL de callback o de IPN.

> [!WARNING]
>
> Mantén `{unique_id}` **exactamente como está escrito** en la URL de pago. SellAuth lo rellena en cada pedido.

Si algo parece atascado, prueba primero **Restart** en la página de tu licencia.

## 4. Cambiar de procesador

Puedes usar **un procesador a la vez** por licencia y cambiar cuando quieras, por ejemplo de NowPayments a Heleket.

* **Se mantiene igual:** tu licencia, tu fecha de caducidad, tu Shop ID de SellAuth y tu clave.
* **Cambia:** introduces las credenciales del nuevo procesador y obtienes **URLs nuevas** que debes volver a pegar.

**1. Hacer clic en Swap processor**

Abre tu licencia, haz clic en **Swap processor** y elige el nuevo.

**2. Rellenar el nuevo formulario**

El formulario te avisa de que tu checkout actual se detiene cuando el nuevo esté activo. Introduce las nuevas credenciales y marca la casilla para confirmar.

![Formulario de configuración de Heleket con una advertencia de cambio y una casilla de confirmación](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

Cambio de NowPayments a Heleket

**3. Pegar las URLs nuevas**

Ves *Swap complete*. Actualiza la URL de redirección en SellAuth y la URL de callback o de IPN en el nuevo procesador.

> [!WARNING]
>
> Tras un cambio, las **URLs antiguas dejan de funcionar de inmediato**. Actualiza SellAuth rápido para que los compradores no lleguen a un enlace roto.

> [!TIP]
>
> Es seguro. El nuevo checkout arranca primero y tiene que funcionar antes de que cambie nada. Si el cambio falla, ves un mensaje que indica que tu checkout antiguo **sigue activo**. No se pierde nada. Corrige el problema e inténtalo de nuevo.

## 5. Añadir otra licencia

Cada licencia te da **un espacio de procesador**. Añade otra licencia para una **segunda tienda SellAuth** o un **segundo procesador** al mismo tiempo.

**1. Hacer clic en Add license**

Usa **Add license** en el menú superior. Pega la nueva clave y elige **Add as new license**.

![Formulario Add license con una clave de ejemplo y opciones para añadirla como licencia nueva o ampliar una existente](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

Añadir una licencia (clave de ejemplo)

**2. Configurarla**

Tu panel lista cada licencia con su propio estado y fecha de caducidad. Abre la nueva y conecta un procesador. Cada licencia tiene su propia tienda y sus propias URLs.

![Panel con dos licencias de criptomonedas, con su estado y caducidad](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

Panel con varias licencias

Hoy las licencias son para pagos con **criptomonedas**. Otras categorías, como skins y pagos con tarjeta, aparecen como **coming soon** y todavía no se pueden usar.

## 6. Renovaciones y caducidad

Las licencias son de **1, 3, 6 o 12 meses**. El tiempo empieza cuando **te registras o canjeas la clave**, no cuando compras. Recibes **2 días extra** por cada canje, para la configuración y las pruebas. Tu fecha de caducidad aparece en la parte superior de la página de tu licencia y en tu panel.

Cuando una licencia caduca:

* Tu checkout **se pausa**. Los compradores no pueden pagar con criptomonedas hasta que renueves.
* **No se elimina nada.** Tus ajustes y logs se conservan.

![Página de licencia con una insignia expired y un mensaje para canjear una clave de renovación](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

Una licencia caducada con un aviso de renovación

**1. Conseguir una clave de renovación**

Compra una nueva clave de licencia.

**2. Canjearla**

Haz clic en **Redeem a renewal key**, o en **Extend with a new key** en la página de tu licencia, y pega la clave.

**3. Listo**

Tu licencia vuelve a estar activa y tu checkout arranca de nuevo. Tus URLs siguen siendo las mismas.

> [!TIP]
>
> Puedes renovar **antes** de que caduque. El tiempo nuevo se suma a tu fecha de fin actual, así que no pierdes nada.

> [!WARNING]
>
> Trata una clave de licencia como una contraseña. No la publiques en público. Tu panel solo muestra los últimos 4 caracteres. Puedes cambiar tu contraseña en **Settings**.

## Preguntas frecuentes

> [accordion] Mi clave de licencia no es válida o ya se usó
>
> Comprueba que no haya errores tipográficos ni espacios de más. Cada clave funciona **una sola vez**. Si ya te registraste con ella, inicia sesión en su lugar. Si estás seguro de que es nueva, pregunta a Echo.

> [accordion] La configuración muestra un error rojo
>
> Lo más habitual es una clave de API de SellAuth incorrecta, un Shop ID erróneo o credenciales del procesador equivocadas. Revisa cada campo, quita los espacios e inténtalo de nuevo. El formulario muestra las últimas líneas del log del intento fallido para ayudarte.

> [accordion] El pedido sigue sin pagar después de que el comprador pagó
>
> Comprueba la **URL de webhook** en el panel de tu procesador. Debe ser exactamente la de la página de tu licencia. Después revisa los **Logs** de la página de tu licencia en busca de errores.

> [accordion] Los compradores llegan a una página de error en el checkout
>
> Comprueba la **URL de redirección** en SellAuth. Debe ser tu URL de pago, con `{unique_id}` tal como está escrito. Comprueba también que tu licencia esté activa y que la insignia diga **running**.

> [accordion] Cambié de procesador y el checkout dejó de funcionar
>
> Pega las **URLs nuevas** después de un cambio. Las antiguas dejan de funcionar.

> [accordion] Mi cambio falló
>
> Tu configuración antigua **se conserva y sigue activa**. Lee el mensaje rojo, corrige las credenciales e inténtalo de nuevo.

> [accordion] No puedo iniciar sesión
>
> Tras varias contraseñas incorrectas se te bloquea durante un tiempo. **Espera unos 15 minutos** e inténtalo de nuevo. Comprueba tu nombre de usuario o correo electrónico.

> [accordion] Veo un mensaje que dice que lo intente más tarde
>
> Hay un límite de cuántas veces por hora puedes configurar, cambiar o modificar credenciales. Espera un poco e inténtalo de nuevo.

> [accordion] Quiero cambiar mi tienda SellAuth
>
> La tienda queda bloqueada a la licencia tras la primera configuración. Pide a soporte que la cambie, o usa otra licencia para la otra tienda.

> [accordion] Olvidé mi contraseña
>
> No se envía ningún correo. Pide a soporte un restablecimiento de contraseña. Después podrás cambiar tu contraseña en **Settings**.

> [accordion] Mi licencia caducó
>
> Tu checkout está en pausa y no se pierde nada. Canjea una clave de renovación. Consulta [Renovaciones y caducidad](#6-renewals-and-expiry).

¿Sigues atascado? Abre un ticket en mi [servidor de soporte](https://discord.echoauth.dev).


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