Aller au contenu principal

Introduction à PayerScan

PayerScan permet aux marchands d'intégrer les paiements en cryptomonnaie (USDT, BNB, ETH, etc.) dans leurs sites web ou applications. Les clients paient avec des portefeuilles crypto ou des comptes d'échange, et le système vérifie automatiquement les transactions et notifie le marchand via API et Webhooks.

Fonctionnalités principales​

  • Créer des factures de paiement via API avec montant (USD), expiration, URL de callback.
  • Page de paiement affichant le code QR, l'adresse du portefeuille et le montant exact de crypto à transférer.
  • Multi-réseau — support de plusieurs méthodes de paiement :
    • Chaînes EVM : BSC, Ethereum, Polygon, Base, Arbitrum, ...
    • Tron : Tokens TRC20
    • Solana : Tokens SPL
    • Plateformes d'échange : Binance Pay, OKX, Bybit, MEXC, Gate.io, Bitget, ... (sans frais de gas, confirmation instantanée)
  • Confirmation automatique lorsqu'une transaction correspondante est détectée (bonne adresse, bon montant, dans la fenêtre de temps).
  • Webhooks pour notifier le serveur du marchand lors d'un paiement réussi ou d'une expiration de facture.
  • API de consultation de statut des factures par trans_id.

Flux de travail​

  1. Créer la facture — Le marchand appelle POST /payment/crypto avec merchant_id, amount, callback_url, et reçoit trans_id + url_payment.
  2. Rediriger le client — Le marchand redirige le client vers url_payment (la page de paiement).
  3. Le client paie — Le client sélectionne le token/réseau, puis transfère le montant exact à l'adresse du portefeuille affichée (ou paie via une plateforme d'échange).
  4. Confirmation automatique — Le système détecte et vérifie la transaction → met à jour la facture en completed → envoie un POST webhook au callback_url du marchand.
  5. Facture expirée — Si le client ne paie pas dans la fenêtre de temps, le statut de la facture devient expired et un webhook est également envoyé au callback_url.
  6. Vérifier le statut — Le marchand peut appeler GET /invoice/:trans_id pour vérifier le statut actuel à tout moment.

Prérequis d'intégration​

  • Clé API : Chaque boutique a une clé API, envoyée via l'en-tête x-api-key dans chaque requête.
  • Méthode de paiement : Au moins une adresse de portefeuille ou plateforme d'échange doit être configurée dans votre boutique avant de créer des factures.
  • URL de callback : Une URL HTTPS publique où le serveur du marchand reçoit les événements POST (webhook) pour les factures completed/expired.
  • HTTPS : L'API PayerScan utilise exclusivement HTTPS. Les URLs de callback devraient également utiliser HTTPS pour assurer une transmission sécurisée des données.

Prochaines étapes​