This document details how to use our AnonPay system and provides a few examples to better illustrate its use. There's two ways AnonPay can be used, as a direct link or as a link to first generate the transaction and then show it to the final user. Both ways use the same parameters described below.
If you really need more control over your transactions and feel comfortable programming (or doing it manually), you should use the indirect method. Otherwise the direct method is simpler and more easily integrated in your project.
Transactions using AnonPay currently have a limit of the equivalent of 5BTC per transaction, to minimize delays and KYC risk.
When the coin the user chooses is the same as your chosen coin there's no trade to be made, so your user is simply informed of the amount and address to which he must transfer. Trocador charges no fees for this and if you chose to receive an email when the transaction is completed you'll instead receive an email when the transaction is created informing you this, as we have no way of knowing if/when the user transfers the coins to you.
While we don't yet accept fiat payments, you can define the value of your transaction in fiat (USD,EUR,etc.) and we'll automatically use the current rate to convert the amount into the equivalent in your chosen coin. We use CoinPaprika to get rates for fiat.
For an even simpler way to use AnonPay, use our Payment Generator.
As this uses the GET method, parameters should be added after the '/anonpay/' part of the url, using '?' for the first one used and '&' for the rest. The order of the parameters is not important.
You want to receive 1.4LTC in payment for an annual subscription to your website 'Super News' and receive an email when payment is confirmed.
ticker_to: | ltc |
network_to: | Mainnet |
amount: | 1.4 |
name: | Super%20News |
description: | Annual%20Subscription |
email: | mail@supernews.com |
address: | ltc1q....fgsw |
You have a website called 'Freedom Matters' and want to receive donations in Monero. Also you want the widget to have a light blue/purple button and a preset amount of 0.01BTC.
ticker_to: | xmr |
network_to: | Mainnet |
amount: | 0.01 |
donation: | True |
name: | Freedom%20Matters |
address: | 89Jb....dB12 |
buttonbgcolor: | 3315ff |
If you decide to use our Indirect Method, build an url just like if you were using the direct method, but add the 'direct=False' parameter. When you call that url you will receive a JSON Response with the generated transaction's unique 'ID' and its URL.
To check the transaction's status you can use the following url endpoint and you'll receive a JSON with its status: https://trocador.app/anonpay/status/<ID>
These are all possible swap statuses you will find when using AnonPay.