Documentation de l'AnonPay

Ce document explique en détail comment utiliser notre système AnonPay et fournit quelques exemples pour mieux illustrer son usage. Il existe deux façons d'utiliser AnonPay, en tant que lien direct ou en tant que lien pour d'abord générer la transaction, puis la montrer à l'utilisateur final. Les deux méthodes utilisent les mêmes paramètres décrits ci-dessous.

  • La méthode directe est plus simple et n'implique aucun traitement backend sur votre site Web, mais les détails de la transaction tels que l'adresse, le montant et autres peuvent être modifiés par votre utilisateur. Vous devez donc toujours confirmer que vous avez effectivement reçu le paiement à la bonne adresse.
  • Avec la méthode indirecte, vous créez d'abord la transaction avec tous les détails souhaités et recevez son ID, puis vous la montrez ensuite à votre utilisateur. Cela les empêche de changer quoi que ce soit et vous donne un moyen de vérifier son statut de transaction car vous avez déjà l'ID de transaction. Les transactions créées par cette méthode ont 72 heures pour démarrer avant d'être supprimées de notre base de données.

Si vous avez vraiment besoin de plus de contrôle sur vos transactions et que vous vous sentez à l'aise de programmer (ou de le faire manuellement), vous devriez utiliser la méthode indirecte. Sinon la méthode directe est plus simple et s'intègre plus facilement dans votre projet.

Les transactions utilisant AnonPay ont actuellement une limite de l'équivalent de 5 BTC par transaction, afin de minimiser les retards et le risque KYC.

Lorsque le jeton choisi par l'utilisateur est le même que le jeton selectionné, il n'y a pas d'échange à effectuer, votre utilisateur est simplement informé du montant et de l'adresse à laquelle il doit transférer. Trocador ne facture aucun frais pour cela et si vous avez choisi de recevoir un e-mail lorsque la transaction est terminée, vous recevrez à la place un e-mail lorsque la transaction est créée pour vous en informer, car nous n'avons aucun moyen de savoir si/quand l'utilisateur vous a transféré les jetons.

Bien que nous n'acceptons pas encore les paiements en fiat, vous pouvez définir la valeur de votre transaction en fiat (USD, EUR, etc.) et nous utiliserons automatiquement le taux actuel pour convertir le montant en l'équivalent dans le jeton que vous avez choisi. Nous utilisons CoinPaprika pour obtenir des taux pour le fiat.

