Payment generator

VeilPay prend en charge deux méthodes de paiement :

La méthode directe est le moyen le plus simple de commencer à accepter des paiements. Vous générez un lien de paiement et l'envoyez à l'utilisateur. L'utilisateur ouvre le lien et effectue la transaction. Cette méthode ne nécessite pas d'intégration back-end. Cependant, comme les paramètres de la transaction (montant, adresse, etc.) peuvent potentiellement être modifiés par l'utilisateur, vous devez toujours vérifier que le paiement a été reçu à la bonne adresse avant de livrer vos biens ou services.

La méthode indirecte vous donne plus de contrôle sur la transaction. Dans ce flux, vous créez d'abord la transaction et recevez un identifiant de transaction. Vous présentez ensuite les détails de paiement à l'utilisateur. Comme la transaction est créée à l'avance, l'utilisateur ne peut pas modifier les paramètres de paiement. Cela vous permet également de suivre le statut de la transaction à l'aide de l'identifiant de transaction. Les transactions créées avec cette méthode doivent être démarrées dans les 72 heures, sinon elles sont automatiquement supprimées de la base de données.

Utilisez la méthode de transaction pré-générée si vous souhaitez :

un meilleur contrôle sur le flux de paiement

la possibilité de suivre le statut de la transaction

une meilleure protection contre les modifications de paramètres

Utilisez la méthode du lien direct si vous souhaitez :

l'intégration la plus rapide

aucun développement back-end

un flux de paiement simple

Les transactions VeilPay sont actuellement limitées à l'équivalent de 5 BTC par transaction.

Cette limite permet de minimiser les délais de traitement et de réduire les risques potentiels liés au KYC.

Si l'utilisateur envoie la même cryptomonnaie que celle que vous avez choisi de recevoir, aucun échange n'est nécessaire.

Veil ne facture aucun frais pour ces transactions.

Si les notifications par e-mail sont activées lors de la création d'une transaction, vous recevrez une notification une fois le paiement effectué.

VeilPay ne traite pas directement les paiements en fiat.

Cependant, vous pouvez définir le prix d'une transaction en devise fiat (USD, EUR, etc.).

VeilPay convertira automatiquement le montant en son équivalent en cryptomonnaie au taux de change actuel.

La méthode pré-générée (indirecte) est conçue pour l'intégration serveur à serveur. Votre back-end crée un paiement via notre API REST, récupère un anonpay_id, et vous affichez ou intégrez le widget VeilPay avec cet identifiant. Tous les paramètres de paiement sont stockés de notre côté, de sorte que le client ne peut pas modifier le montant, l'adresse ou tout autre champ.

Tous les endpoints se trouvent sous /api/anonpay sur votre domaine VeilPay. Ils sont publics — aucune clé API ni signature n'est requise pour créer un paiement.

Depuis votre serveur, envoyez une requête POST à /api/anonpay/prepare avec la monnaie et le réseau que vous souhaitez recevoir, votre adresse de portefeuille et le montant. Aucune commande n'est créée à ce stade — vous ne faites que réserver une intention de paiement.

Redirigez le client vers la page de paiement pour cet identifiant, ou intégrez-le sur votre propre page sous forme d'iframe. Le widget s'ouvre avec le montant et l'adresse verrouillés — le client choisit uniquement la monnaie avec laquelle il souhaite payer.

Vérifiez le statut actuel à tout moment avec une requête GET. Le statut évolue de prepared → waiting_deposit → deposit_received → exchanging → sending → completed.

Au lieu d'interroger périodiquement, transmettez une URL de webhook lors de la création du paiement pour recevoir un POST à chaque changement de statut :