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

# Automação de pagamentos do SellAuth

> Aceite mais criptomoedas na sua loja SellAuth em cerca de 5 minutos com NowPayments, Heleket ou Cryptomus.

Quer receber mais pagamentos em cripto na sua loja SellAuth? Você mesmo pode configurar isso em cerca de **5 minutos**. Você não precisa de servidor e não escreve nenhum código. Você preenche um formulário curto, e eu opero seu checkout e o mantenho no ar.

* Uma **página de checkout em cripto** para a sua loja SellAuth
* A sua escolha entre **Heleket, Cryptomus ou NowPayments**
* **Um processador por vez**. Troque por outro quando quiser.
* Um painel simples com seu status e **logs ao vivo**

![Página de licença mostrando um processador em execução, os detalhes da licença e as URLs de pagamento e de webhook](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

Seu checkout está no ar: status em execução e suas duas URLs

## São 3 passos

**1. Obtenha sua licença**

Compre uma licença. Você recebe uma chave parecida com `ECHO-XXXX-XXXX-XXXX-XXXX`.

**2. Crie sua conta e conecte um processador**

Registre-se com sua chave, escolha um processador e preencha um formulário.

**3. Cole 2 URLs. Pronto.**

Copie sua URL de pagamento no SellAuth e sua URL de webhook no seu processador. Sua loja agora aceita cripto.

> [!TIP]
>
> Ir para: [Crie sua conta](#1-crie-sua-conta), [Conecte um processador](#2-conecte-um-processador), [Suas duas URLs](#3-suas-duas-urls-e-pagamento-de-teste), [Troque de processador](#4-troque-de-processador), [Adicione outra licença](#5-adicione-outra-licenca), [Renovações](#6-renovacoes-e-expiracao), [FAQ](#faq).

## O que você precisa

> [!NOTE]
>
> **Tenha estes itens em mãos:**
>
> * Sua **chave de licença** da compra
> * O **ID da sua loja SellAuth** e uma **chave de API do SellAuth**
> * Uma conta na **Heleket, Cryptomus ou NowPayments**, com as credenciais de API dela

> [!NOTE]
>
> As capturas de tela usam dados de exemplo fictícios (ID da loja `12345`, chaves como `test-api-key-xxxx`). Use seus próprios valores e nunca os compartilhe.

## 1. Crie sua conta

**1. Abra a página de registro**

Abra a página de registro do seu painel. Já se registrou? Clique em **Sign in**.

**2. Preencha o formulário**

Escolha um nome de usuário, informe seu e-mail e escolha uma senha com pelo menos 10 caracteres. Cole sua chave de licença na parte inferior e clique em **Create account**.

![Formulário Create your account com nome de usuário, e-mail, senha e uma chave de licença de exemplo](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

Registre-se com sua chave de licença (a chave mostrada aqui é um exemplo)

**3. Você entrou**

Você já está conectado. Sua licença está ativa e seu tempo começa agora.

> [!WARNING]
>
> Cada chave funciona apenas **uma vez**. Se você vir "This license key is invalid or has already been used", verifique se a chave tem erros de digitação. Se ainda assim falhar, peça ajuda ao suporte. Mantenha sua chave privada.

## 2. Conecte um processador

Um processador é o serviço que cuida do pagamento em cripto. Escolha **um**. Você pode trocar depois.

**1. Abra sua licença**

Clique em **Licenses** no topo, depois na sua licença e em **Set up processor**.

**2. Escolha um processador**

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

Escolha NowPayments, Heleket ou Cryptomus

**3. Preencha o formulário**

Todo formulário pede o **ID da sua loja SellAuth**, sua **chave de API do SellAuth** (escopos necessários: Invoice Read, Update, Process) e as credenciais do seu processador. Veja a aba abaixo.

**4. Clique no botão verde**

A configuração leva até um minuto. Mantenha a página aberta até terminar. Depois você vê seu status e suas duas URLs.

> [tab] NowPayments
>
> Você precisa da sua **chave de API do NowPayments** e do **IPN secret do NowPayments**.
>
> ![Formulário de configuração do NowPayments com ID da loja, chave de API do SellAuth, chave de API do 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)
>
> Formulário de configuração do NowPayments

> [tab] Heleket
>
> Você precisa da sua **chave de API da Heleket** e do **merchant ID da Heleket**.
>
> ![Formulário de configuração da Heleket com ID da loja, chave de API do SellAuth, chave de API da Heleket e 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)
>
> Formulário de configuração da Heleket

> [tab] Cryptomus
>
> Você precisa da sua **chave de API da Cryptomus** e do **merchant ID da Cryptomus**.
>
> ![Formulário de configuração da Cryptomus com ID da loja, chave de API do SellAuth, chave de API da Cryptomus e 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)
>
> Formulário de configuração da Cryptomus

> [!NOTE]
>
> Encontre suas credenciais de API no painel do próprio processador. Os nomes dos menus podem parecer diferentes de tempos em tempos. O ID da loja SellAuth fica **travado na sua licença** após a primeira configuração, então use a loja em que você realmente quer vender.

> [!WARNING]
>
> **Erros comuns:** um erro de digitação na chave de API do SellAuth ou no ID da loja, confundir a chave de API com o merchant ID (ou o IPN secret) e espaços copiados no início ou no fim de uma chave. Se a configuração falhar, você vê uma mensagem vermelha e o formulário mantém o que você digitou. Informe novamente suas chaves secretas.
>
> ![Formulário de configuração com uma mensagem de erro vermelha sobre a chave da loja SellAuth](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> Exemplo de erro: a chave do SellAuth estava errada

## 3. Suas duas URLs e pagamento de teste

Esta é a última etapa. A página da sua licença mostra **duas URLs**. Cada uma vai em um lugar diferente.

![Cartão Your URLs com uma URL de pagamento e uma URL de webhook, cada uma com um botão Copy](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

Use os botões Copy

| URL | O que faz | Onde colar |
| - | - | - |
| **Pay URL** | Envia seu comprador ao checkout em cripto. | No SellAuth, como URL de redirecionamento do método de pagamento |
| **Webhook URL** | Avisa o processador quando um pagamento é concluído, para que o pedido seja marcado como pago. | No painel do seu processador, como URL de callback ou IPN |

**1. Cole a URL de pagamento no SellAuth**

Clique em **Copy** ao lado de **Pay URL**. No SellAuth, abra seus métodos de pagamento e defina a URL de redirecionamento com ela. Seu painel diz: *SellAuth, Payment methods, redirect URL*.

**2. Cole a URL de webhook no seu processador**

Clique em **Copy** ao lado de **Webhook URL**. No painel do seu processador, defina a URL de callback ou IPN com ela. Seu painel diz, por exemplo: *NowPayments dashboard, callback / IPN URL*.

**3. Verifique o status**

O cartão do processador na página da sua licença mostra um selo verde **running**.

![Cartão do processador ativo com um selo verde running e os botões Swap processor, Start, Stop e Restart](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

Um processador em execução

**4. Faça um pequeno pedido de teste**

Compre um dos seus próprios produtos com cripto, com um valor pequeno. Role até **Logs** na página da sua licença. Novas linhas aparecem ao vivo quando chega uma solicitação de pagamento. Depois que o pagamento é confirmado, o pedido é marcado como pago e entregue.

> [!NOTE]
>
> Os nomes dos menus no SellAuth e no painel do seu processador podem ser um pouco diferentes do que está escrito aqui. Procure a URL de redirecionamento e a URL de callback ou IPN.

> [!WARNING]
>
> Mantenha `{unique_id}` **exatamente como está escrito** na URL de pagamento. O SellAuth o preenche para cada pedido.

Se algo parecer travado, tente primeiro **Restart** na página da sua licença.

## 4. Troque de processador

Você pode usar **um processador por vez** por licença e trocar sempre que quiser, por exemplo do NowPayments para a Heleket.

* **Permanece igual:** sua licença, sua data de validade, o ID e a chave da sua loja SellAuth.
* **Muda:** você informa as credenciais do novo processador e recebe **novas URLs** para colar novamente.

**1. Clique em Swap processor**

Abra sua licença, clique em **Swap processor** e escolha o novo.

**2. Preencha o novo formulário**

O formulário avisa que seu checkout atual para quando o novo entrar no ar. Informe as novas credenciais e marque a caixa para confirmar.

![Formulário de configuração da Heleket com um aviso de troca e uma caixa de confirmação](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

Trocando do NowPayments para a Heleket

**3. Cole as novas URLs**

Você vê *Swap complete*. Atualize a URL de redirecionamento no SellAuth e a URL de callback ou IPN no novo processador.

> [!WARNING]
>
> Depois de uma troca, as **URLs antigas deixam de funcionar imediatamente**. Atualize o SellAuth rapidamente para que os compradores não caiam em um link morto.

> [!TIP]
>
> É seguro. O novo checkout inicia primeiro e precisa funcionar antes que qualquer coisa mude. Se a troca falhar, você vê uma mensagem dizendo que seu checkout antigo **continua ativo**. Nada é perdido. Corrija o problema e tente novamente.

## 5. Adicione outra licença

Cada licença oferece **uma vaga de processador**. Adicione outra licença para uma **segunda loja SellAuth** ou para um **segundo processador** ao mesmo tempo.

**1. Clique em Add license**

Use **Add license** no menu superior. Cole a nova chave e escolha **Add as new license**.

![Formulário Add license com uma chave de exemplo e opções para adicionar como nova licença ou prorrogar uma existente](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

Adicione uma licença (chave de exemplo)

**2. Configure-a**

Seu painel lista cada licença com seu próprio status e data de validade. Abra a nova e conecte um processador. Cada licença tem sua própria loja e suas próprias URLs.

![Painel listando duas licenças de cripto com status e validade](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

Painel com várias licenças

Hoje as licenças são para pagamentos em **cripto**. Outras categorias, como skins e pagamentos com cartão, aparecem como **coming soon** e ainda não podem ser usadas.

## 6. Renovações e expiração

As licenças têm **1, 3, 6 ou 12 meses**. O tempo começa quando **você registra ou resgata a chave**, não quando a compra. Você ganha **2 dias de bônus** a cada resgate, para configuração e testes. Sua data de validade aparece no topo da página da licença e no seu painel.

Quando uma licença expira:

* Seu checkout é **pausado**. Os compradores não conseguem pagar com cripto até você renovar.
* **Nada é excluído.** Suas configurações e seus logs são mantidos.

![Página de licença com um selo expired e uma mensagem para resgatar uma chave de renovação](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

Uma licença expirada com um aviso de renovação

**1. Obtenha uma chave de renovação**

Compre uma nova chave de licença.

**2. Resgate-a**

Clique em **Redeem a renewal key**, ou em **Extend with a new key** na página da sua licença, e cole a chave.

**3. Pronto**

Sua licença está ativa novamente e seu checkout volta a funcionar. Suas URLs continuam as mesmas.

> [!TIP]
>
> Você pode renovar **antes** de expirar. O novo tempo é somado à sua data final atual, então você não perde nada.

> [!WARNING]
>
> Trate uma chave de licença como uma senha. Não a publique em lugares públicos. Seu painel mostra apenas os últimos 4 caracteres. Você pode alterar sua senha em **Settings**.

## FAQ

> [accordion] Minha chave de licença é inválida ou já foi usada
>
> Verifique se há erros de digitação e espaços extras. Cada chave funciona **uma vez**. Se você já se registrou com ela, faça login. Se tiver certeza de que é nova, pergunte ao Echo.

> [accordion] A configuração mostra um erro vermelho
>
> Quase sempre é uma chave de API do SellAuth, um ID de loja ou credenciais do processador incorretos. Verifique cada campo, remova espaços e tente novamente. O formulário mostra as últimas linhas de log da tentativa que falhou para ajudar.

> [accordion] O pedido continua não pago depois que o comprador pagou
>
> Verifique a **URL de webhook** no painel do seu processador. Ela precisa ser exatamente a que está na página da sua licença. Depois veja os **Logs** na página da sua licença em busca de erros.

> [accordion] Os compradores caem em uma página de erro no checkout
>
> Verifique a **URL de redirecionamento** no SellAuth. Ela precisa ser a sua URL de pagamento, com `{unique_id}` mantido como está. Verifique também se sua licença está ativa e se o selo diz **running**.

> [accordion] Troquei de processador e o checkout parou
>
> Cole as **novas URLs** depois de uma troca. As antigas deixam de funcionar.

> [accordion] Minha troca falhou
>
> Sua configuração antiga é **mantida e continua ativa**. Leia a mensagem vermelha, corrija as credenciais e tente novamente.

> [accordion] Não consigo fazer login
>
> Depois de várias senhas erradas, você fica bloqueado por um tempo. **Aguarde cerca de 15 minutos** e tente novamente. Verifique seu nome de usuário ou e-mail.

> [accordion] Vejo uma mensagem para tentar novamente mais tarde
>
> Há um limite de quantas vezes por hora você pode configurar, trocar ou alterar credenciais. Aguarde um pouco e tente novamente.

> [accordion] Quero alterar minha loja SellAuth
>
> A loja fica travada na licença após a primeira configuração. Peça ao suporte para alterá-la ou use outra licença para a outra loja.

> [accordion] Esqueci minha senha
>
> Nenhum e-mail é enviado. Peça ao suporte uma redefinição de senha. Você pode alterar sua senha depois em **Settings**.

> [accordion] Minha licença expirou
>
> Seu checkout está pausado e nada foi perdido. Resgate uma chave de renovação. Veja [Renovações e expiração](#6-renovacoes-e-expiracao).

Ainda com dificuldades? Abra um ticket no meu [servidor de suporte](https://discord.echoauth.dev).


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