AnonPay Dokumentation

Dieses Dokument beschreibt, wie unser AnonPay System genutzt werden kann und bietet einige Beispiele zur Demonstration. Es gibt zwei Arten wie AnonPay genutzt werden kann. Als direkter Link oder als ein Link um zuächst die Transaktion zu generieren und im Anschluss dem Endnutzer zu zeigen. Beide Arten nutzen die selben, wie unten beschriebenen Parameter

  • Die direkte Methode ist einfacher und wird nicht auf Ihrem Backend verarbeitet, jedoch könnten die Transaktions-Details wie Adresse, Menge und weiteres von Ihren Nutzern abgeändert werden, weshalb Sie immer bestätigen müssen, dass Sie die Zahlung auf der richtigen Adresse erhalten haben.
  • Mit der indirekten Methode generieren Sie zunächst die Transaktion mit all den gewünschten Details und erhalten die Transaktions-ID. Erst danach wird Sie Ihren Nutzern gezeigt. Dies verhindert, dass Nutzer etwas verändern können und gibt Ihnen die Möglichkeit den Status einer Transaktion zu überprüfen, da Sie die ID bereits haben. Auf diese Art generierte Transaktionen werden 72 Stunden nach Erstellung aus unserer Datenbank gelöscht.

Wenn Sie unbedingt mehr Kontrolle über Ihre Transaktionen brauchen und mit Programmieren (oder manueller Arbeit) komfortabel sind, sollten sie die indirekte Methode nutzen. Ansonsten ist die direkte Methode simpler und einfacher in Ihr Projekt einzupflegen.

Um Verzögerungen und KYC-Risiko zu minimieren sind AnonPay-Transaktionen zurzeit auf einen Wert von 5BTC pro Transaktion beschränkt.

Wenn die vom Nutzer gewählte Coin Ihrer gewählten Coin entspricht, wird kein Tausch durchgeführt und Ihr nutzer wird lediglich über Menge und Zieladresse informiert. Hierfür erhebt Trocador keine Gebühren und falls Sie sich entschieden haben Emails bei Abschluss einer Transaktion zu erhalten, erhalten Sie diese stattdessen bei Erstellung der Transatkion da wir keine Möglichkeit haben um zu erkennen ob/wann der Nutzer die Zahlung tätigt.

Obwohl wir noch keine Fiat-Zahlungen akzeptieren, können Sie den Wert Ihrer Transaktion in Fiat (USD, EUR usw.) definieren und wir verwenden automatisch den aktuellen Kurs, um den Betrag in das Äquivalent Ihrer gewählten Münze umzuwandeln. Wir verwenden CoinPaprika, um Kurse für Fiat-Währungen zu erhalten.

