Création du wallet de dépôt
Vous appelez POST /api/v1/wallets/create avec l’adresse marchand, le réseau et votre callback. La plateforme renvoie l’adresse générée à communiquer au payeur.
API · wallets de dépôt · webhooks
NxtGateW génère des adresses de réception, suit les mouvements on-chain (Ethereum, Polygon, Tron, Solana), applique les splits configurés côté serveur sur EVM, et notifie votre backend par callback HTTPS à chaque événement.
Flux typique pour un marchand intégré via l’API (clé + secret) et une URL de notification.
Vous appelez POST /api/v1/wallets/create avec l’adresse marchand, le réseau et votre callback. La plateforme renvoie l’adresse générée à communiquer au payeur.
Les fonds arrivent sur l’adresse de dépôt. Un cron synchronise l’explorateur (mouvements natifs, ERC-20, internes) vers la base.
Sur Ethereum / Polygon, les parts plateforme, affilié et marchand sont appliquées selon la configuration (contrat ou scripts serveur selon votre déploiement).
Chaque mouvement peut déclencher wallet.balance_changed. Lorsque la sync est stable, un agrégat wallet.movements_snapshot résume les mouvements et compteurs.
Moins d’infra à maintenir : clés chiffrées, indexation et callbacks depuis le même service.
Adresse dédiée par opération ou par client, associée à votre compte marchand / PSP et à votre URL de callback.
APIEthereum, Polygon, Tron et Solana pour la création de wallets ; indexation explorer détaillée sur EVM.
ChaîneParts affilié / sous-affilié, frais plateforme figés à la création du wallet, vérification check-config base vs on-chain.
POST JSON signés par X-IPN-Token, relances automatiques en cas d’échec HTTP (cron dédié).
Authentification par en-têtes X-API-Key et X-API-Secret, corps JSON, réponses standardisées. Exemple simplifié :
{
"address": "0xVotreWalletMarchand…",
"callback": "https://votre-site.com/webhooks/nxtgatew",
"network": "polygon"
}
{
"event": "wallet.balance_changed",
"deposit_address": "0x…",
"labels": {
"merchant_wallet": "0x…",
"platform_wallet": "0x…",
"deposit_wallet": "0x…"
},
"movement": { "direction": "in", … }
}
Référence complète (authentification, corps des requêtes, webhooks wallet.balance_changed et wallet.movements_snapshot) :
documentation API
· source Markdown doc/API-Merchants.md dans le dépôt.
Créez un compte marchand ou PSP, récupérez votre paire API dans le profil, puis appelez les endpoints documentés.
Espace admin et tableaux de bord accessibles après authentification.