Les questions décisives pour adopter une solution de paiement

Comment puis-je commencer à accepter les crypto-monnaies avec XPayr ?

Créez un compte marchand, ajoutez un portefeuille de paiement, choisissez le réseau et le jeton, puis publiez votre lien de paiement, widget ou bouton.

Comment fonctionne le simulateur Sandbox instantané pour le paiement testnet et la recette des webhooks ?

When you create a payment session using a test API key (sk_test_...) on any testnet network, both the hosted checkout page (/test/{session_id}) and the REST API (POST /api/v1/payments/{id}/simulate) allow you to trigger instant simulated outcomes—Completed, Underpaid, Expired, or Failed—without needing testnet faucet tokens. Each simulation generates realistic ledger records and dispatches a signed webhook event to your callback URL.

Puis-je tester avant de passer en direct ?

Oui. Utilisez les flux testnet pour valider le paiement, la connexion au portefeuille et le comportement de facturation avant la production.

Ai-je besoin de compétences en codage pour commencer ?

Non. Vous pouvez lancer des outils sans code à partir du tableau de bord du commerçant et utiliser l'API uniquement lorsque vous avez besoin d'intégrations avancées.

Combien de temps prend habituellement l’installation ?

La plupart des commerçants publient leur premier flux de paiement crypto en quelques minutes.

Quelle est la différence entre les liens de paiement et les liens de don ?

Les liens de paiement sont des flux de paiement fixes. Les liens de don sont des flux axés sur le soutien pour les contributions de la communauté.

Les acheteurs et les marchands peuvent-ils télécharger des reçus PDF officiels pour les paiements crypto finalisés ?

Oui. Chaque session de paiement finalisée inclut un générateur instantané de reçu PDF-1.4 (/public/receipt.php?session_id={id}&download=1) ainsi qu'une vue HTML imprimable. Le reçu affiche l'identifiant de facture, l'identifiant de session, le nom du marchand, le montant brut, les frais de passerelle XPayr, le montant net réglé, le jeton, le réseau, les adresses des portefeuilles émetteur/destinataire, l'horodatage UTC et le hash de transaction on-chain.

Un lien peut-il recevoir plusieurs paiements ?

Oui. Les liens réutilisables peuvent collecter plusieurs paiements au fil du temps en fonction du flux de votre campagne.

Quand dois-je utiliser un widget, un bouton ou un lien direct ?

Utilisez un widget pour le paiement intégré, un bouton pour un appel à l'action de marque et un lien direct pour un partage rapide dans les chats ou les réseaux sociaux.

Le client peut-il saisir un montant personnalisé ?

Oui. Vous pouvez autoriser des montants personnalisés ou conserver des montants fixes en fonction du flux que vous configurez.

Les clients peuvent-ils payer directement depuis des bourses crypto ou sans connecter de portefeuille Web3 ?

Oui. XPayr propose un mode de paiement double : Paiement Web3 en 1 Clic pour les transactions directes via portefeuille de navigateur, et Transfert Direct / QR pour les clients payant depuis des bourses centralisées (Binance, Bybit, OKX, etc.) ou des portefeuilles mobiles. Les clients peuvent scanner le code QR ou copier l'adresse du destinataire, transférer les fonds et saisir leur hachage de transaction (TxID) ou laisser l'explorateur on-chain détecter automatiquement le paiement. Une tolérance pour les frais de retrait de 1 % (max. 0,50 $) est intégrée.

Comment fonctionnent les liens de paiement et les pages de dons multi-chaînes ?

Lors de la création d'un lien de paiement ou d'une page de don, les marchands peuvent choisir "Tous les Réseaux (Le client choisit au paiement)". Au lieu d'imposer une seule blockchain ou un seul jeton, la page de paiement propose un sélecteur de réseau clair. Le client peut payer via EVM (Ethereum, BSC, Polygon, Arbitrum, Avalanche), TRON USDT ou Solana, et le système charge automatiquement l'acheminement exact, les paramètres de contrat et le portefeuille destinataire.

Quels portefeuilles XPayr prend-il en charge ?

XPayr prend en charge les portefeuilles de navigateur compatibles EIP et les flux de connexion de portefeuille modernes.