Für eine noch einfachere Art AnonPay zu nutzen, verwenden Sie unseren Zahlungs Generator.

  • Da dies die GET Methode nutzt, sollten Parameter nach dem '/anonpay/' Teil der URL mit '?' für den Ersten und '&' für den Rest genutzt werden. Die Reihenfolge der Parameter ist nicht wichtig.

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

    • Erforderliche Parameter:
      -ticker_to: Der Ticker der Cryptowährung, die Sie erhalten möchten, zB. BTC, XMR, etc.;
      -network_to: Das Netzwerk der Cryptowährung, die Sie erhalten möchten, zB. Mainnet, ERC20, BEP20, etc.;
      -address: Die Adresse, an welcher Sie erhalten wollen. Z.B. 89Jb5....D1LdB12 für unsere Monero Adresse;

    • Optionale Parameter:
      -amount: Für Zahlungen ist es die Menge an Coins, welche Sie erhalten wollen. Diese wird fest gesetzt. Für Spenden ist es die voreingestellte Menge der Coin, die der Nutzer spenden wird;
      -memo: Nutzt das Netzwerk der Coin die Sie erhalten wollen Memo/ExtraID, muss dies mit diesem Parameter gesetzt werden. Alternativ nutzen Sie '0' für Fortfahren ohne Memo;
      -donation: True aktiviert den Spenden-Modus, ansonsten wird standardmäßig der Zahlungs-Modus verwendet;
      -direct: False lässt die URL als eine API wirken und gibt eine JSON Antwort mit der ID der erstellten Transaktion. Mehr Details unten;
      -ticker_from: Falls Sie möchten, können Sie die voreingestellte Coin, welche der Nutzer senden wird, mit ticker_to (der Ticker der Coin) setzen;
      -network_from: Falls Sie möchten, können Sie die voreingestellte Coin, welche der Nutzer senden wird, mit network_to (das Netzwerk der Coin) setzen;
      -name: Der Name, welcher auf dem Widget gezeigt werden soll. Speziele Zeichen müssen URL enkodiert sein ( 'A B' is 'A%20B');
      -description: Eine Beschreibung für den Checkout-Screen der Zahlung/Spende. Speziele Zeichen müssen URL enkodiert sein 'A B' is 'A%20B');
      -referral: Falls Sie einen Referral Code aus unserem Affiliate Program haben, können Sie diesen hier nutzen;
      -buttonbgcolor: Die Farbe des Knopf, sollte in HEX Format ohne das '#' sein. Z.B. ff0000 für Rot;
      -textcolor: Die Farbe des Text des Knopf, sollte in HEX Format ohne das '#' sein. Z.B. ffffff für Weiß;
      -bgcolor: True gibt der Seite einen Grauen Hintergrun, ansonsten ist dieser Transparent/Weiß. Falls Sie AnonPay nicht in einem iframe verwenden, ist dies empfohlen. Sie können auch eine Farbe im Hex-Format ohne das '#' verwenden. Beispiel: 000000ff für Schwarz ohne Transparenz;
      -email: Eine Email-Adresse, an welche Sie Bestätigungen zu abgeschlossenen Transaktionen erhalten;
      -fiat_equiv: Falls Sie Ihre Transaktion in Fiat-Geld gemessen wollen, geben Sie eine Korrekte Währungs-Kürzung an (z.B. USD oder EUR). Bedenkten Sie, dass Ihre Kunden mit Crypto zahlen und Sie Ihre gewählte Coin erhalten, wir akzeptieren akutell noch keine Fiat-Zahlungen;
      -remove_direct_pay: Wenn Sie nicht möchten, dass der Nutzer Sie mit der zu erhaltenden Coin direkt durch AnonPay bezahlt, können Sie diesen Parameter auf True setzen. Dies ist nützlich wenn Sie eine weitere bevorzugte Methode zum erhalten Ihrer gewählten Coin haben und AnonPay nur für andere verwenden;
      -min_logpolicy: wenn Sie nur Börsen mit einem minimalen Log-Policy-Rating von A, B, C oder D erhalten wollen, bitte geben Sie diesen Parameter an (Optional);
      -editable: True erlaubt dem Nutzer die zu bezahlende Menge abzuändern;
      -webhook: wenn Sie auf deisem Parameter eine URL angeben, erhalten Sie bei jedem neuen Status der Transaktion auf dieser URL eine POST request mit Transaktions-Daten; dies reduziert die Menge an Serveranfragen zum überprüfen des Transaktions-Status (Optional);
      -simple_mode: Bei True wird die Checkout Seite für einfachere Benutzung durch Leute ohne Erfahrung mit Crypto optimiert;

  • Sie wollen eine Zahlung über 1.4LTC für ein jährliches Abbo iherer Webseite 'Super News' und eine Email bei Abschluss der Zahlung erhalten.

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

    • Entstehende URL:
      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
  • Sie haben eine Website namens 'Freedom Matters' und möchten Spenden in Monero erhalten. Außerdem soll das Widget eine hellblau/lila Schaltfläche und einen voreingestellten Betrag von 0,01BTC haben.

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

    • Entstehende URL:
      https://trocador.app/anonpay/?ticker_to=xmr&network_to=Mainnet&amount=0.01&name=Freedom%20Matters&donation=True&buttonbgcolor=3315ff&address=83r6YnuwnsVXNvHmurMFYf3Urufw54rKic1Ka5ysgSv5Wvp1UrCi5UnB2vfQnxmmTp1W2JYqk452QAgqV83SpqK8D7xy7gd
  • Falls Sie sich entscheiden unsere Indirekte Methode zu nutzen, bauen Sie eine URL genau wie bei der direkten Methode, fügen jedoch den 'direct=False' Parameter hinzu. Wenn Sie diese URL aufrufen, erhalten Sie eine JSON-Antwort mit der eindeutigen 'ID' der generierten Transaktion und deren URL.

    Um den Status der Transaktion zu überprüfen, können Sie den folgenden URL-Endpunkt verwenden, und Sie erhalten ein JSON mit dessen Status: 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>
  • Dies sind alle möglichen Swap-Status, die Sie bei der Verwendung von AnonPay finden können.


    • - anonpaynew: Der Handel wurde erstellt, aber es wurde noch keine Münze für die Zahlung ausgewählt;
      - waiting: Sie haben den Tausch erstellt aber es wurde keine Einzahlung erkannt;
      - confirming: Einzahlung wurde erkannt aber noch nicht bestätigt;
      - sending: Einzahlung bestätigt und der Provider schickt die Coins;
      - finished: es existiert bereits ein Zahlungs-Hash für diesen Nutzer;
      - paid partially: Es gibt bereits einen Zahlungshash für den Benutzer, aber der Betrag ist niedriger als gefordert;
      - failed: etwas könnte mit dem Tausch schief gelaufen sein, bitte kontaktieren Sie den Support;
      - expired: Zahlungszeitraum abgelaufen;
      - halted: es ist ein Problem aufgetreten, bitte kontaktieren Sie den Support;
      - refunded: Börse meldet Rückzahlung an den Nutzer;