API · wallets de dépôt · webhooks

Encaissez en crypto, sans gérer la chaîne vous-même

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.

Du dépôt au split : le parcours

Flux typique pour un marchand intégré via l’API (clé + secret) et une URL de notification.

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.

Réception on-chain

Les fonds arrivent sur l’adresse de dépôt. Un cron synchronise l’explorateur (mouvements natifs, ERC-20, internes) vers la base.

Split & règlement

Sur Ethereum / Polygon, les parts plateforme, affilié et marchand sont appliquées selon la configuration (contrat ou scripts serveur selon votre déploiement).

Notifications partenaire

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.

Ce que la plateforme prend en charge

Moins d’infra à maintenir : clés chiffrées, indexation et callbacks depuis le même service.

Wallets de dépôt

Adresse dédiée par opération ou par client, associée à votre compte marchand / PSP et à votre URL de callback.

API

Multi-réseau

Ethereum, Polygon, Tron et Solana pour la création de wallets ; indexation explorer détaillée sur EVM.

Chaîne

Splits & frais

Parts affilié / sous-affilié, frais plateforme figés à la création du wallet, vérification check-config base vs on-chain.

EVM

Webhooks & relances

POST JSON signés par X-IPN-Token, relances automatiques en cas d’échec HTTP (cron dédié).

IPN

Intégration développeur

Authentification par en-têtes X-API-Key et X-API-Secret, corps JSON, réponses standardisées. Exemple simplifié :

POST /api/v1/wallets/create
{
  "address": "0xVotreWalletMarchand…",
  "callback": "https://votre-site.com/webhooks/nxtgatew",
  "network": "polygon"
}
Webhook wallet.balance_changed (extrait)
{
  "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.

Démarrer

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.