Pour une manière encore plus simple d'utiliser AnonPay, utilisez notre Générateur de paiement.

  • Comme cela utilise la méthode GET, les paramètres doivent être ajoutés après la partie '/anonpay/' de l'url, en utilisant '?' pour le premier et '&' pour le reste. L'ordre des paramètres n'a pas d'importance.

    Exemples :
    https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&address=XYZ

    • Paramètres Obligatoires :
      -ticker_to: Le ticker du jeton que vous voulez recevoir, par exemple btc, xmr, eth, etc.;
      -network_to: Le réseau du jeton que vous voulez recevoir, c'est-à-dire Mainnet, ERC20, BEP20, etc.;
      -address: L'adresse à laquelle vous souhaitez recevoir. Par exemple. 89Jb5....D1LdB12 pour notre adresse Monero;

    • Paramètres Facultatifs :
      -amount: Pour les paiements, c'est le montant du jeton que vous souhaitez recevoir et il sera verrouillé. Pour les dons, il s'agit du montant prédéfini du jeton que l'utilisateur fera don;
      -memo: Si le réseau du jeton que vous souhaitez recevoir utilise Memo/ExtraID, vous devez le fournir en utilisant ce paramètre ou utiliser '0' pour aucun Memo;
      -donation: 'Vrai' activera le mode de don, sinon il passera par défaut en mode de paiement;
      -direct: 'Faux' fera fonctionner l'URL comme une API et renverra une réponse JSON avec l'ID de la transaction créée. Plus de détails ci-dessous;
      -ticker_from: Si vous le souhaitez, vous pouvez définir le jeton présélectionné que l'utilisateur transférera. ticker_to est le ticker du jeton;
      -network_from: Si vous le souhaitez, vous pouvez définir le jeton présélectionné que l'utilisateur transférera. network_to est le réseau du jeton;
      -name: Le nom que vous souhaitez voir apparaître sur le widget. Les caractères spéciaux doivent être encodés en URL ( 'A B' is 'A%20B');
      -description: Une description à afficher dans l'écran de paiement pour le paiement/don. Les caractères spéciaux doivent être encodés en URL ( 'A B' is 'A%20B');
      -referral: Si vous avez un code de parrainage de notre programme d'affiliation, vous pouvez l'utiliser ici;
      -buttonbgcolor: La couleur du bouton doit être au format hexadécimal sans le '#'. Par exemple. ff0000 pour le rouge;
      -textcolor: La couleur du texte du bouton doit être au format hexadécimal sans le '#'. Par exemple. ffffff pour le blanc;
      -bgcolor: 'Vrai' donnera à la page un fond gris, sinon elle sera transparente/blanche. Si vous n'utilisez pas AnonPay dans une iframe, ceci est recommandé. Vous pouvez également utiliser une couleur au format hexadécimal sans le '#'. Par exemple. Exemple : 000000ff pour le noir sans transparence;
      -email: Un e-mail dans lequel vous recevrez une confirmation lorsque la transaction sera terminée;
      -fiat_equiv: Si vous souhaitez que votre transaction soit libellée en monnaie fiat, indiquez une abréviation de devise valide (par exemple, USD ou EUR). Notez que vous recevrez la monnaie de votre choix et que vos clients paieront en crypto, nous n'acceptons pas encore les paiements fiat;
      -remove_direct_pay: Si vous ne souhaitez pas que l'utilisateur vous paie directement via AnonPay avec le jeton que vous avez choisi de recevoir, vous pouvez définir ce paramètre sur 'Vrai'. Ceci est utile si vous avez une autre méthode préférée pour recevoir dans le jeton de votre choix et que vous souhaitez utiliser AnonPay uniquement pour d'autres jetons;
      -min_logpolicy: Si vous souhaitez utiliser uniquement sur les échanges avec une note de politique de journalisation minimale de A, B ou C, veuillez fournir ce paramètre (facultatif);
      -editable: Autorise l'utilisateur à modifier le montant à payer lorsqu'il est défini sur 'Vrai';
      -webhook: Si vous fournissez une URL sur ce paramètre, chaque fois que le statut de la transaction change, vous recevrez sur cette URL une requête POST vous envoyant les données de la transaction ; cela évite d'appeler autant de fois notre serveur pour vérifier le statut de la transaction (facultatif);
      -simple_mode: Lorsqu'il est défini sur 'Vrai', l'écran de paiement sera plus rationalisé pour faciliter son utilisation par les personnes moins familières avec la crypto;

  • Vous souhaitez recevoir 1.4LTC en paiement d'un abonnement annuel à votre site 'Super News' et recevoir un e-mail lorsque le paiement est confirmé.

    • Paramètres :
      ticker_to: ltc
      network_to: Mainnet
      amount: 1.4
      name: Super%20News
      description: Annual%20Subscription
      email: mail@supernews.com
      address: ltc1q....fgsw

    • URL Résultante :
      https://trocador.app/anonpay/?ticker_to=ltc&network_to=Mainnet&amount=1.4&name=Super%20News&description=Annual%20Subscription&email=mail@supernews.com&address=ltc1qzvcgmntglcuv4smv3lzj6k8szcvsrmvk0phrr9wfq8w493r096ssm2fgsw
  • Vous avez un site Web appelé 'Freedom Matters' et vous souhaitez recevoir des dons en Monero. Vous voulez également que le widget ait un bouton bleu clair/violet et un montant prédéfini de 0.01BTC.

    • Paramètres :
      ticker_to: xmr
      network_to: Mainnet
      amount: 0.01
      donation: True
      name: Freedom%20Matters
      address: 89Jb....dB12
      buttonbgcolor: 3315ff

    • URL Résultante :
      https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&amount=0.01&name=Freedom%20Matters&donation=True&buttonbgcolor=3315ff&address=83r6YnuwnsVXNvHmurMFYf3Urufw54rKic1Ka5ysgSv5Wvp1UrCi5UnB2vfQnxmmTp1W2JYqk452QAgqV83SpqK8D7xy7gd
  • Si vous décidez d'utiliser notre méthode indirecte, créez une URL comme si vous utilisiez la méthode directe, mais ajoutez le paramètre 'direct=False'. Lorsque vous appelez cette URL, vous recevrez une réponse JSON avec l'ID unique de la transaction générée et son URL.

    Pour vérifier le statut de la transaction, vous pouvez utiliser le point de terminaison URL suivant et vous recevrez un JSON avec son statut : https://trocador.app/anonpay/status/<ID>

  • <iframe src="https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&amount=0.1&address=83r6YnuwnsVXNvHmurMFYf3Urufw54rKic1Ka5ysgSv5Wvp1UrCi5UnB2vfQnxmmTp1W2JYqk452QAgqV83SpqK8D7xy7gd" width="300" height="290" scrolling="no" style="border:0;"></iframe>
  • Voici tous les statuts d'échange possibles que vous trouverez en utilisant AnonPay.


    • - anonpaynew: l'échange est créé, mais aucune pièce n'a encore été sélectionnée pour le paiement;
      - waiting: vous avez créé l'échange mais aucun dépôt n'a été détecté;
      - confirming: le dépôt a été détecté et doit encore être confirmé;
      - sending: dépôt confirmé et le fournisseur envoie les jetons;
      - finished: il y a déjà un hash de paiement à l'utilisateur;
      - paid partially: il existe déjà un hachage de paiement pour l'utilisateur, mais le montant est inférieur à celui demandé;
      - failed: quelque chose s'est peut-être passé avec l'échange, veuillez contacter le support;
      - expired: le temps de paiement a expiré;
      - halted: un problème est survenu avec l'échange, veuillez contacter le support;
      - refunded: l'échange prétend avoir remboursé l'utilisateur;