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

# Automatisation des paiements SellAuth

> Accepte plus de cryptomonnaies dans ta boutique SellAuth en environ 5 minutes avec NowPayments, Heleket ou Cryptomus.

Tu veux accepter plus de paiements en crypto dans ta boutique SellAuth ? Tu peux le configurer toi-même en environ **5 minutes**. Tu n'as pas besoin de serveur et tu n'écris aucun code. Tu remplis un court formulaire, et je fais tourner ton checkout et le garde en ligne.

* Une **page de paiement crypto** pour ta boutique SellAuth
* Au choix : **Heleket, Cryptomus ou NowPayments**
* **Un seul processeur à la fois**. Change pour un autre quand tu veux.
* Un tableau de bord simple avec ton statut et des **logs en direct**

![Page de licence affichant un processeur en cours d'exécution, les détails de la licence et les URLs de paiement et de webhook](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

Ton checkout est en ligne : statut en cours d'exécution et tes deux URLs

## Il suffit de 3 étapes

**1. Obtenir ta licence**

Achète une licence. Tu reçois une clé qui ressemble à `ECHO-XXXX-XXXX-XXXX-XXXX`.

**2. Créer ton compte et connecter un processeur**

Inscris-toi avec ta clé, choisis un processeur et remplis un formulaire.

**3. Coller 2 URLs. Terminé.**

Copie ton URL de paiement dans SellAuth et ton URL de webhook dans ton processeur. Ta boutique accepte maintenant la crypto.

> [!TIP]
>
> Accès rapide : [Créer ton compte](#1-create-your-account), [Connecter un processeur](#2-connect-a-processor), [Tes deux URLs](#3-your-two-urls-and-test-payment), [Changer de processeur](#4-switch-processor), [Ajouter une autre licence](#5-add-another-license), [Renouvellements](#6-renewals-and-expiry), [FAQ](#faq).

## Ce dont tu as besoin

> [!NOTE]
>
> **Prépare ces éléments :**
>
> * Ta **clé de licence** issue de ton achat
> * Ton **Shop ID SellAuth** et une **clé API SellAuth**
> * Un compte chez **Heleket, Cryptomus ou NowPayments**, avec ses identifiants API

> [!NOTE]
>
> Les captures d'écran utilisent de fausses données d'exemple (Shop ID `12345`, clés comme `test-api-key-xxxx`). Utilise tes propres valeurs et ne les partage jamais.

## 1. Créer ton compte

**1. Ouvrir la page d'inscription**

Ouvre la page d'inscription de ton tableau de bord. Déjà inscrit ? Clique plutôt sur **Sign in**.

**2. Remplir le formulaire**

Choisis un nom d'utilisateur, ajoute ton e-mail et choisis un mot de passe d'au moins 10 caractères. Colle ta clé de licence en bas, puis clique sur **Create account**.

![Formulaire Create your account avec nom d'utilisateur, e-mail, mot de passe et une clé de licence factice](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

Inscris-toi avec ta clé de licence (la clé affichée ici est un exemple)

**3. Tu es connecté**

Tu es connecté tout de suite. Ta licence est active et ton temps commence maintenant.

> [!WARNING]
>
> Chaque clé ne fonctionne qu'**une seule fois**. Si tu vois "This license key is invalid or has already been used", vérifie que la clé ne contient pas de faute de frappe. Si cela échoue toujours, contacte le support. Garde ta clé privée.

## 2. Connecter un processeur

Un processeur est le service qui gère le paiement en crypto. Choisis-en **un**. Tu pourras en changer plus tard.

**1. Ouvrir ta licence**

Clique sur **Licenses** en haut, puis sur ta licence, puis sur **Set up processor**.

**2. Choisir un processeur**

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

Choisis NowPayments, Heleket ou Cryptomus

**3. Remplir le formulaire**

Chaque formulaire demande ton **Shop ID SellAuth**, ta **clé API SellAuth** (Required Scopes : Invoice Read, Update, Process) et les identifiants de ton processeur. Voir l'onglet ci-dessous.

**4. Cliquer sur le bouton vert**

La configuration prend jusqu'à une minute. Garde la page ouverte jusqu'à la fin. Tu vois ensuite ton statut et tes deux URLs.

> [tab] NowPayments
>
> Tu as besoin de ta **NowPayments API key** et de ton **NowPayments IPN secret**.
>
> ![Formulaire de configuration NowPayments avec Shop ID, clé API SellAuth, clé API NowPayments et 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)
>
> Formulaire de configuration NowPayments

> [tab] Heleket
>
> Tu as besoin de ta **Heleket API key** et de ton **Heleket merchant ID**.
>
> ![Formulaire de configuration Heleket avec Shop ID, clé API SellAuth, clé API Heleket et 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)
>
> Formulaire de configuration Heleket

> [tab] Cryptomus
>
> Tu as besoin de ta **Cryptomus API key** et de ton **Cryptomus merchant ID**.
>
> ![Formulaire de configuration Cryptomus avec Shop ID, clé API SellAuth, clé API Cryptomus et 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)
>
> Formulaire de configuration Cryptomus

> [!NOTE]
>
> Retrouve tes identifiants API dans le tableau de bord de ton processeur. Les noms de menus peuvent changer de temps en temps. Le Shop ID SellAuth est **verrouillé sur ta licence** après la première configuration : utilise donc la boutique sur laquelle tu veux vraiment vendre.

> [!WARNING]
>
> **Erreurs courantes :** une faute de frappe dans la clé API SellAuth ou le Shop ID, une confusion entre la clé API et le merchant ID (ou l'IPN secret), et des espaces copiés au début ou à la fin d'une clé. Si la configuration échoue, tu vois un message rouge et le formulaire conserve ce que tu as saisi. Saisis à nouveau tes clés secrètes.
>
> ![Formulaire de configuration avec un message d'erreur rouge concernant la clé de la boutique SellAuth](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> Exemple d'erreur : la clé SellAuth était incorrecte

## 3. Tes deux URLs et le paiement de test

C'est la dernière étape. La page de ta licence affiche **deux URLs**. Chacune va à un endroit différent.

![Carte Your URLs avec une URL de paiement et une URL de webhook, chacune avec un bouton Copy](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

Utilise les boutons Copy

| URL | À quoi elle sert | Où la coller |
| - | - | - |
| **Pay URL** | Envoie ton acheteur vers le checkout crypto. | Dans SellAuth, comme URL de redirection du moyen de paiement |
| **Webhook URL** | Indique au processeur quand un paiement est terminé, pour que la commande soit marquée comme payée. | Dans le tableau de bord de ton processeur, comme URL de callback ou d'IPN |

**1. Coller l'URL de paiement dans SellAuth**

Clique sur **Copy** à côté de **Pay URL**. Dans SellAuth, ouvre tes moyens de paiement et définis l'URL de redirection avec elle. Ton tableau de bord indique : *SellAuth, Payment methods, redirect URL*.

**2. Coller l'URL de webhook dans ton processeur**

Clique sur **Copy** à côté de **Webhook URL**. Dans le tableau de bord de ton processeur, définis l'URL de callback ou d'IPN avec elle. Ton tableau de bord indique par exemple : *NowPayments dashboard, callback / IPN URL*.

**3. Vérifier le statut**

La carte du processeur sur la page de ta licence affiche un badge vert **running**.

![Carte du processeur actif avec un badge vert running et les boutons Swap processor, Start, Stop et Restart](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

Un processeur en cours d'exécution

**4. Passer une petite commande de test**

Achète l'un de tes propres produits en crypto, pour un petit montant. Fais défiler jusqu'à **Logs** sur la page de ta licence. De nouvelles lignes apparaissent en direct quand une demande de paiement arrive. Une fois le paiement confirmé, la commande est marquée comme payée et livrée.

> [!NOTE]
>
> Les noms de menus dans SellAuth et dans le tableau de bord de ton processeur peuvent être légèrement différents de ceux écrits ici. Cherche l'URL de redirection et l'URL de callback ou d'IPN.

> [!WARNING]
>
> Garde `{unique_id}` **exactement tel qu'écrit** dans l'URL de paiement. SellAuth le remplit pour chaque commande.

Si quelque chose semble bloqué, essaie d'abord **Restart** sur la page de ta licence.

## 4. Changer de processeur

Tu peux utiliser **un seul processeur à la fois** par licence et en changer quand tu veux, par exemple de NowPayments à Heleket.

* **Ne change pas :** ta licence, ta date d'expiration, ton Shop ID et ta clé SellAuth.
* **Change :** tu saisis les identifiants du nouveau processeur et tu obtiens de **nouvelles URLs** à recoller.

**1. Cliquer sur Swap processor**

Ouvre ta licence, clique sur **Swap processor** et choisis le nouveau.

**2. Remplir le nouveau formulaire**

Le formulaire t'avertit que ton checkout actuel s'arrête dès que le nouveau est en ligne. Saisis les nouveaux identifiants et coche la case pour confirmer.

![Formulaire de configuration Heleket avec un avertissement de changement et une case de confirmation](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

Passage de NowPayments à Heleket

**3. Coller les nouvelles URLs**

Tu vois *Swap complete*. Mets à jour l'URL de redirection dans SellAuth et l'URL de callback ou d'IPN dans le nouveau processeur.

> [!WARNING]
>
> Après un changement, les **anciennes URLs cessent de fonctionner immédiatement**. Mets vite SellAuth à jour pour que les acheteurs ne tombent pas sur un lien mort.

> [!TIP]
>
> C'est sûr. Le nouveau checkout démarre d'abord et doit fonctionner avant que quoi que ce soit change. Si le changement échoue, tu vois un message indiquant que ton ancien checkout **est toujours actif**. Rien n'est perdu. Corrige le problème et réessaie.

## 5. Ajouter une autre licence

Chaque licence te donne **un emplacement de processeur**. Ajoute une autre licence pour une **deuxième boutique SellAuth** ou un **deuxième processeur** en parallèle.

**1. Cliquer sur Add license**

Utilise **Add license** dans le menu du haut. Colle la nouvelle clé et choisis **Add as new license**.

![Formulaire Add license avec une clé d'exemple et des options pour l'ajouter comme nouvelle licence ou en prolonger une existante](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

Ajouter une licence (clé d'exemple)

**2. La configurer**

Ton tableau de bord liste chaque licence avec son propre statut et sa propre date d'expiration. Ouvre la nouvelle et connecte un processeur. Chaque licence a sa propre boutique et ses propres URLs.

![Tableau de bord listant deux licences crypto avec statut et expiration](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

Tableau de bord avec plusieurs licences

Aujourd'hui, les licences sont destinées aux paiements en **crypto**. Les autres catégories, comme les skins et les paiements par carte, sont indiquées comme **coming soon** et ne sont pas encore utilisables.

## 6. Renouvellements et expiration

Les licences existent en **1, 3, 6 ou 12 mois**. Le temps commence quand **tu t'inscris ou utilises la clé**, pas quand tu achètes. Tu reçois **2 jours bonus** en plus de chaque utilisation, pour la configuration et les tests. Ta date d'expiration est affichée en haut de la page de ta licence et dans ton tableau de bord.

Quand une licence expire :

* Ton checkout est **mis en pause**. Les acheteurs ne peuvent plus payer en crypto tant que tu n'as pas renouvelé.
* **Rien n'est supprimé.** Tes paramètres et tes logs sont conservés.

![Page de licence avec un badge expired et un message invitant à utiliser une clé de renouvellement](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

Une licence expirée avec une invitation à renouveler

**1. Obtenir une clé de renouvellement**

Achète une nouvelle clé de licence.

**2. L'utiliser**

Clique sur **Redeem a renewal key**, ou sur **Extend with a new key** sur la page de ta licence, et colle la clé.

**3. Terminé**

Ta licence est de nouveau active et ton checkout redémarre. Tes URLs restent les mêmes.

> [!TIP]
>
> Tu peux renouveler **avant** l'expiration. Le nouveau temps est ajouté à ta date de fin actuelle : tu ne perds rien.

> [!WARNING]
>
> Traite une clé de licence comme un mot de passe. Ne la publie pas publiquement. Ton tableau de bord n'affiche que les 4 derniers caractères. Tu peux changer ton mot de passe dans **Settings**.

## FAQ

> [accordion] Ma clé de licence est invalide ou déjà utilisée
>
> Vérifie les fautes de frappe et les espaces en trop. Chaque clé ne fonctionne qu'**une seule fois**. Si tu t'es déjà inscrit avec, connecte-toi plutôt. Si tu es sûr qu'elle est neuve, demande à Echo.

> [accordion] La configuration affiche une erreur rouge
>
> Le plus souvent, c'est une mauvaise clé API SellAuth, un mauvais Shop ID ou de mauvais identifiants du processeur. Vérifie chaque champ, supprime les espaces et réessaie. Le formulaire affiche les dernières lignes de log de la tentative échouée pour t'aider.

> [accordion] La commande reste impayée alors que l'acheteur a payé
>
> Vérifie l'**URL de webhook** dans le tableau de bord de ton processeur. Ce doit être exactement celle de la page de ta licence. Consulte ensuite les **Logs** de la page de ta licence pour y trouver des erreurs.

> [accordion] Les acheteurs arrivent sur une page d'erreur au checkout
>
> Vérifie l'**URL de redirection** dans SellAuth. Ce doit être ton URL de paiement, avec `{unique_id}` conservé tel quel. Vérifie aussi que ta licence est active et que le badge indique **running**.

> [accordion] J'ai changé de processeur et le checkout s'est arrêté
>
> Colle les **nouvelles URLs** après un changement. Les anciennes cessent de fonctionner.

> [accordion] Mon changement a échoué
>
> Ton ancienne configuration est **conservée et toujours active**. Lis le message rouge, corrige les identifiants et réessaie.

> [accordion] Je ne peux pas me connecter
>
> Après plusieurs mots de passe incorrects, tu es bloqué un certain temps. **Attends environ 15 minutes** et réessaie. Vérifie ton nom d'utilisateur ou ton e-mail.

> [accordion] Je vois un message me demandant de réessayer plus tard
>
> Il existe une limite au nombre de configurations, changements ou modifications d'identifiants par heure. Attends un peu et réessaie.

> [accordion] Je veux changer ma boutique SellAuth
>
> La boutique est verrouillée sur la licence après la première configuration. Demande au support de la changer, ou utilise une autre licence pour l'autre boutique.

> [accordion] J'ai oublié mon mot de passe
>
> Aucun e-mail n'est envoyé. Demande au support une réinitialisation de mot de passe. Tu pourras ensuite changer ton mot de passe dans **Settings**.

> [accordion] Ma licence a expiré
>
> Ton checkout est en pause et rien n'est perdu. Utilise une clé de renouvellement. Voir [Renouvellements et expiration](#6-renewals-and-expiry).

Toujours bloqué ? Ouvre un ticket sur mon [serveur de support](https://discord.echoauth.dev).


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