Pourquoi est-ce que je vois que Wallet n'est pas enregistré sur ce réseau ?

Le portefeuille sélectionné n'est pas enregistré pour cette chaîne dans vos paramètres marchand. Ajoutez-le et enregistrez-le pour le réseau sélectionné.

Puis-je changer de portefeuille après la connexion ?

Oui. Déconnectez le portefeuille actuel et reconnectez-vous à l'adresse que vous souhaitez utiliser avant de créer ou de confirmer le paiement.

Comment ajouter correctement des portefeuilles de paiement ?

Ouvrez les portefeuilles de paiement dans le panneau du commerçant, sélectionnez le réseau, collez l'adresse du portefeuille et enregistrez après validation.

Quels frais XPayr facture-t-il ?

XPayr applique des frais de passerelle transparents de 0,5 pour cent. Les frais de gaz de réseau sont des coûts de blockchain et varient selon l'état de la chaîne.

Comment les abonnements SaaS XPayr et les paliers de volume sur 30 jours réduisent-ils les frais de passerelle de 0.5% ?

XPayr démarre avec des frais de passerelle transparents de 0.50% (50 bps) sur l'offre gratuite Starter ($0/mois). Les marchands peuvent passer à Growth Pro ($49/mois pour des frais de base de 0.30% / 30 bps) ou Enterprise Scale ($199/mois pour des frais de base de 0.15% / 15 bps). De plus, XPayr calcule automatiquement votre volume mainnet USD finalisé sur 30 jours glissants et applique une remise de palier : Bronze ($0+ = 0 bps), Silver ($10,000+ = -5 bps), Gold ($50,000+ = -10 bps) et Diamond ($250,000+ = -15 bps), abaissant vos frais effectifs jusqu'à un plancher de 0.05% (5 bps).

Qui paie les frais de gaz ?

Les coûts du gaz sont payés en chaîne par l'expéditeur de la transaction en fonction des conditions du réseau et du flux de jetons sélectionné.

À quelle vitesse les fonds sont-ils réglés ?

Après confirmation en chaîne, les fonds sont transférés directement dans le flux de votre portefeuille configuré.

Y a-t-il des frais cachés ?

Pas de frais de passerelle cachés. Vous voyez clairement les frais de plateforme et les coûts de réseau dans le flux.

Comment XPayr améliore-t-il la sécurité des comptes ?

Utilisez 2FA, les contrôles de liste blanche et la validation de signature webhook pour sécuriser les opérations de compte et de paiement.

La marque blanche supprime-t-elle Powered by XPayr ?

Non. La marque de confiance principale reste visible pendant que les éléments de votre marque sont affichés dans l'en-tête de paiement.

Comment la liste blanche IP est-elle utile ?

Il restreint les actions sensibles aux adresses IP approuvées et réduit les actions administratives non autorisées.

Puis-je appliquer le mode liste blanche uniquement du portefeuille de paiement ?

Oui. Activez l’application de la liste blanche pour autoriser les paiements uniquement vers les paires de portefeuille et de devises approuvées.

Comment puis-je vérifier les événements de webhook ?

Validez l'en-tête de signature avec votre secret de webhook avant de traiter les données utiles.

XPayr prend-il en charge la signature des requêtes entrantes HMAC-SHA256, les URL IPN dynamiques par paiement et le filtrage des modes de paiement ?

Yes. Merchants can generate a dedicated HMAC secret in the API Keys dashboard and send X-Signature and X-Timestamp headers (with a 300-second anti-replay window) on API requests. When creating a payment session via POST /api/v1/payments, you can also pass ipn_url (or ipn_callback_url) to route webhooks dynamically per store/order, and allow_payment_methods (["web3", "direct", "gasless"]) to control which checkout tabs are shown to the buyer.

Quelle est la différence entre la clé API et la clé secrète ?

La clé API identifie le contexte d'intégration. La clé secrète autorise les requêtes API protégées côté serveur.

Quels statuts le webhook peut-il envoyer ?

Les statuts courants incluent en attente, confirmé, échoué et expiré avec les événements de mise à jour associés.

Comment puis-je éviter le traitement des événements en double ?

