Ce dont vous avez besoin
| Champ | Ce qu'il fait |
|---|---|
| API key | Nous permet d'appeler NOWPayments pour créer le paiement. Secrète. |
| IPN secret | Confirme qu'une notification de paiement vient vraiment de NOWPayments. Secret. |
| URL de réussite / URL d'annulation | Où l'acheteur atterrit après avoir payé ou renoncé. |
IPN (Instant Payment Notification) est le nom NOWPayments du webhook qu'ils envoient quand le statut d'un paiement change.
Pourquoi nous demandons chaque champ
API key
Autorise la création du paiement, pour que les fonds arrivent dans votre compte.
IPN secret
Prouve qu'une notification entrante provient bien de NOWPayments, pour que personne ne puisse falsifier un événement « payé ». C'est une valeur distincte de l'API key.
URL de réussite et d'annulation
Réglages simples : où l'acheteur atterrit après avoir payé ou renoncé. Pas secret.
Configuration
- Test : il n'y a pas de sandbox
NOWPayments n'a ni sandbox ni environnement de test. Pour vérifier de bout en bout, envoyez un petit paiement réel dans une pièce à faibles frais et confirmez qu'il apparaît dans votre tableau de bord. Considérez ce premier petit paiement comme votre test. Un compte NOWPayments est gratuit ; vous ne payez que les frais normaux de réseau et de service sur les paiements réels.
- Ouvrez Payments Settings dans NOWPayments
Connectez-vous sur account.nowpayments.io et allez dans Settings → Payments. Cet écran unique contient les trois éléments dont vous avez besoin : Payout wallets (où les fonds arrivent), API keys et Instant payment notifications. Vous visiterez chacun d'eux successivement.
NOWPayments → Settings → Payments - Ajoutez un payout wallet
NOWPayments déverrouille l'API uniquement une fois qu'un payout wallet est enregistré. Dans Payout wallets, cliquez sur Add new wallet, choisissez une devise, collez une adresse de portefeuille que vous contrôlez, puis cliquez sur Add wallet. C'est l'adresse vers laquelle votre crypto sera réglée.
NOWPayments → Payout wallets → Add new wallet - Créez une API key
Ouvrez API keys et cliquez sur Add new API key. Vos clés sont listées ici, chacune avec une icône de copie, pour que vous puissiez revenir copier une clé à tout moment.
NOWPayments → Settings → API keys - Copiez votre API key
NOWPayments affiche la nouvelle clé dans une boîte de dialogue « API key created ». Cliquez sur l'icône de copie à côté de Your API key et mettez-la de côté. (La clé publique en dessous n'est pas nécessaire pour Coin Moebius.) Vous pouvez ajouter un libellé facultatif, puis cliquer sur Save.
NOWPayments → API key created Il s'agit de votre clé d'API secrète. Traitez-la comme un mot de passe.
- Configurez le callback IPN et copiez le secret IPN
Ouvrez Instant payment notifications. IPN (Instant Payment Notification) est le nom NOWPayments du webhook qu'ils envoient lorsque le statut d'un paiement change.
- Dans le champ Webhook URL, collez l'adresse webhook NOWPayments de votre projet (ci-dessous), puis cliquez sur Save.
- Copiez la clé IPN secret affichée en haut (utilisez Regenerate s'il n'y a pas encore de valeur).
- Sous Choose webhook format, sélectionnez Classic way afin que les montants et les identifiants restent dans leur format numérique normal.
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → Instant payment notifications Votre identifiant de projet se trouve sous le nom du projet dans le tableau de bord Coin Moebius ; insérez-le dans l'adresse ci-dessus. La carte du fournisseur connecté (dernière étape) affiche la même URL, pour que vous puissiez la recopier à tout moment.
- Dans Coin Moebius : Add provider → NOWPayments
Dans votre projet, ouvrez l'onglet Providers, cliquez sur Add provider, choisissez Connect a service et sélectionnez NOWPayments. Collez votre API key et votre IPN secret, définissez l'URL de réussite et l'URL d'annulation (où les acheteurs atterrissent après avoir payé ou renoncé), puis cliquez sur Save.
Coin Moebius → Add provider → NOWPayments - Vous êtes connecté
NOWPayments apparaît désormais dans votre onglet Providers avec la date de connexion. La carte affiche la même URL de webhook que vous avez collée dans NOWPayments, ainsi que Modifier et Déconnecter. Comme NOWPayments n'a pas de sandbox, nous ne pouvons pas vérifier automatiquement l'IPN secret, donc la carte propose un test de micro-paiement : envoyez un tout petit paiement réel pour confirmer que tout fonctionne de bout en bout.
Coin Moebius → Providers → NOWPayments (connecté)
Après la connexion
Il n'y a pas de sandbox, donc votre premier petit paiement réel est le test :
- Créez un produit et placez le bouton d'achat sur une page (un fichier HTML local convient) pointé vers votre projet.
- Payez un petit montant dans une pièce à faibles frais.
- Ouvrez l'onglet Transactions. Quand le statut de la nouvelle ligne atteint succeeded, votre API key et votre IPN secret fonctionnent tous deux de bout en bout.
Dépannage
Le paiement se finalise mais la commande reste en attente.
L'IPN n'arrive pas ou ne se vérifie pas. Confirmez que l'URL de callback correspond et que l'IPN secret du tableau de bord correspond à la IPN Secret Key de vos réglages NOWPayments.
Aucun moyen de tester sans payer.
Exact, il n'y a pas de sandbox. Envoyez un petit paiement réel dans une pièce à faibles frais pour déclencher un véritable IPN, puis observez la commande se mettre à jour.
Le statut ne change que sur activité réelle.
Le statut NOWPayments reflète les livraisons d'IPN, donc un compte silencieux n'affiche aucun statut tant qu'un paiement réel ne bouge pas.
Bon à savoir
Pas de mode test. Vérifiez avec un petit paiement réel, pas un sandbox.
Rotation des secrets. Générez une nouvelle API key ou un nouvel IPN secret à tout moment, puis collez la nouvelle valeur.
Des questions ? Join our Discord