Aperçu de l'API

PayerScan est une passerelle de paiement en cryptomonnaie automatisée qui vérifie les transactions sur plusieurs réseaux blockchain (EVM, Tron, Solana) et s'intègre directement avec 8 grandes plateformes d'échange mondiales — permettant aux marchands d'accepter les paiements crypto avec vérification en temps réel, correspondance automatique et notifications de règlement instantanées.

Fonctionnalités

• Création de facture : Ouvrir une transaction via l'API REST, retournant un lien complet vers l'interface de paiement (Checkout UI).
• Vérification multi-chaîne : Analyse automatique des transactions sur les réseaux blockchain populaires — BNB Smart Chain (BEP20), Ethereum (ERC20), Base, Polygon, Arbitrum, Optimism, Tron (TRC20) — et transferts internes via Binance Pay / OKX UID,....
• Intégration des exchanges : Connexion API directe avec 8 grandes plateformes d'échange de cryptomonnaies — Binance, OKX, Bybit, Bitget, Gate, MEXC, Upbit, Bitkub — pour des flux de prix en temps réel et la vérification des paiements.
• Support multi-devises : Acceptez les paiements en plusieurs tokens — USDT, USDC, BNB, ETH et plus — sur tous les réseaux supportés.
• Expiration automatique : Les factures expirent automatiquement après une période configurable, assurant que les demandes de paiement obsolètes sont correctement traitées.
• Correspondance exacte du montant : Élimine les erreurs d'arrondi JS avec une correspondance de précision BigInt.
• Callbacks intelligents : Notifie proactivement les marchands via Webhook (callback_url) lorsque le paiement est terminé ou expiré, avec un mécanisme de nouvelle tentative automatique (5 tentatives).
• Idempotence : L'envoi du même request_id retourne la facture existante au lieu d'en créer un doublon, assurant une logique de réessai sécurisée.
• Limitation de débit : Limitation de requêtes multicouche protégeant l'API contre les abus et assurant une utilisation équitable entre tous les marchands.
• Déduplication : Empêche un seul hash de transaction (txHash) d'être utilisé pour régler plusieurs factures.
• Notifications en temps réel : Alertes de paiement instantanées via Telegram, Lark ou Email pour tenir les marchands informés.
• Checkout personnalisable : Plusieurs thèmes de checkout disponibles, permettant aux marchands d'adapter la page de paiement à leur identité de marque.

📖 Pour plus de détails sur les réseaux et exchanges supportés, consultez le Guide Réseaux & Exchanges.

Composants principaux du système

Pour commencer, naviguez vers les sections suivantes :

1. Démarrage rapide : Exécutez un paiement test en seulement 10 minutes.
2. Authentification : Comment gérer et utiliser les clés API.
3. Créer une facture : Détails de la structure de données POST.
4. Obtenir une facture : Interroger le statut de la facture et les détails du paiement.
5. Événements Webhook : Écouter le statut de complétion.
6. Codes d'erreur : Liste complète des codes d'erreur API et leur signification.
7. Limites de débit : Politiques de limitation et de throttling des requêtes.
8. Exemples de code : Exemples d'intégration prêts à l'emploi.