Utilisez l'idempotence dans votre backend et stockez les identifiants d'événements traités avant d'appliquer les mises à jour commerciales.

Les liens de paiement peuvent-ils être créés avec envoi automatique de facture par e-mail via l'API et le tableau de bord ?

Oui. Lors de la création d'une session via POST /payments ou le portail marchand, définissez send_invoice_email sur true et fournissez customer_email. XPayr envoie immédiatement une facture par e-mail HTML responsive et personnalisée avec les détails de paiement et un bouton de paiement en 1 clic. Les webhooks sont déclenchés dès la finalisation du paiement.

Pourquoi est-ce que la transaction est annulée par EVM ?

Cela signifie généralement une inadéquation du réseau, une inadéquation des jetons, un enregistrement de portefeuille manquant ou un rejet de validation de contrat.

Pourquoi les détails de la facture ne se chargent-ils pas ?

Vérifiez que la facture appartient à votre compte marchand et que les données de session existent dans l'environnement actuel.

Pourquoi la session expirée apparaît-elle ?

La session a atteint sa limite de temps ou était déjà finalisée par un flux terminé.

Pourquoi le bouton du portefeuille Connect ne fonctionne-t-il pas ?

Vérifiez que l'extension du portefeuille est installée, déverrouillée, sur la bonne chaîne et que les fenêtres contextuelles ne sont pas bloquées par les paramètres du navigateur.

Mon équipe peut-elle utiliser un seul compte marchand ?

Oui. Les équipes peuvent partager les flux de travail opérationnels tandis que les contrôles de paiement restent centralisés.

Comment récupérer l'accès au compte ?

Utilisez le flux de mot de passe oublié et les étapes de récupération, puis mettez à jour les paramètres de sécurité une fois l'accès restauré.

Où puis-je gérer les clés API ?

Ouvrez les clés API dans le panneau du marchand pour créer, alterner et révoquer les informations d'identification.

Les administrateurs peuvent-ils voir le site en mode maintenance ?

Oui. Les utilisateurs administrateurs peuvent contourner la page de maintenance tandis que les visiteurs publics voient toujours l'écran de maintenance.

Comment fonctionne le programme d'affiliation et de partenariat XPayr ?

XPayr propose une infrastructure partenaire hybride prenant en charge le suivi Web2 d'entreprise (via Impact.com S2S) et le règlement direct par contrat intelligent Web3.

Lorsque vous parrainez un commerçant ou un développeur, vous gagnez 30 % de partage de revenus récurrents sur les frais de passerelle ou un bonus CPA de 50 $ par commerçant activé.

Comment fonctionne le suivi et l'attribution des liens de parrainage Impact.com ?

Lorsqu'un visiteur clique sur votre lien d'affiliation, XPayr enregistre l'identifiant de clic pendant 30 jours.

Lors de l'inscription ou du paiement, XPayr envoie un postback Server-to-Server (S2S) à Impact.com, garantissant un suivi précis à 100 % insensible aux bloqueurs de publicité.

Quels sont les modèles de rémunération disponibles : 30 % RevShare vs 50 $ CPA ?

Vous pouvez choisir entre deux modèles :

1. 30 % de RevShare récurrent : Gagnez 30 % des frais de 0,5 % de XPayr à vie sur chaque transaction.
2. 50 $ de CPA d'activation : Recevez 50 $ dès que le commerçant traite ses premiers 100 $ de volume.

Comment réclamer des récompenses de parrainage directement sur mon portefeuille Web3 ?

Connectez votre portefeuille dans le tableau de bord (/merchant/affiliate).

Le smart contract alloue automatiquement votre commission de 30 %. Cliquez sur 'Claim' pour retirer vos USDT, USDC ou SOL instantanément.

Où puis-je trouver des badges officiels et des bannières d'affiliation ?

Visitez le studio Ressources de marque sur /brand-assets.

Générez des badges SVG dynamiques et copiez les codes d'intégration pour les formats de bannières (728x90, 300x250, 1200x630).

Les auto-parrainages ou transactions sur testnet sont-ils rémunérés ?

Non. Les auto-parrainages, les volumes artificiels et les transactions testnet sont strictement exclus par nos filtres antifraude.